Poster of Linux kernelThe best gift for a Linux geek
th_read

th_read

Section: C Library Calls (3) Updated: Jan 2001
Local index Up
 

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)


 

Index

NAME
SYNOPSIS
VERSION
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:57:23 GMT, April 16, 2011