Introduction
============
This is a very small untar (TAR archive reader) utility written in C. It's
meant to be embedded within code. I wrote this because the only other option
seemed to be zlib, which was overkill. There are no library dependencies
other than the "math" library (for some standard math calls).
How it Works
============
You pass three callbacks to the read_tar() routine:
Header callback
Receives a header struct, and an entry index.
Identifies the beginning of a file. This callback is always invoked before
the other two.
Data callback
Receives a header struct, entry index, a block of data, and the length of
the block.
Called one or more times for each block of data. This callback is always
invoked after the header callback, and before the end callback.
End callback:
Receives a header struct, and an entry index.
This callback is always invoked after all of the data for an entry has been
reported.
Running the Example
==================
1) Run 'make'.
2) Run 'build/untar <TAR file>'
The example will expand all normal (non-links, non-special, non-directory..)
entries into /tmp. It will not create directories, so you'll have to create the
directories mentioned in the "can't write" error messages.
Notes
=====
This utility supports both the primitive and USTAR formats (this should be a
majority of the TAR files), but none of the vendor-specific formats that may
exist. I wrote it according to the specifications that I had available.
If a TAR file isn't being successfully read, submit a bug and I'll try to adopt
it, if there's a simple fix.