diff options
author | Tim Kientzle <kientzle@FreeBSD.org> | 2007-02-01 06:18:17 +0000 |
---|---|---|
committer | Tim Kientzle <kientzle@FreeBSD.org> | 2007-02-01 06:18:17 +0000 |
commit | a9490c597b215e790f04ba57fe2e9ff2fe06671b (patch) | |
tree | b6d13d0072dd0ec2772d200e2d809b889365ef1a /lib/libarchive/archive_read.3 | |
parent | c69e1d83f5af7009befd6c9981c76c75592d65c2 (diff) | |
download | src-test2-a9490c597b215e790f04ba57fe2e9ff2fe06671b.tar.gz src-test2-a9490c597b215e790f04ba57fe2e9ff2fe06671b.zip |
Notes
Diffstat (limited to 'lib/libarchive/archive_read.3')
-rw-r--r-- | lib/libarchive/archive_read.3 | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/lib/libarchive/archive_read.3 b/lib/libarchive/archive_read.3 index daa3c84a626d..f968238a6fc7 100644 --- a/lib/libarchive/archive_read.3 +++ b/lib/libarchive/archive_read.3 @@ -36,6 +36,7 @@ .Nm archive_read_support_compression_none , .Nm archive_read_support_format_all , .Nm archive_read_support_format_cpio , +.Nm archive_read_support_format_empty , .Nm archive_read_support_format_iso9660 , .Nm archive_read_support_format_tar , .Nm archive_read_support_format_zip , @@ -75,6 +76,8 @@ .Ft int .Fn archive_read_support_format_cpio "struct archive *" .Ft int +.Fn archive_read_support_format_empty "struct archive *" +.Ft int .Fn archive_read_support_format_iso9660 "struct archive *" .Ft int .Fn archive_read_support_format_tar "struct archive *" @@ -135,7 +138,7 @@ is always enabled by default. For convenience, .Fn archive_read_support_compression_all enables all available decompression code. -.It Fn archive_read_support_format_all , Fn archive_read_support_format_cpio , Fn archive_read_support_format_iso9660 , Fn archive_read_support_format_tar, Fn archive_read_support_format_zip +.It Fn archive_read_support_format_all , Fn archive_read_support_format_cpio , Fn archive_read_support_format_empty , Fn archive_read_support_format_iso9660 , Fn archive_read_support_format_tar, Fn archive_read_support_format_zip Enables support---including auto-detection code---for the specified archive format. For example, @@ -539,3 +542,14 @@ or before calling you may confuse the permission-setting logic with the result that directory permissions are restored incorrectly. +.Pp +Many traditional archiver programs treat +empty files as valid empty archives. +For example, many implementations of +.Xr tar 1 +allow you to append entries to an empty file. +Of course, it is impossible to determine the format of an empty file +by inspecting the contents, so this library treats empty files as +having a special +.Dq empty +format. |