summaryrefslogtreecommitdiffstats
path: root/lib/libarchive/tar.5
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-07-04 21:15:37 +0000
committerru <ru@FreeBSD.org>2004-07-04 21:15:37 +0000
commit3832f1d915b281e8dfaf6e6ebeb2dc3e1c24aa5a (patch)
treeeeb188496b296e3a5e407412a6c132e4469fabf8 /lib/libarchive/tar.5
parent6651f20e0daee8d4c1fee0a632e7652f47a704a7 (diff)
downloadFreeBSD-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.530
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.
OpenPOWER on IntegriCloud