NAME¶
th_read, th_write - read and write a file header block from a tar archive
SYNOPSIS¶
#include <libtar.h>
int th_read(TAR *t);
int th_write(TAR *t);
VERSION¶
This man page documents version 1.2 of
libtar.
DESCRIPTION¶
The
th_read() function reads the next block from the tar archive
associated with the
TAR handle
t. It then sets the current tar
header associated with
t to the contents of the block read.
The
th_write() function writes the contents of the current tar header
associated with
t to the tar archive associated with
t.
RETURN VALUE¶
On successful completion,
th_read() and
th_write() will return 0.
On failure, they will return -1 and set
errno to an appropriate value.
On
EOF,
th_read() will return 1.
ERRORS¶
th_read() and
th_write() will fail if:
- EINVAL
- Less than T_BLOCKSIZE blocks were read or written.
SEE ALSO¶
tar_block_read(3),
tar_block_write(3)