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)