Storehouse.Archive.Tar (Storehouse v0.2.0)

Copy Markdown View Source

The tar format of Storehouse.Archive: for Unix tools and backups, gzipped (.tar.gz) or not, made as a stream.

  • :compression - :auto (the default) gzips the archive when most of its bytes shrink; :compress always, :none never.
  • Names longer than tar's own, or not ASCII, and files past 8 GB have a pax header (POSIX.1-2001), which every tar of this century reads.

A tar's header gives a file's size before its bytes, so every file's size is known before: a file of unknown size ({:stream, …}, {:call, …}) gives an ArgumentError. It is not encrypted: :password gives one too.