freebsd-skq/lib/libarchive
Martin Matuska e967c8b899 Add compatibility for ISO images created with unfixed makefs that
violated ECMA-119 (ISO9660): allow reserved4 to be 0x20 in PVD.
This allows tar to read FreeBSD distribution ISO images created
with makefs prior to NetBSD bin/45217 bugfix (up to 9.0-BETA1).

In addition, merge following important bugfixes from
libarchive's release/2.8 branch:

Revision 2812:
Merge 2811 from trunk:  Don't try to verify that compression-level=0
produces larger results than the default compression, since this isn't
true for all versions of liblzma.

Revision 2817:
Merge 2814 from trunk: Fix Issue 121 (mtree parser error)
http://code.google.com/p/libarchive/issues/detail?id=121

Revision 2820:
Fix issue 119.
Change the file location check that a file location does not exceed
volume block. New one is that a file content does not exceed volume
block(end of an ISO image). It is better than previous check even
if the issue did not happen.

While reading an ISO image generated by an older version of mkisofs
utility, a file location indicates the end the ISO image if its file
size is zero and it is the last file of all files of the ISO image,
so it is possible that the location value is the same as the number
of the total block of the ISO image.

http://code.google.com/p/libarchive/issues/detail?id=119

Revision 2955:
Issue 134:  Fix libarchive 2.8 crashing in archive_write_finish() when
the open has failed and we're trying to write Zip format.

http://code.google.com/p/libarchive/issues/detail?id=134

Revision 2958:
Followup on Issue 134:
 1) Port test_open_failure to libarchive 2.8 branch to test
    the problem reported in Issue 134.
    This test also shows that archive_read_open() sometimes
    fails to report open errors correctly.
 2) Fix the bug in archive_read.c
 3) Comment out the tests that close functions are invoked
    promptly when open fails; that's fully fixed in libarchive 3.0,
    but I don't think it's worth fixing here.

Revision 3484:
Use uintmax_t with %ju

Revision 3487:
Fix issue 163.
Correctly allocate enough memory for a input buffer saved.

http://code.google.com/p/libarchive/issues/detail?id=163

Revision 3542:
Merge 2516, 2536 from trunk:  Allow path table offset values of
0 and 18, which are used by some ISO writers.

