tar_extract_all(3)              C Library Calls             tar_extract_all(3)

NAME
       tar_extract_all, tar_extract_glob, tar_append_tree - high-level tar
       archive manipulation functions

SYNOPSIS
       #include <libtar.h>

       int tar_extract_all(TAR *t, char *prefix);

       int tar_extract_glob(TAR *t, char *globname, char *prefix);

       int tar_append_tree(TAR *t, char *realdir, char *savedir);

VERSION
       This man page documents version 1.2 of libtar.

DESCRIPTION
       The tar_extract_all() function extracts all files from the tar archive
       associated with the TAR handle t into the path named by the prefix
       argument.

       The tar_extract_glob() function extracts all files matching the given
       glob pattern from the tar archive associated with the TAR handle t into
       the path named by the prefix argument.

       The tar_append_tree() function appends all files from the directory
       tree named by realdir to the tar archive associated with the TAR handle
       t.  The pathnames stored in the tar archive are modified by replacing
       realdir with savedir, so that the files will be extracted into savedir.

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

ERRORS
       These functions will fail under the same conditions that the
       tar_skip_regfile(), tar_extract_regfile(), opendir(), lstat(), or
       tar_append_file() functions fail.

SEE ALSO
       opendir(2), lstat(2), tar_skip_regfile(3), tar_extract_regfile(3),
       tar_append_file(3)

University of Illinois             Jan 2001                 tar_extract_all(3)