/* Extended tar format from POSIX.1.

[0] Fix | Delete

Copyright (C) 1992-2018 Free Software Foundation, Inc.

[1] Fix | Delete

This file is part of the GNU C Library.

[2] Fix | Delete

Written by David J. MacKenzie.

[3] Fix | Delete

[4] Fix | Delete

The GNU C Library is free software; you can redistribute it and/or

[5] Fix | Delete

modify it under the terms of the GNU Lesser General Public

[6] Fix | Delete

License as published by the Free Software Foundation; either

[7] Fix | Delete

version 2.1 of the License, or (at your option) any later version.

[8] Fix | Delete

[9] Fix | Delete

The GNU C Library is distributed in the hope that it will be useful,

[10] Fix | Delete

but WITHOUT ANY WARRANTY; without even the implied warranty of

[11] Fix | Delete

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

[12] Fix | Delete

Lesser General Public License for more details.

[13] Fix | Delete

[14] Fix | Delete

You should have received a copy of the GNU Lesser General Public

[15] Fix | Delete

License along with the GNU C Library; if not, see

[16] Fix | Delete

<http://www.gnu.org/licenses/>. */

[17] Fix | Delete

[18] Fix | Delete

#ifndef _TAR_H

[19] Fix | Delete

#define _TAR_H 1

[20] Fix | Delete

[21] Fix | Delete

#include <features.h>

[22] Fix | Delete

[23] Fix | Delete

[24] Fix | Delete

/* A tar archive consists of 512-byte blocks.

[25] Fix | Delete

Each file in the archive has a header block followed by 0+ data blocks.

[26] Fix | Delete

Two blocks of NUL bytes indicate the end of the archive. */

[27] Fix | Delete

[28] Fix | Delete

/* The fields of header blocks:

[29] Fix | Delete

All strings are stored as ISO 646 (approximately ASCII) strings.

[30] Fix | Delete

[31] Fix | Delete

Fields are numeric unless otherwise noted below; numbers are ISO 646

[32] Fix | Delete

representations of octal numbers, with leading zeros as needed.

[33] Fix | Delete

[34] Fix | Delete

linkname is only valid when typeflag==LNKTYPE. It doesn't use prefix;

[35] Fix | Delete

files that are links to pathnames >100 chars long can not be stored

[36] Fix | Delete

in a tar archive.

[37] Fix | Delete

[38] Fix | Delete

If typeflag=={LNKTYPE,SYMTYPE,DIRTYPE} then size must be 0.

[39] Fix | Delete

[40] Fix | Delete

devmajor and devminor are only valid for typeflag=={BLKTYPE,CHRTYPE}.

[41] Fix | Delete

[42] Fix | Delete

chksum contains the sum of all 512 bytes in the header block,

[43] Fix | Delete

treating each byte as an 8-bit unsigned value and treating the

[44] Fix | Delete

8 bytes of chksum as blank characters.

[45] Fix | Delete

[46] Fix | Delete

uname and gname are used in preference to uid and gid, if those

[47] Fix | Delete

names exist locally.

[48] Fix | Delete

[49] Fix | Delete

Field Name Byte Offset Length in Bytes Field Type

[50] Fix | Delete

name 0 100 NUL-terminated if NUL fits

[51] Fix | Delete

mode 100 8

[52] Fix | Delete

uid 108 8

[53] Fix | Delete

gid 116 8

[54] Fix | Delete

size 124 12

[55] Fix | Delete

mtime 136 12

[56] Fix | Delete

chksum 148 8

[57] Fix | Delete

typeflag 156 1 see below

[58] Fix | Delete

linkname 157 100 NUL-terminated if NUL fits

[59] Fix | Delete

magic 257 6 must be TMAGIC (NUL term.)

[60] Fix | Delete

version 263 2 must be TVERSION

[61] Fix | Delete

uname 265 32 NUL-terminated

[62] Fix | Delete

gname 297 32 NUL-terminated

[63] Fix | Delete

devmajor 329 8

[64] Fix | Delete

devminor 337 8

[65] Fix | Delete

prefix 345 155 NUL-terminated if NUL fits

[66] Fix | Delete

[67] Fix | Delete

If the first character of prefix is '\0', the file name is name;

[68] Fix | Delete

otherwise, it is prefix/name. Files whose pathnames don't fit in that

[69] Fix | Delete

length can not be stored in a tar archive. */

[70] Fix | Delete

[71] Fix | Delete

/* The bits in mode: */

[72] Fix | Delete

#define TSUID 04000

[73] Fix | Delete

#define TSGID 02000

[74] Fix | Delete

#if defined __USE_XOPEN || !defined __USE_XOPEN2K

[75] Fix | Delete

# define TSVTX 01000

[76] Fix | Delete

#endif

[77] Fix | Delete

#define TUREAD 00400

[78] Fix | Delete

#define TUWRITE 00200

[79] Fix | Delete

#define TUEXEC 00100

[80] Fix | Delete

#define TGREAD 00040

[81] Fix | Delete

#define TGWRITE 00020

[82] Fix | Delete

#define TGEXEC 00010

[83] Fix | Delete

#define TOREAD 00004

[84] Fix | Delete

#define TOWRITE 00002

[85] Fix | Delete

#define TOEXEC 00001

[86] Fix | Delete

[87] Fix | Delete

/* The values for typeflag:

[88] Fix | Delete

Values 'A'-'Z' are reserved for custom implementations.

[89] Fix | Delete

All other values are reserved for future POSIX.1 revisions. */

[90] Fix | Delete

[91] Fix | Delete

#define REGTYPE '0' /* Regular file (preferred code). */

[92] Fix | Delete

#define AREGTYPE '\0' /* Regular file (alternate code). */

[93] Fix | Delete

#define LNKTYPE '1' /* Hard link. */

[94] Fix | Delete

#define SYMTYPE '2' /* Symbolic link (hard if not supported). */

[95] Fix | Delete

#define CHRTYPE '3' /* Character special. */

[96] Fix | Delete

#define BLKTYPE '4' /* Block special. */

[97] Fix | Delete

#define DIRTYPE '5' /* Directory. */

[98] Fix | Delete

#define FIFOTYPE '6' /* Named pipe. */

[99] Fix | Delete

#define CONTTYPE '7' /* Contiguous file */

[100] Fix | Delete

/* (regular file if not supported). */

[101] Fix | Delete

[102] Fix | Delete

/* Contents of magic field and its length. */

[103] Fix | Delete

#define TMAGIC "ustar"

[104] Fix | Delete

#define TMAGLEN 6

[105] Fix | Delete

[106] Fix | Delete

/* Contents of the version field and its length. */

[107] Fix | Delete

#define TVERSION "00"

[108] Fix | Delete

#define TVERSLEN 2

[109] Fix | Delete

[110] Fix | Delete

#endif /* tar.h */

[111] Fix | Delete

[112] Fix | Delete