Reviewed by:	kientzle
Approved by:	re (kib)
MFC after:	3 days
2011-08-07 08:42:36 +00:00
..
libarchive_fe - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
test Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_check_magic.c Portability: terminate abnormally via abort() instead of segfault, 2009-12-28 02:20:23 +00:00
archive_crc32.h Handle Zip CRC validation for uncompressed Zip archives even on 2009-12-28 03:11:36 +00:00
archive_endian.h Compatibility: I found some more compilers that don't like 'inline' keyword. 2009-12-28 02:17:15 +00:00
archive_entry_copy_stat.c Merge r552,r559 from libarchive.googlecode.com: Support high-resolution 2009-03-07 00:52:02 +00:00
archive_entry_link_resolver.c Don't try to hardlink block or character device nodes that come out 2010-01-23 07:57:17 +00:00
archive_entry_private.h Various portability fixes, plus: 2009-12-28 02:41:27 +00:00
archive_entry_stat.c Use ino64 interface. 2009-12-28 03:05:31 +00:00
archive_entry_strmode.c Mark hardlinks that lack any other interesting filetype information 2008-06-15 05:14:01 +00:00
archive_entry_xattr.c Various portability fixes, plus: 2009-12-28 02:41:27 +00:00
archive_entry.3 mdoc nitpicking: the title argument shall be uppercase 2010-06-11 06:03:47 +00:00
archive_entry.c Various portability fixes, plus: 2009-12-28 02:41:27 +00:00
archive_entry.h Various portability fixes, plus: 2009-12-28 02:41:27 +00:00
archive_hash.h - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_platform.h Portability: 2009-12-28 02:22:04 +00:00
archive_private.h Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_read_data_into_fd.c Check that lseek(2) succeeds and puts us where we expect. [1] 2008-05-23 05:01:29 +00:00
archive_read_disk_entry_from_file.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_disk_private.h Discourage external use of this header. 2009-12-28 03:20:54 +00:00
archive_read_disk_set_standard_lookup.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_disk.3 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_read_disk.c Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_read_extract.c Don't write data into an empty "file." 2010-12-07 16:48:01 +00:00
archive_read_open_fd.c Retry reads that fail with EINTR. This fixes a problem 2010-05-18 14:11:38 +00:00
archive_read_open_file.c Portability: Set the file descriptor to binary mode on Win32 2009-12-28 02:28:44 +00:00
archive_read_open_filename.c Retry reads that fail with EINTR. This fixes a problem 2010-05-18 14:11:38 +00:00
archive_read_open_memory.c New "version stamp" simplifies determining the exact version 2007-07-06 15:36:38 +00:00
archive_read_private.h Allow more formats to be active at a time; discourage outside use. 2009-12-28 02:18:55 +00:00
archive_read_support_compression_all.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_support_compression_bzip2.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_support_compression_compress.c Eliminate an unused assignment. 2009-12-28 02:29:21 +00:00
archive_read_support_compression_gzip.c Catch certain gzip failures at close time. 2009-12-28 02:05:28 +00:00
archive_read_support_compression_none.c MfP4: Big read filter refactoring. 2008-12-06 06:45:15 +00:00
archive_read_support_compression_program.c Portability. 2009-12-28 06:59:35 +00:00
archive_read_support_compression_rpm.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_support_compression_uu.c Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_read_support_compression_xz.c If we're linking against liblzma, allow the decompressor to use up to 2009-12-29 06:06:20 +00:00
archive_read_support_format_all.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_support_format_ar.c Include limits.h; remove unused variable. 2009-12-28 03:06:27 +00:00
archive_read_support_format_cpio.c Be a little more skeptical of dev/ino matches when reading cpio files. 2009-12-29 05:50:34 +00:00
archive_read_support_format_empty.c Remove an unused variable. 2009-04-26 18:24:14 +00:00
archive_read_support_format_iso9660.c Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_read_support_format_mtree.c Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_read_support_format_raw.c Remove an unused variable and an unreachable statement. 2009-12-28 03:25:33 +00:00
archive_read_support_format_tar.c Style fixes to tar reader: 2009-12-29 05:44:39 +00:00
archive_read_support_format_xar.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read_support_format_zip.c If the Zip reader doesn't see a PK signature block 2010-11-07 03:40:37 +00:00
archive_read.3 - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_read.c Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_string_sprintf.c Merge r505 from libarchive.googlecode.com: Fix %ju support. Simplify 2009-03-06 05:14:55 +00:00
archive_string.c Remove an unused variable and an unnecessary increment. 2009-12-28 02:33:22 +00:00
archive_string.h Discourage outside use of this internal header. 2009-12-28 02:26:06 +00:00
archive_util.3 mdoc nitpicking: the title argument shall be uppercase 2010-06-11 06:03:47 +00:00
archive_util.c New archive_file_count() utility. 2009-12-28 02:58:14 +00:00
archive_virtual.c Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_write_disk_private.h Discourage people from using this header outside of libarchive. 2009-12-28 02:17:53 +00:00
archive_write_disk_set_standard_lookup.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_write_disk.3 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_write_disk.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_write_open_fd.c Portability: Set the file descriptor to binary mode on Win32 2009-12-28 02:28:44 +00:00
archive_write_open_file.c Fix the copyright notice; it was always intended to be 2007-01-09 08:05:56 +00:00
archive_write_open_filename.c Merge from libarchive.googlecode.com: If we're 2009-04-17 00:39:35 +00:00
archive_write_open_memory.c Fix the copyright notice; it was always intended to be 2007-01-09 08:05:56 +00:00
archive_write_private.h 64-bit ino support and discourage bad use of this header. 2009-12-29 05:20:12 +00:00
archive_write_set_compression_bzip2.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
archive_write_set_compression_compress.c Remove some dead assignments, fix some declarations. 2009-12-28 03:33:05 +00:00
archive_write_set_compression_gzip.c Remove a dead assignment. 2009-12-28 02:04:42 +00:00
archive_write_set_compression_none.c Remove some unused variables and dead assignments. 2009-12-28 02:03:54 +00:00
archive_write_set_compression_program.c Remove unused variable. 2009-12-28 03:14:30 +00:00
archive_write_set_compression_xz.c Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_write_set_format_ar.c Fix some unused variables and dead assignments. 2009-12-28 03:28:21 +00:00
archive_write_set_format_by_name.c Zip write support for libarchive. 2009-12-29 06:15:32 +00:00
archive_write_set_format_cpio_newc.c Various style fixes to the 'newc' cpio writer: 2009-12-29 05:41:57 +00:00
archive_write_set_format_cpio.c Essentially eliminate problems with false hardlinks in POSIX cpio 2009-12-29 06:34:23 +00:00
archive_write_set_format_mtree.c Rationalize the support for cryptographic hashes. 2009-12-29 06:39:07 +00:00
archive_write_set_format_pax.c Style and portability fixes for pax writer. Mostly very routine, except for: 2009-12-29 05:47:46 +00:00
archive_write_set_format_shar.c Merge r491,493,500,507,510,530,543 from libarchive.googlecode.com: 2009-03-06 05:58:56 +00:00
archive_write_set_format_ustar.c Merge r1021 from libarchive.googlecode.com: 2009-04-27 18:35:03 +00:00
archive_write_set_format_zip.c Add compatibility for ISO images created with unfixed makefs that 2011-08-07 08:42:36 +00:00
archive_write_set_format.c Zip write support for libarchive. 2009-12-29 06:15:32 +00:00
archive_write.3 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_write.c Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive.h - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
config_freebsd.h - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
COPYING Fix the copyright notice; it was always intended to be 2007-01-09 08:05:56 +00:00
cpio.5 mdoc: move CAVEATS, BUGS and SECURITY CONSIDERATIONS sections to the 2010-05-13 12:07:55 +00:00
filter_fork.c - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
filter_fork.h Enforce this as an internal-only header. 2009-12-28 02:18:26 +00:00
libarchive_internals.3 Fix manpage markup. 2010-11-06 10:54:33 +00:00
libarchive-formats.5 mdoc: drop redundant .Pp and .LP calls 2010-10-08 12:40:16 +00:00
libarchive.3 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
Makefile - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
README - Update libarchive to 2.8.4 2011-07-17 21:27:38 +00:00
tar.5 mdoc nitpicking: the title argument shall be uppercase 2010-06-11 06:03:47 +00:00

