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)