30891f35fa
We stopped adding "Contributed by" or similar lines in sources in 2012 in favour of git logs and keeping the Contributors section of the glibc manual up to date. Removing these lines makes the license header a bit more consistent across files and also removes the possibility of error in attribution when license blocks or files are copied across since the contributed-by lines don't actually reflect reality in those cases. Move all "Contributed by" and similar lines (Written by, Test by, etc.) into a new file CONTRIBUTED-BY to retain record of these contributions. These contributors are also mentioned in manual/contrib.texi, so we just maintain this additional record as a courtesy to the earlier developers. The following scripts were used to filter a list of files to edit in place and to clean up the CONTRIBUTED-BY file respectively. These were not added to the glibc sources because they're not expected to be of any use in future given that this is a one time task: https://gist.github.com/siddhesh/b5ecac94eabfd72ed2916d6d8157e7dc https://gist.github.com/siddhesh/15ea1f5e435ace9774f485030695ee02 Reviewed-by: Carlos O'Donell <carlos@redhat.com>
112 lines
3.7 KiB
C
112 lines
3.7 KiB
C
/* Extended tar format from POSIX.1.
|
|
Copyright (C) 1992-2021 Free Software Foundation, Inc.
|
|
This file is part of the GNU C Library.
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with the GNU C Library; if not, see
|
|
<https://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _TAR_H
|
|
#define _TAR_H 1
|
|
|
|
#include <features.h>
|
|
|
|
|
|
/* A tar archive consists of 512-byte blocks.
|
|
Each file in the archive has a header block followed by 0+ data blocks.
|
|
Two blocks of NUL bytes indicate the end of the archive. */
|
|
|
|
/* The fields of header blocks:
|
|
All strings are stored as ISO 646 (approximately ASCII) strings.
|
|
|
|
Fields are numeric unless otherwise noted below; numbers are ISO 646
|
|
representations of octal numbers, with leading zeros as needed.
|
|
|
|
linkname is only valid when typeflag==LNKTYPE. It doesn't use prefix;
|
|
files that are links to pathnames >100 chars long can not be stored
|
|
in a tar archive.
|
|
|
|
If typeflag=={LNKTYPE,SYMTYPE,DIRTYPE} then size must be 0.
|
|
|
|
devmajor and devminor are only valid for typeflag=={BLKTYPE,CHRTYPE}.
|
|
|
|
chksum contains the sum of all 512 bytes in the header block,
|
|
treating each byte as an 8-bit unsigned value and treating the
|
|
8 bytes of chksum as blank characters.
|
|
|
|
uname and gname are used in preference to uid and gid, if those
|
|
names exist locally.
|
|
|
|
Field Name Byte Offset Length in Bytes Field Type
|
|
name 0 100 NUL-terminated if NUL fits
|
|
mode 100 8
|
|
uid 108 8
|
|
gid 116 8
|
|
size 124 12
|
|
mtime 136 12
|
|
chksum 148 8
|
|
typeflag 156 1 see below
|
|
linkname 157 100 NUL-terminated if NUL fits
|
|
magic 257 6 must be TMAGIC (NUL term.)
|
|
version 263 2 must be TVERSION
|
|
uname 265 32 NUL-terminated
|
|
gname 297 32 NUL-terminated
|
|
devmajor 329 8
|
|
devminor 337 8
|
|
prefix 345 155 NUL-terminated if NUL fits
|
|
|
|
If the first character of prefix is '\0', the file name is name;
|
|
otherwise, it is prefix/name. Files whose pathnames don't fit in that
|
|
length can not be stored in a tar archive. */
|
|
|
|
/* The bits in mode: */
|
|
#define TSUID 04000
|
|
#define TSGID 02000
|
|
#if defined __USE_XOPEN || !defined __USE_XOPEN2K
|
|
# define TSVTX 01000
|
|
#endif
|
|
#define TUREAD 00400
|
|
#define TUWRITE 00200
|
|
#define TUEXEC 00100
|
|
#define TGREAD 00040
|
|
#define TGWRITE 00020
|
|
#define TGEXEC 00010
|
|
#define TOREAD 00004
|
|
#define TOWRITE 00002
|
|
#define TOEXEC 00001
|
|
|
|
/* The values for typeflag:
|
|
Values 'A'-'Z' are reserved for custom implementations.
|
|
All other values are reserved for future POSIX.1 revisions. */
|
|
|
|
#define REGTYPE '0' /* Regular file (preferred code). */
|
|
#define AREGTYPE '\0' /* Regular file (alternate code). */
|
|
#define LNKTYPE '1' /* Hard link. */
|
|
#define SYMTYPE '2' /* Symbolic link (hard if not supported). */
|
|
#define CHRTYPE '3' /* Character special. */
|
|
#define BLKTYPE '4' /* Block special. */
|
|
#define DIRTYPE '5' /* Directory. */
|
|
#define FIFOTYPE '6' /* Named pipe. */
|
|
#define CONTTYPE '7' /* Contiguous file */
|
|
/* (regular file if not supported). */
|
|
|
|
/* Contents of magic field and its length. */
|
|
#define TMAGIC "ustar"
|
|
#define TMAGLEN 6
|
|
|
|
/* Contents of the version field and its length. */
|
|
#define TVERSION "00"
|
|
#define TVERSLEN 2
|
|
|
|
#endif /* tar.h */
|