$FreeBSD$

libarchive: a library for reading and writing streaming archives

This is all under a BSD license.  Use, enjoy, but don't blame me if it breaks!

Documentation:
 * libarchive.3 gives an overview of the library as a whole
 * archive_read.3, archive_write.3, and archive_write_disk.3 provide
   detailed calling sequences for the read and write APIs
 * archive_entry.3 details the "struct archive_entry" utility class
 * libarchive-formats.5 documents the file formats supported by the library
 * tar.5 provides some detailed information about a variety of different
   "tar" formats.

You should also read the copious comments in "archive.h" and the source
code for the sample "bsdtar" and "minitar" programs for more details.
Please let me know about any errors or omissions you find.

Currently, the library automatically detects and reads the following:
  * gzip compression
  * bzip2 compression
  * compress/LZW compression
  * lzma and xz compression
  * GNU tar format (including GNU long filenames, long link names, and
    sparse files)
  * Solaris 9 extended tar format (including ACLs)
  * Old V7 tar archives
  * POSIX ustar
  * POSIX pax interchange format
  * POSIX octet-oriented cpio
  * SVR4 ASCII cpio
  * Binary cpio (big-endian or little-endian)
  * ISO9660 CD-ROM images (with optional Rockridge or Joliet extensions)
  * ZIP archives (with uncompressed or "deflate" compressed entries)
  * GNU and BSD 'ar' archives
  * 'mtree' format

The library can write:
  * gzip compression
  * bzip2 compression
  * compress/LZW compression
  * lzma and xz compression
  * POSIX ustar
  * POSIX pax interchange format
  * "restricted" pax format, which will create ustar archives except for
    entries that require pax extensions (for long filenames, ACLs, etc).
  * POSIX octet-oriented cpio
  * SVR4 "newc" cpio
  * shar archives
  * ZIP archives (with uncompressed or "deflate" compressed entries)
  * GNU and BSD 'ar' archives
  * 'mtree' format

Notes:
 * This is a heavily stream-oriented system.  There is no direct
   support for in-place modification or random access and no intention
   of ever adding such support.  Adding such support would require
   sacrificing a lot of other features, so don't bother asking.

 * The library is designed to be extended with new compression and
   archive formats.  The only requirement is that the format be
   readable or writable as a stream and that each archive entry be
   independent.

 * On read, compression and format are always detected automatically.

 * I've attempted to minimize static link pollution.  If you don't
   explicitly invoke a particular feature (such as support for a
   particular compression or format), it won't get pulled in.
   In particular, if you don't explicitly enable a particular
   compression or decompression support, you won't need to link
   against the corresponding compression or decompression libraries.
   This also reduces the size of statically-linked binaries in
   environments where that matters.

 * On read, the library accepts whatever blocks you hand it.
   Your read callback is free to pass the library a byte at a time
   or mmap the entire archive and give it to the library at once.
   On write, the library always produces correctly-blocked
   output.

 * The object-style approach allows you to have multiple archive streams
   open at once.  bsdtar uses this in its "@archive" extension.

 * The archive itself is read/written using callback functions.
   You can read an archive directly from an in-memory buffer or
   write it to a socket, if you wish.  There are some utility
   functions to provide easy-to-use "open file," etc, capabilities.

 * The read/write APIs are designed to allow individual entries
   to be read or written to any data source:  You can create
   a block of data in memory and add it to a tar archive without
   first writing a temporary file.  You can also read an entry from
   an archive and write the data directly to a socket.  If you want
   to read/write entries to disk, the archive_write_disk interface
   treats a directory as if it were an archive so you can copy
   from archive->disk using the same code you use for archive->archive
   transfers.

 * Note: "pax interchange format" is really an extended tar format,
   despite what the name says.