NAME

       tar_extract_file,    tar_extract_regfile,    tar_extract_hardlink,    tar_extract_symlink,
       tar_extract_chardev,     tar_extract_blockdev,     tar_extract_dir,      tar_extract_fifo,
       tar_skip_regfile, tar_set_file_perms - extract files from a tar archive

SYNOPSIS

       #include <libtar.h>

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

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

       int tar_skip_regfile(TAR *t);

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

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

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

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

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

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

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

VERSION

       This man page documents version 1.2 of libtar.

DESCRIPTION

       The  tar_extract_file()  function  acts  as  a  front-end  to  the  other  tar_extract_*()
       functions.  It checks the current tar header associated with the TAR handle t (which  must
       be  initialized  first  by  calling  th_read())  to determine what kind of file the header
       refers to.  It then calls the appropriate tar_extract_*() function to extract that kind of
       file.

       The  tar_skip_regfile() function skips over the file content blocks and positions the file
       pointer at the expected location of the next tar header block.

       The tar_set_file_perms() function sets the attributes of the extracted file to  match  the
       encoded values.  This includes the file's modification time, mode, owner, and group.  This
       function is automatically called by tar_extract_file(), but applications  which  call  the
       other  tar_extract_*()  functions directly will need to call tar_set_file_perms() manually
       if this behavior is desired.

RETURN VALUES

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

       The tar_extract_dir() function will return 1 if the directory already exists.

ERRORS

       The tar_extract_file() function will fail if:

       EEXIST If the O_NOOVERWRITE flag is set and the file already exists.

       The tar_extract_*() functions will fail if:

       EINVAL An entry could not be added to the internal file hash.

       EINVAL Less than T_BLOCKSIZE bytes were read from the tar archive.

       EINVAL The  current  file header associated with t refers to a kind of file other than the
              one which the called function knows about.

       They may also fail if any of the  following  functions  fail:  mkdir(),  write(),  link(),
       symlink(), mknod(), mkfifo(), utime(), chown(), lchown(), chmod(), or lstat().

SEE ALSO

       mkdir(2),   write(2),   link(2),  symlink(2),  mknod(2),  mkfifo(2),  utime(2),  chown(2),
       lchown(2), chmod(2), lstat(2)