This library is for working with .tar archive files. It can read and write a range of common variations of archive format including V7, POSIX USTAR and GNU formats. It provides support for packing and unpacking portable archives and features for random access to archive content using an index.
For a quick start with the API look at htar/htar.hs,
which implements a very basic tar command-line tool.
To run benchmarks download 01-index.tar into the package folder:
This release features support for long file paths and symlinks
(thanks to Julian Ospald) and variety of changes and improvements
across entire package, fixing multiple causes of silent data corruption.
Breaking changes:
Generalize Entries, Entry and EntryContent to GenEntries, GenEntry and GenEntryContent.
Functions working on entries have been generalized to more polymorphic types,
where possible.
Modules which used to import Codec.Archive.Tar (Entry(..)) should now
import Codec.Archive.Tar (Entry, pattern Entry) and similar for other Gen-types.
Another option is to import the entire module qualified.
Redesign Codec.Archive.Tar.Check.
Change types of checkSecurity, checkTarbomb, checkPortability.
Add offending path as new field to TarBombError constructor.
Extend FileNameError with UnsafeLinkTarget constructor.
Add support for over-long filepaths via GNU extension.
Now entryPath corresponds to an internal, low-level path, limited
to 255 characters. To list filenames properly use decodeLongNames,
followed by entryTarPath.
Fix handling of hardlinks and symlinks.
Handle > 8 GB files insted of silent corruption.
Prohibit non-ASCII file names instead of silent corruption.
Set permissions on extracted files.
Ignore FAT32 errors when setting modification time.
Switch to trailer parsing mode only after a full block of NUL.
Revert accidental minor API change in 0.4.x series (the type of the
owner and group name strings). The 0.4.3.0 and 0.4.4.0 releases
contained the accidental API change.
