forked from mirrors/tar-split
36 lines
924 B
Markdown
36 lines
924 B
Markdown
|
Overview
|
||
|
|
--------
|
||
|
|
|
||
|
|
Extend the upstream golang stdlib `archive/tar` library, to expose the raw
|
||
|
|
bytes of the TAR, rather than just the marshalled headers and file stream.
|
||
|
|
|
||
|
|
The goal being that by preserving the raw bytes of each header, padding bytes,
|
||
|
|
and the raw file payload, one could reassemble the original archive.
|
||
|
|
|
||
|
|
|
||
|
|
Caveat
|
||
|
|
======
|
||
|
|
|
||
|
|
Eventually this should detect TARs that this is not possible with.
|
||
|
|
|
||
|
|
For example stored sparse files that have "holes" in them, will be read as a
|
||
|
|
contiguous file, though the archive contents may be recorded in sparse format.
|
||
|
|
Therefore when adding the file payload to a reassembled tar, to achieve
|
||
|
|
identical output, the file payload would need be precisely re-sparsified. This
|
||
|
|
is not something I seek to fix imediately, but would rather have an alert that
|
||
|
|
precise reassembly is not possible.
|
||
|
|
|
||
|
|
|
||
|
|
Contract
|
||
|
|
========
|
||
|
|
|
||
|
|
Do not break the API of stdlib `archive/tar`
|
||
|
|
|
||
|
|
|
||
|
|
License
|
||
|
|
=======
|
||
|
|
|
||
|
|
See LICENSE
|
||
|
|
|
||
|
|
|