Add support for a new archive format "empty" that reads empty files.

1 files changed, 15 insertions, 1 deletions

diff --git a/lib/libarchive/archive_read.3 b/lib/libarchive/archive_read.3
index daa3c84..f968238 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.