NAME

       tar_append_file, tar_append_eof, tar_append_regfile - append data to tar archives

SYNOPSIS

       #include <libtar.h>

       int tar_append_file(TAR *t, char *realname, char *savename);

       int tar_append_regfile(TAR *t, char *realname);

       int tar_append_eof(TAR *t);

VERSION

       This man page documents version 1.2 of libtar.

DESCRIPTION

       The  tar_append_file()  function creates a tar file header block describing the file named
       by the realname argument, but with the encoded filename of savename.   It  then  sets  the
       current  header  associated  with  the TAR handle t to the newly created header block, and
       writes this block to the tar archive associated with t.  If the file named by realname  is
       a  regular  file  (and  is  not  encoded  as  a  hard  link),  tar_append_file() will call
       tar_append_regfile() to append the contents of the file.

       The tar_append_regfile() function appends the contents  of  a  regular  file  to  the  tar
       archive  associated with t.  Since this function is called by tar_append_file(), it should
       only be necessary for applications that construct and write the tar file header  on  their
       own.

       The  tar_append_eof()  function  writes an EOF marker (two blocks of all zeros) to the tar
       file associated with t.

RETURN VALUES

       On successful completion, these functions will return 0.  On failure, they will return  -1
       and set errno to an appropriate value.

ERRORS

       The tar_append_*() functions will fail if:

       EINVAL Less than T_BLOCKSIZE bytes were written to the tar archive.

       EINVAL Less than T_BLOCKSIZE bytes were read from the realname file.

       They  may  also  fail  if  any of the following functions fail: lstat(), malloc(), open(),
       read(), th_write(), or the write function for the file type associated with the TAR handle
       t.

SEE ALSO

       read(2), open(2), lstat(2), th_write(3)