Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

tar(4) OSS System Calls Reference Manual
of the error and does not attempt to store the link in the archive.
The mode field contains 9 bits specifying file permissions and 3 bits specifying the set user ID
(TSUID), set group ID (TSGID), and unused TSVTX modes. When the user restoring the files
from the archive does not have appropriate permission to set these bits, the bits for which the
user does not have permission are ignored.
The uid and gid fields are the user and group ID of the file’s owner and group, respectively.
The size field is the size of the file in bytes, as follows:
• If the typeflag field specifies a file type of LNKTYPE or SYMTYPE, the size field is 0
(zero).
• If the typeflag field specifies a file type of DIRTYPE, the size field is interpreted as
described for that record type.
• If the typeflag field specifies a file type of CHARTYPE, BLKTYPE,orFIFOTYPE,
the meaning of the size field is implementation-defined and no data blocks are stored in
the archive.
• If the typeflag specifies any other value, the number of blocks written following the
header is (value of size + 511)/512, ignoring any fraction in the result of the division.
The mtime field is the modification time of the file at the time it was archived.
The chksum field is the ASCII representation of the octal value of the simple sum of all bytes in
the header block. Each 8-bit byte in the header is treated as an unsigned value. These values are
added to an unsigned integer that has been initialized to 0 (zero), and that has a precision of no
less than 17 bits. When calculating the checksum, the chksum field is treated as if it were all
blanks.
The typeflag field specifies the type of file archived. If a particular implementation does not
recognize the type, or if the user does not have appropriate privilege to create that type, the file is
extracted as if it were a regular file, if possible. If conversion to a regular file occurs, the tar com-
mand produces an error message indicating that the conversion took place.
The magic field indicates that the archive was output in tar archive file format. If this field con-
tains the value TMAGIC, the uname and gname fields contain the ASCII representation of the
owner and group of the file respectively. When the archive is restored, the password and group
files are scanned for these names. If found, the user and group IDs from these files are used
instead of the values contained within the uid and gid fields.
RELATED INFORMATION
Commands: pax(1), pinstall(1).
11−50 Hewlett-Packard Company 527186-023