oracular (3) tar_extract_all.3.gz

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)