diff options
author | ru <ru@FreeBSD.org> | 2004-07-04 21:15:37 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2004-07-04 21:15:37 +0000 |
commit | 3832f1d915b281e8dfaf6e6ebeb2dc3e1c24aa5a (patch) | |
tree | eeb188496b296e3a5e407412a6c132e4469fabf8 /lib/libarchive/tar.5 | |
parent | 6651f20e0daee8d4c1fee0a632e7652f47a704a7 (diff) | |
download | FreeBSD-src-3832f1d915b281e8dfaf6e6ebeb2dc3e1c24aa5a.zip FreeBSD-src-3832f1d915b281e8dfaf6e6ebeb2dc3e1c24aa5a.tar.gz |
Fixed cross-references in SEE ALSO.
Emininated double space and hard sentence breaks.
Diffstat (limited to 'lib/libarchive/tar.5')
-rw-r--r-- | lib/libarchive/tar.5 | 30 |
1 files changed, 19 insertions, 11 deletions
diff --git a/lib/libarchive/tar.5 b/lib/libarchive/tar.5 index 87e040f..fdfe7c3 100644 --- a/lib/libarchive/tar.5 +++ b/lib/libarchive/tar.5 @@ -216,7 +216,8 @@ struct header_posix_ustar { .Ed .Bl -tag -width indent .It Va typeflag -Type of entry. POSIX extended the earlier +Type of entry. +POSIX extended the earlier .Va linkflag field with several new type values: .Bl -tag -width indent -compact @@ -262,7 +263,8 @@ Contains the magic value followed by a NULL byte to indicate that this is a POSIX standard archive. Full compliance requires the uname and gname fields be properly set. .It Va version -Version. This should be +Version. +This should be .Dq 00 (two copies of the ASCII digit zero) for POSIX standard archives. .It Va uname , Va gname @@ -497,12 +499,16 @@ GNU tar treats type "7" records identically to type "0" records, except on one obscure RTOS where they are used to indicate the pre-allocation of a contiguous file on disk. .It "D" -This indicates a directory entry. Unlike the POSIX-standard "5" +This indicates a directory entry. +Unlike the POSIX-standard "5" typeflag, the header is followed by data records listing the names -of files in this directory. Each name is preceded by an ASCII "Y" +of files in this directory. +Each name is preceded by an ASCII "Y" if the file is stored in this archive or "N" if the file is not -stored in this archive. Each name is terminated with a null, and -an extra null marks the end of the name list. The purpose of this +stored in this archive. +Each name is terminated with a null, and +an extra null marks the end of the name list. +The purpose of this entry is to support incremental backups; a program restoring from such an archive may wish to delete files on disk that did not exist in the directory when the archive was made. @@ -544,9 +550,11 @@ FreeBSD's version of GNU tar does not handle the corner case of an archive's being continued in the middle of a long name or other extension header. .It "N" -Type "N" records are no longer generated by GNU tar. They contained a +Type "N" records are no longer generated by GNU tar. +They contained a list of files to be renamed or symlinked after extraction; this was -originally used to support long names. The contents of this record +originally used to support long names. +The contents of this record are a text description of the operations to be done, in the form .Dq Rename %s to %s\en or @@ -663,7 +671,7 @@ GNU tar encounters a damaged archive. .Sh SEE ALSO .Xr ar 1 , .Xr pax 1 , -.Xr tar 1 , +.Xr tar 1 .Sh STANDARDS The .Nm tar @@ -687,6 +695,6 @@ public-domain implementation (circa 1987) was highly influential and formed the basis of GNU tar. Joerg Shilling's .Nm star -archiver is another open-source (GPL) archiver (originally developed -circa 1985) which features complete support for pax interchange +archiver is another open-source (GPL) archiver (originally developed +circa 1985) which features complete support for pax interchange format. |