th_read(3) C Library Calls th_read(3)NAME
th_read, th_write - read and write a file header block from a tar ar‐
chive
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 asso‐
ciated 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.
ERRORSth_read() and th_write() will fail if:
EINVAL Less than T_BLOCKSIZE blocks were read or written.
SEE ALSOtar_block_read(3), tar_block_write(3)University of Illinois Jan 2001 th_read(3)