summaryrefslogtreecommitdiffstats
path: root/lib/libarchive
diff options
context:
space:
mode:
authorkientzle <kientzle@FreeBSD.org>2005-08-02 03:10:52 +0000
committerkientzle <kientzle@FreeBSD.org>2005-08-02 03:10:52 +0000
commitbf7551aa876ecb203502b88763d953a2eb81cb0f (patch)
tree68649bb7275f3db3f288bacd9e7b505147b7f376 /lib/libarchive
parent5aa08bac53ff84f5f154d9a58d670d05d7150e83 (diff)
downloadFreeBSD-src-bf7551aa876ecb203502b88763d953a2eb81cb0f.zip
FreeBSD-src-bf7551aa876ecb203502b88763d953a2eb81cb0f.tar.gz
Correct a few minor mis-statements (libarchive does support reading
GNU tar sparse files, people have extended cpio) and clarify an important detail about pax format (that ustar-compliant archivers can mostly read pax archives correctly). MFC after: 7 days
Diffstat (limited to 'lib/libarchive')
-rw-r--r--lib/libarchive/libarchive-formats.511
1 files changed, 6 insertions, 5 deletions
diff --git a/lib/libarchive/libarchive-formats.5 b/lib/libarchive/libarchive-formats.5
index 0b32c7b..ac2cccd 100644
--- a/lib/libarchive/libarchive-formats.5
+++ b/lib/libarchive/libarchive-formats.5
@@ -72,7 +72,7 @@ The
library can read GNU-format tar archives.
It currently supports the most popular GNU extensions, including
modern long filename and linkname support, as well as atime and ctime data.
-The libarchive library does not support sparse files, multi-volume
+The libarchive library does not support multi-volume
archives, nor the old GNU long filename format.
.It Cm pax
The
@@ -105,6 +105,11 @@ ustar data (user name, group name, UID, GID, etc) cannot be fully
represented in the ustar header.
In all cases, the result can be dearchived by any program that
can read POSIX-compliant pax interchange format archives.
+Programs that correctly read ustar format (see below) will also be
+able to read this format; any extended attributes will be extracted as
+separate files stored in
+.Pn PaxHeader
+directories.
.It Cm ustar
The libarchive library can both read and write this format.
This format has the following limitations:
@@ -188,10 +193,6 @@ limit for most other fields makes it unsuitable for modern systems.
In addition, cpio formats only store numeric UID/GID values (not
usernames and group names), which can make it very difficult to correctly
transfer archives across systems.
-Finally, there is no good way to extend the format, which means that
-ACLs, file flags, character encoding information, and non-standard file
-types can not be added except by breaking compatibility with existing
-implementations.
.Ss Shar Formats
A
.Dq shell archive
OpenPOWER on IntegriCloud