tar_extract_glob(3) [centos man page]

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)

tar_append_file(3)						  C Library Calls						tar_append_file(3)

NAME

       tar_append_file, tar_append_eof, tar_append_regfile - append data to tar archives

SYNOPSIS

       #include <libtar.h>

       int tar_append_file(TAR *t, char *realname, char *savename);

       int tar_append_regfile(TAR *t, char *realname);

       int tar_append_eof(TAR *t);

VERSION

       This man page documents version 1.2 of libtar.

DESCRIPTION

       The  tar_append_file()  function  creates  a tar file header block describing the file named by the realname argument, but with the encoded
       filename of savename.  It then sets the current header associated with the TAR handle t to the newly created header block, and writes  this
       block  to  the  tar  archive  associated  with  t.   If	the  file named by realname is a regular file (and is not encoded as a hard link),
       tar_append_file() will call tar_append_regfile() to append the contents of the file.

       The tar_append_regfile() function appends the contents of a regular file to the tar archive associated with  t.	 Since	this  function	is
       called by tar_append_file(), it should only be necessary for applications that construct and write the tar file header on their own.

       The tar_append_eof() function writes an EOF marker (two blocks of all zeros) to the tar file associated with t.

RETURN VALUES

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

ERRORS

       The tar_append_*() functions will fail if:

       EINVAL Less than T_BLOCKSIZE bytes were written to the tar archive.

       EINVAL Less than T_BLOCKSIZE bytes were read from the realname file.

       They  may  also	fail  if any of the following functions fail: lstat(), malloc(), open(), read(), th_write(), or the write function for the
       file type associated with the TAR handle t.

SEE ALSO

       read(2), open(2), lstat(2), th_write(3)

University of Illinois						     Jan 2001							tar_append_file(3)