freebsd-dev/lib/libarchive
Tim Kientzle f408e1d38d If the Zip reader doesn't see a PK signature block
because there's inter-entry garbage, just scan forward
to find the next one.  This allows us to handle a lot
of Zip archives that have been modified in-place.

Thanks to: Gleb Kurtsou for sending me a sample archive
2010-11-07 03:40:37 +00:00
..
test If the Zip reader doesn't see a PK signature block 2010-11-07 03:40:37 +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 Rationalize the support for cryptographic hashes. 2009-12-29 06:39:07 +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 If we can't stat a file, return the correct ARCHIVE_FAILED (this entry can't 2010-01-23 07:54:15 +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 Compatibility with old systems with non-POSIX getpwuid_r/getgrgid_r. 2009-12-28 03:30:31 +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 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +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 UU decoder. Now that libarchive can recursively taste input streams, 2009-12-30 06:12:03 +00:00
archive_read_support_compression_bzip2.c Fix some unused variables and dead assignments. 2009-12-28 03:28:21 +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_uu.c UU decoder. Now that libarchive can recursively taste input streams, 2009-12-30 06:12:03 +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.4.10. This includes a number of improvements 2007-12-30 04:58:22 +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 Use a simpler memory-management strategy for the file objects. 2010-01-23 07:55:53 +00:00
archive_read_support_format_mtree.c Minor style fixes plus a fix for an obscure crash on certain malformed 2009-12-29 05:52:13 +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_zip.c If the Zip reader doesn't see a PK signature block 2010-11-07 03:40:37 +00:00
archive_read.3 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
archive_read.c Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +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 Compatibility fix for some older systems with non-POSIX getgrnam_r/getpwnam_r 2009-12-28 02:09:57 +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 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +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 Remove dead assignment. 2009-12-28 02:22:41 +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 Fix some unused variables and dead assignments. 2009-12-28 03:28:21 +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 Initialize the allocated 'struct zip'. 2010-01-23 07:52:44 +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 Clarify the naming: Methods that free an object should 2010-11-05 05:11:54 +00:00
config_freebsd.h Reorganize slightly in preparation for making lzma and bz2 support conditional. 2010-05-16 20:43:17 +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 Portability: Don't use symbolic constants when the values are more 2008-09-12 05:33:00 +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 Fix build. 2010-05-17 07:06:54 +00:00
README libarchive 2.0 2007-03-03 07:37:37 +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
  * 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 extensions)
  * ZIP archives (with uncompressed or "deflate" compressed entries)

The library can write:
  * gzip compression
  * bzip2 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
  * shar archives

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.