Manpages - tar_extract_all.3

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

#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/);*

This man page documents version 1.2 of libtar.

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.

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

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

*opendir*(2), *lstat*(2), *tar_skip_regfile*(3), *tar_extract_regfile*(3), *tar_append_file*(3)