From a2e467d35a32bd8df27316f2bfb81702f77bee63 Mon Sep 17 00:00:00 2001 From: Tim Kientzle Date: Tue, 2 Aug 2005 03:10:52 +0000 Subject: [PATCH] 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 --- lib/libarchive/libarchive-formats.5 | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/lib/libarchive/libarchive-formats.5 b/lib/libarchive/libarchive-formats.5 index 0b32c7bf61b8..ac2cccd10ed8 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