tarruby 0.1.0

data/ext/libtar/configure.ac

@@ -0,0 +1,114 @@
+dnl ### Normal initialization. ######################################
+AC_INIT([libtar], [1.2.11])
+AC_PREREQ([2.57])
+AC_CONFIG_AUX_DIR([autoconf])
+AC_CONFIG_HEADERS([config.h])
+AC_COPYRIGHT([[
+Copyright (c) 1998-2003 University of Illinois Board of Trustees
+Copyright (c) 1998-2003 Mark D. Roth
+All rights reserved.
+]])
+AC_CONFIG_SRCDIR([lib/libtar.h])
+ENCAP_PKG([], [postinstall-encap])
+
+
+dnl ### Load subdirectory modules. ##################################
+PSG_MODULE([compat])
+PSG_MODULE([listhash], [libtar])
+
+
+dnl ### Set some option defaults. ###################################
+if test -z "$CFLAGS"; then
+  CFLAGS="-O"
+fi
+MKDIR="mkdir -p -m 755"
+AC_SUBST([MKDIR])
+
+
+dnl ### Check for compiler et al. ###################################
+AC_PROG_CC
+AC_PROG_RANLIB
+AC_PROG_INSTALL
+AC_PROG_LN_S
+AC_PROG_MAKE_SET
+
+
+dnl ### Compiler characteristics. ##################################
+AC_AIX
+AC_C_CONST
+
+
+dnl ### Checks for header files. ###################################
+AC_HEADER_STDC
+AC_CHECK_HEADERS([unistd.h])
+AC_HEADER_MAJOR
+PSG_REPLACE_TYPE([major_t], [unsigned int], [
+  #include <sys/types.h>
+  #ifdef MAJOR_IN_MKDEV
+  # include <sys/mkdev.h>
+  #else
+  # ifdef MAJOR_IN_SYSMACROS
+  #  include <sys/sysmacros.h>
+  # endif
+  #endif
+])
+PSG_REPLACE_TYPE([minor_t], [unsigned int], [
+  #include <sys/types.h>
+  #ifdef MAJOR_IN_MKDEV
+  # include <sys/mkdev.h>
+  #else
+  # ifdef MAJOR_IN_SYSMACROS
+  #  include <sys/sysmacros.h>
+  # endif
+  #endif
+])
+PSG_REPLACE_TYPE([dev_t], [unsigned long], [
+  #include <sys/types.h>
+  #ifdef MAJOR_IN_MKDEV
+  # include <sys/mkdev.h>
+  #else
+  # ifdef MAJOR_IN_SYSMACROS
+  #  include <sys/sysmacros.h>
+  # endif
+  #endif
+])
+PSG_REPLACE_TYPE([socklen_t], [unsigned long], [
+  #include <sys/types.h>
+  #include <sys/socket.h>
+])
+PSG_REPLACE_TYPE([uint64_t], [long long])
+AC_TYPE_MODE_T
+AC_TYPE_OFF_T
+AC_TYPE_SIZE_T
+AC_TYPE_UID_T
+PSG_REPLACE_TYPE([nlink_t], [unsigned short])
+
+
+dnl ### Check for needed functions. ################################
+COMPAT_FUNC_BASENAME
+COMPAT_FUNC_DIRNAME
+COMPAT_FUNC_FNMATCH
+AC_CHECK_FUNCS([lchown])
+COMPAT_FUNC_MAKEDEV
+COMPAT_FUNC_SNPRINTF
+COMPAT_FUNC_STRDUP
+AC_FUNC_STRFTIME
+COMPAT_FUNC_STRLCPY
+COMPAT_FUNC_STRMODE
+COMPAT_FUNC_STRSEP
+
+
+dnl ### Check for libraries. #######################################
+AC_ARG_WITH([zlib],
+  [  --without-zlib          Use external gzip binary instead of zlib],
+  [],
+  [with_zlib=yes])
+if test "$with_zlib" = "yes"; then
+  AC_CHECK_LIB([z], [gzread])
+fi
+
+
+dnl ### Create output files. #######################################
+AC_CONFIG_FILES([Makefile lib/Makefile libtar/Makefile doc/Makefile])
+AC_OUTPUT
+

data/ext/libtar/doc/Makefile.in

@@ -0,0 +1,152 @@
+# @configure_input@
+
+### Path settings
+srcdir		= @srcdir@
+top_srcdir	= @top_srcdir@
+prefix		= @prefix@
+exec_prefix	= @exec_prefix@
+bindir		= @bindir@
+mandir		= @mandir@
+libdir		= @libdir@
+includedir	= @includedir@
+
+PACKAGE_NAME	= @PACKAGE_NAME@
+PACKAGE_VERSION	= @PACKAGE_VERSION@
+
+@ENCAP_DEFS@
+
+### Installation programs and flags
+INSTALL		= @INSTALL@
+INSTALL_PROGRAM	= @INSTALL_PROGRAM@ -s
+INSTALL_DATA	= @INSTALL_DATA@
+LN_S		= @LN_S@
+MKDIR		= @MKDIR@
+@SET_MAKE@
+
+
+### Makefile rules - no user-servicable parts below
+
+TAR_OPEN_SO		= tar_fdopen \
+			  tar_fd \
+			  tar_close
+TAR_APPEND_FILE_SO	= tar_append_eof \
+			  tar_append_regfile
+TAR_BLOCK_READ_SO	= tar_block_write
+TH_READ_SO		= th_write
+TH_SET_FROM_STAT_SO	= th_finish \
+			  th_set_device \
+			  th_set_group \
+			  th_set_link \
+			  th_set_mode \
+			  th_set_path \
+			  th_set_type \
+			  th_set_user
+TAR_EXTRACT_FILE_SO	= tar_extract_blockdev \
+			  tar_extract_chardev \
+			  tar_extract_dir \
+			  tar_extract_fifo \
+			  tar_extract_hardlink \
+			  tar_extract_regfile \
+			  tar_extract_symlink \
+			  tar_skip_regfile \
+			  tar_set_file_perms
+TH_GET_PATHNAME_SO	= TH_ISBLK \
+			  TH_ISCHR \
+			  TH_ISDIR \
+			  TH_ISFIFO \
+			  TH_ISLNK \
+			  TH_ISLONGLINK \
+			  TH_ISLONGNAME \
+			  TH_ISREG \
+			  TH_ISSYM \
+			  th_get_crc \
+			  th_get_devmajor \
+			  th_get_devminor \
+			  th_get_gid \
+			  th_get_linkname \
+			  th_get_mode \
+			  th_get_mtime \
+			  th_get_size \
+			  th_get_uid
+TH_PRINT_LONG_LS_SO	= th_print
+TAR_EXTRACT_ALL_SO	= tar_extract_glob \
+			  tar_append_tree
+@LISTHASH_PREFIX@_HASH_NEW_SO = \
+			  @LISTHASH_PREFIX@_hash_free \
+			  @LISTHASH_PREFIX@_hash_next \
+			  @LISTHASH_PREFIX@_hash_prev \
+			  @LISTHASH_PREFIX@_hash_search \
+			  @LISTHASH_PREFIX@_hash_add \
+			  @LISTHASH_PREFIX@_hash_getkey \
+			  @LISTHASH_PREFIX@_hash_del
+@LISTHASH_PREFIX@_LIST_NEW_SO = \
+			  @LISTHASH_PREFIX@_list_free \
+			  @LISTHASH_PREFIX@_list_next \
+			  @LISTHASH_PREFIX@_list_prev \
+			  @LISTHASH_PREFIX@_list_search \
+			  @LISTHASH_PREFIX@_list_add \
+			  @LISTHASH_PREFIX@_list_add_str \
+			  @LISTHASH_PREFIX@_list_del \
+			  @LISTHASH_PREFIX@_list_dup \
+			  @LISTHASH_PREFIX@_list_merge
+
+DISTCLEANFILES		= ../listhash/@LISTHASH_PREFIX@_hash_new.3 \
+			  ../listhash/@LISTHASH_PREFIX@_list_new.3
+
+
+all:
+
+.PHONY: clean distclean install
+
+clean:
+
+distclean: clean
+	rm -f Makefile ${DISTCLEANFILES}
+
+install: all
+	${MKDIR} ${DESTDIR}${mandir}/man3
+	${INSTALL_DATA} ${srcdir}/tar_open.3 ${DESTDIR}${mandir}/man3
+	for i in ${TAR_OPEN_SO}; do \
+		echo ".so man3/tar_open.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/tar_append_file.3 ${DESTDIR}${mandir}/man3
+	for i in ${TAR_APPEND_FILE_SO}; do \
+		echo ".so man3/tar_append_file.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/tar_block_read.3 ${DESTDIR}${mandir}/man3
+	for i in ${TAR_BLOCK_READ_SO}; do \
+		echo ".so man3/tar_block_read.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/th_read.3 ${DESTDIR}${mandir}/man3
+	for i in ${TH_READ_SO}; do \
+		echo ".so man3/th_read.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/th_set_from_stat.3 ${DESTDIR}${mandir}/man3
+	for i in ${TH_SET_FROM_STAT_SO}; do \
+		echo ".so man3/th_set_from_stat.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/tar_extract_file.3 ${DESTDIR}${mandir}/man3
+	for i in ${TAR_EXTRACT_FILE_SO}; do \
+		echo ".so man3/tar_extract_file.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/th_get_pathname.3 ${DESTDIR}${mandir}/man3
+	for i in ${TH_GET_PATHNAME_SO}; do \
+		echo ".so man3/th_get_pathname.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/th_print_long_ls.3 ${DESTDIR}${mandir}/man3
+	for i in ${TH_PRINT_LONG_LS_SO}; do \
+		echo ".so man3/th_print_long_ls.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ${srcdir}/tar_extract_all.3 ${DESTDIR}${mandir}/man3
+	for i in ${TAR_EXTRACT_ALL_SO}; do \
+		echo ".so man3/tar_extract_all.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ../listhash/@LISTHASH_PREFIX@_hash_new.3 ${DESTDIR}${mandir}/man3
+	for i in ${@LISTHASH_PREFIX@_HASH_NEW_SO}; do \
+		echo ".so man3/@LISTHASH_PREFIX@_hash_new.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+	${INSTALL_DATA} ../listhash/@LISTHASH_PREFIX@_list_new.3 ${DESTDIR}${mandir}/man3
+	for i in ${@LISTHASH_PREFIX@_LIST_NEW_SO}; do \
+		echo ".so man3/@LISTHASH_PREFIX@_list_new.3" > ${DESTDIR}${mandir}/man3/$${i}.3; \
+	done
+

data/ext/libtar/doc/tar_append_file.3

@@ -0,0 +1,50 @@
+.TH tar_append_file 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+tar_append_file, tar_append_eof, tar_append_regfile \- append data to tar archives
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "int tar_append_file(TAR *" t ", char *" realname ","
+.BI "char *" savename ");"
+
+.BI "int tar_append_regfile(TAR *" t ", char *" realname ");"
+
+.BI "int tar_append_eof(TAR *" t ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBtar_append_file\fP() function creates a tar file header block
+describing the file named by the \fIrealname\fP argument, but with
+the encoded filename of \fIsavename\fP.  It then sets the current
+header associated with the \fITAR\fP handle \fIt\fP to the newly created
+header block, and writes this block to the tar archive associated with
+\fIt\fP.  If the file named by \fIrealname\fP is a regular file (and
+is not encoded as a hard link), \fBtar_append_file\fP() will call
+\fBtar_append_regfile\fP() to append the contents of the file.
+
+The \fBtar_append_regfile\fP() function appends the contents of a regular
+file to the tar archive associated with \fIt\fP.  Since this function is
+called by \fBtar_append_file\fP(), it should only be necessary for
+applications that construct and write the tar file header on their own.
+
+The \fBtar_append_eof\fP() function writes an EOF marker (two blocks of
+all zeros) to the tar file associated with \fIt\fP.
+.SH RETURN VALUES
+On successful completion, these functions will return 0.  On failure,
+they will return -1 and set \fIerrno\fP to an appropriate value.
+.SH ERRORS
+The \fBtar_append_*\fP() functions will fail if:
+.IP \fBEINVAL\fP
+Less than \fBT_BLOCKSIZE\fP bytes were written to the tar archive.
+.IP \fBEINVAL\fP
+Less than \fBT_BLOCKSIZE\fP bytes were read from the \fIrealname\fP file.
+.PP
+They may also fail if any of the following functions fail: \fBlstat\fP(),
+\fBmalloc\fP(), \fBopen\fP(), \fBread\fP(), \fBth_write\fP(), or the
+write function for the file type associated with the \fITAR\fP handle
+\fIt\fP.
+.SH SEE ALSO
+.BR read (2),
+.BR open (2),
+.BR lstat (2),
+.BR th_write (3)

data/ext/libtar/doc/tar_block_read.3

@@ -0,0 +1,24 @@
+.TH tar_block_read 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+tar_block_read, tar_block_write \- macros to call read and write functions
+for the correct tar archive type
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "int tar_block_read(TAR *" t ", char *" buf ");"
+
+.BI "int tar_block_write(TAR *" t ", char *" buf ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBtar_block_read\fP() and \fBtar_block_write\fP() macros call
+the read and write functions for the tar archive type associated with the
+\fITAR\fP handle \fIt\fP.  This type is set when the \fITAR\fP handle
+is created using \fBtar_open\fP().
+.SH RETURN VALUE
+These macros return the same values as the corresponding read and write
+functions.
+.SH SEE ALSO
+.BR read (2),
+.BR write (2),
+.BR tar_open (3)

data/ext/libtar/doc/tar_extract_all.3

@@ -0,0 +1,43 @@
+.TH tar_extract_all 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+tar_extract_all, tar_extract_glob, tar_append_tree \- high-level tar
+archive manipulation functions
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "int tar_extract_all(TAR *" t ", char *" prefix ");"
+
+.BI "int tar_extract_glob(TAR *" t ", char *" globname ","
+.BI "char *" prefix ");"
+
+.BI "int tar_append_tree(TAR *" t ", char *" realdir ","
+.BI "char *" savedir ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBtar_extract_all\fP() function extracts all files from the tar
+archive associated with the \fITAR\fP handle \fIt\fP into the path
+named by the \fIprefix\fP argument.
+
+The \fBtar_extract_glob\fP() function extracts all files matching
+the given \fIglob\fP pattern from the tar archive associated with the
+\fITAR\fP handle \fIt\fP into the path named by the \fIprefix\fP argument.
+
+The \fBtar_append_tree\fP() function appends all files from the
+directory tree named by \fIrealdir\fP to the tar archive associated with
+the \fITAR\fP handle \fIt\fP.  The pathnames stored in the tar archive
+are modified by replacing \fIrealdir\fP with \fIsavedir\fP, so that the
+files will be extracted into \fIsavedir\fP.
+.SH RETURN VALUES
+On successful completion, these functions will return 0.  On failure,
+they will return -1 and set \fIerrno\fP to an appropriate value.
+.SH ERRORS
+These functions will fail under the same conditions that the
+\fBtar_skip_regfile\fP(), \fBtar_extract_regfile\fP(), \fBopendir\fP(),
+\fBlstat\fP(), or \fBtar_append_file\fP() functions fail.
+.SH SEE ALSO
+.BR opendir (2),
+.BR lstat (2),
+.BR tar_skip_regfile (3),
+.BR tar_extract_regfile (3),
+.BR tar_append_file (3)

data/ext/libtar/doc/tar_extract_file.3

@@ -0,0 +1,84 @@
+.TH tar_extract_file 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+tar_extract_file, tar_extract_regfile, tar_extract_hardlink,
+tar_extract_symlink, tar_extract_chardev, tar_extract_blockdev,
+tar_extract_dir, tar_extract_fifo, tar_skip_regfile, tar_set_file_perms \-
+extract files from a tar archive
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "int tar_extract_file(TAR *" t ", char *" realname ");"
+
+.BI "int tar_extract_regfile(TAR *" t ", char *" realname ");"
+
+.BI "int tar_skip_regfile(TAR *" t ");"
+
+.BI "int tar_extract_dir(TAR *" t ", char *" realname ");"
+
+.BI "int tar_extract_hardlink(TAR *" t ", char *" realname ");"
+
+.BI "int tar_extract_symlink(TAR *" t ", char *" realname ");"
+
+.BI "int tar_extract_blockdev(TAR *" t ", char *" realname ");"
+
+.BI "int tar_extract_chardev(TAR *" t ", char *" realname ");"
+
+.BI "int tar_extract_fifo(TAR *" t ", char *" realname ");"
+
+.BI "int tar_set_file_perms(TAR *" t ", char *" realname ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBtar_extract_file\fP() function acts as a front-end to the other
+\fBtar_extract_*\fP() functions.  It checks the current tar header
+associated with the \fITAR\fP handle \fIt\fP (which must be initialized
+first by calling \fBth_read\fP()) to determine what kind of file the
+header refers to.  It then calls the appropriate \fBtar_extract_*\fP()
+function to extract that kind of file.
+
+The \fBtar_skip_regfile\fP() function skips over the
+file content blocks and positions the file pointer at the expected
+location of the next tar header block.
+
+The \fBtar_set_file_perms\fP() function sets the attributes of the
+extracted file to match the encoded values.  This includes the file's
+modification time, mode, owner, and group.  This function is automatically
+called by \fBtar_extract_file\fP(), but applications which call the
+other \fBtar_extract_*\fP() functions directly will need to call
+\fBtar_set_file_perms\fP() manually if this behavior is desired.
+.SH RETURN VALUES
+On successful completion, the functions documented here will
+return 0.  On failure, they will return -1 and set \fIerrno\fP to an
+appropriate value.
+
+The \fBtar_extract_dir\fP() function will return 1 if the directory
+already exists.
+.SH ERRORS
+The \fBtar_extract_file\fP() function will fail if:
+.IP \fBEEXIST\fP
+If the \fBO_NOOVERWRITE\fP flag is set and the file already exists.
+.PP
+The \fBtar_extract_*\fP() functions will fail if:
+.IP \fBEINVAL\fP
+An entry could not be added to the internal file hash.
+.IP \fBEINVAL\fP
+Less than \fBT_BLOCKSIZE\fP bytes were read from the tar archive.
+.IP \fBEINVAL\fP
+The current file header associated with \fIt\fP refers to a kind of file
+other than the one which the called function knows about.
+.PP
+They may also fail if any of the following functions fail: \fBmkdir\fP(),
+\fBwrite\fP(), \fBlink\fP(), \fBsymlink\fP(), \fBmknod\fP(), \fBmkfifo\fP(),
+\fButime\fP(), \fBchown\fP(), \fBlchown\fP(), \fBchmod\fP(), or \fBlstat\fP().
+.SH SEE ALSO
+.BR mkdir (2),
+.BR write (2),
+.BR link (2),
+.BR symlink (2),
+.BR mknod (2),
+.BR mkfifo (2),
+.BR utime (2),
+.BR chown (2),
+.BR lchown (2),
+.BR chmod (2),
+.BR lstat (2)

data/ext/libtar/doc/tar_open.3

@@ -0,0 +1,97 @@
+.TH tar_open 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+tar_open, tar_close \- access a tar archive via a handle
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "int tar_open(TAR **" t ", char *" pathname ","
+.BI "tartype_t *" type ", int " oflags ","
+.BI "int " mode ", int " options ");"
+
+.BI "int tar_fdopen(TAR **" t ", int " fd ","
+.BI "char *" pathname ", tartype_t *" type ","
+.BI "int " oflags ", int " mode ","
+.BI "int " options ");"
+
+.BI "int tar_fd(TAR *" t");"
+
+.BI "int tar_close(TAR *" t");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBtar_open\fP() function opens a tar archive file corresponding to
+the filename named by the \fIpathname\fP argument.  The \fIoflags\fP
+argument must be either \fBO_RDONLY\fP or \fBO_WRONLY\fP.
+
+The \fItype\fP argument specifies the access methods for the given file
+type.  The \fItartype_t\fP structure has members named \fIopenfunc\fP,
+\fIclosefunc\fP, \fIreadfunc\fP() and \fIwritefunc\fP(), which are
+pointers to the functions for opening, closing, reading, and writing
+the file, respectively.  If \fItype\fP is \fINULL\fP, the file type
+defaults to a normal file, and the standard \fIopen\fP(), \fIclose\fP(),
+\fIread\fP(), and \fIwrite\fP() functions are used.
+
+The \fIoptions\fP argument is a logical-or'ed combination of zero or more
+of the following:
+.IP \fBTAR_GNU\fP
+Use GNU extensions.
+.IP \fBTAR_VERBOSE\fP
+Send status messages to \fIstdout\fP.
+.IP \fBTAR_NOOVERWRITE\fP
+Do not overwrite pre-existing files.
+.IP \fBTAR_IGNORE_EOT\fP
+Skip all-zero blocks instead of treating them as EOT.
+.IP \fBTAR_IGNORE_MAGIC\fP
+Do not validate the magic field in file headers.
+.IP \fBTAR_CHECK_VERSION\fP
+Check the version field in file headers.  (This field is normally ignored.)
+.IP \fBTAR_IGNORE_CRC\fP
+Do not validate the CRC of file headers.
+.PP
+
+The \fBtar_open\fP() function allocates memory for a \fITAR\fP handle,
+and a pointer to the allocated memory is saved in the location specified
+by \fIt\fP.  The \fITAR\fP handle may be passed to other \fIlibtar\fP
+calls to modify the opened tar archive.  The \fITAR\fP handle maintains
+all of the information about the open tar archive, including the archive
+\fItype\fP, \fIoptions\fP, and \fIoflags\fP selected when \fBtar_open\fP()
+was called.
+
+The \fITAR\fP handle generated by \fBtar_open\fP() contains a file header
+structure.  When reading a tar archive, this structure contains the last
+file header read from the tar archive.  When writing a tar archive,
+this structure is used as a staging area to construct the next file
+header to be written to the archive.  In addition, the \fITAR\fP handle
+contains a hash table which is used to keep track of the device and
+inode information for each file which gets written to the tar archive.
+This is used to detect hard links, so that files do not need to be
+duplicated in the archive.
+
+The \fBtar_fdopen\fP() function is identical to the \fBtar_open\fP() function,
+except that \fIfd\fP is used as the previously-opened file descriptor for
+the tar file instead of calling \fItype->openfunc\fP() to open the file.
+
+The \fBtar_fd\fP() function returns the file descriptor associated with
+the \fITAR\fP handle \fIt\fP.
+
+The \fBtar_close\fP() function closes the file descriptor associated
+with the \fITAR\fP handle \fIt\fP and frees all dynamically-allocated
+memory.
+.SH RETURN VALUE
+The \fBtar_open\fP(), \fBtar_fdopen\fP(), and \fBtar_close\fP() functions
+return 0 on success.  On failure, they return -1 and set \fIerrno\fP.
+
+The \fBtar_fd\fP() function returns the file descriptor associated with
+the \fITAR\fP handle \fIt\fP.
+.SH ERRORS
+\fBtar_open\fP() will fail if:
+.IP \fBEINVAL\fP
+The \fIoflags\fP argument was something other than \fBO_RDONLY\fP or \fBO_WRONLY\fP.
+.PP
+In addition, \fBtar_open\fP() and \fBtar_close\fP() may fail if it
+cannot allocate memory using \fBcalloc\fP(), or if the
+open or close functions for the specified tar archive \fItype\fP fail.
+.SH SEE ALSO
+.BR open (2),
+.BR close (2),
+.BR calloc (3)

data/ext/libtar/doc/th_get_pathname.3

@@ -0,0 +1,63 @@
+.TH th_get_pathname 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+th_get_pathname, th_get_uid, th_get_gid, th_get_mode, th_get_crc, th_get_size, th_get_mtime, th_get_devmajor, th_get_devminor, th_get_linkname \- extract individual fields of a tar header
+
+TH_ISREG, TH_ISLNK, TH_ISSYM, TH_ISCHR, TH_ISBLK, TH_ISDIR, TH_ISFIFO \- determine what kind of file a tar header refers to
+
+TH_ISLONGNAME, TH_ISLONGLINK \- determine whether the GNU extensions are in use
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "char *th_get_linkname(TAR *" t ");"
+
+.BI "char *th_get_pathname(TAR *" t ");"
+
+.BI "mode_t th_get_mode(TAR *" t ");"
+
+.BI "uid_t th_get_uid(TAR *" t ");"
+
+.BI "gid_t th_get_gid(TAR *" t ");"
+
+.BI "int th_get_crc(TAR *" t ");"
+
+.BI "off_t th_get_size(TAR *" t ");"
+
+.BI "time_t th_get_mtime(TAR *" t ");"
+
+.BI "major_t th_get_devmajor(TAR *" t ");"
+
+.BI "minor_t th_get_devminor(TAR *" t ");"
+
+.BI "int TH_ISREG(TAR *" t ");"
+
+.BI "int TH_ISLNK(TAR *" t ");"
+
+.BI "int TH_ISSYM(TAR *" t ");"
+
+.BI "int TH_ISCHR(TAR *" t ");"
+
+.BI "int TH_ISBLK(TAR *" t ");"
+
+.BI "int TH_ISDIR(TAR *" t ");"
+
+.BI "int TH_ISFIFO(TAR *" t ");"
+
+.BI "int TH_ISLONGNAME(TAR *" t ");"
+
+.BI "int TH_ISLONGLINK(TAR *" t ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBth_get_*\fP() functions extract individual fields from the current
+tar header associated with the \fITAR\fP handle \fIt\fP.
+
+The \fBTH_IS*\fP() macros are used to evaluate what kind of file is
+pointed to by the current tar header associated with the \fITAR\fP
+handle \fIt\fP.
+
+The \fBTH_ISLONGNAME\fP() and \fBTH_ISLONGLINK\fP() macros evaluate
+whether or not the GNU extensions are used by the current tar header
+associated with the \fITAR\fP handle \fIt\fP.  This is only relevant
+if the \fBTAR_GNU\fP option was used when \fItar_open\fP() was called.
+.SH SEE ALSO
+.BR tar_open (3)

data/ext/libtar/doc/th_print_long_ls.3

@@ -0,0 +1,22 @@
+.TH th_print_long_ls 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+th_print, th_print_long_ls \- print out information about a tar file header
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "void th_print_long_ls(TAR *" t ");"
+
+.BI "void th_print(TAR *" t ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBth_print_long_ls\fP() function prints a line to \fIstdout\fP which
+describes the file pointed to by the current file header associated with
+the \fITAR\fP handle \fIt\fP.  The output is similar to that of "ls -l".
+
+The \fBth_print\fP() function prints the value of each field of the
+current file header associated with the \fITAR\fP handle \fIt\fP to
+\fIstdout\fP.  This is mainly used for debugging purposes.
+.SH SEE ALSO
+.BR tar_open (3),
+.BR th_read (3)

data/ext/libtar/doc/th_read.3

@@ -0,0 +1,34 @@
+.TH th_read 3 "Jan 2001" "University of Illinois" "C Library Calls"
+.SH NAME
+th_read, th_write \- read and write a file header block from a tar archive
+.SH SYNOPSIS
+.B #include <libtar.h>
+.P
+.BI "int th_read(TAR *" t ");"
+
+.BI "int th_write(TAR *" t ");"
+.SH VERSION
+This man page documents version 1.2 of \fBlibtar\fP.
+.SH DESCRIPTION
+The \fBth_read\fP() function reads the next block from the tar archive
+associated with the \fITAR\fP handle \fIt\fP.  It then sets the
+current tar header associated with \fIt\fP to the contents of the block
+read.
+
+The \fBth_write\fP() function writes the contents of the current
+tar header associated with \fIt\fP to the tar archive associated
+with \fIt\fP.
+.SH RETURN VALUE
+On successful completion, \fBth_read\fP() and \fBth_write\fP() will
+return 0.  On failure, they will return -1 and set \fIerrno\fP to an
+appropriate value.
+
+On \fIEOF\fP, \fBth_read\fP() will return 1.
+.SH ERRORS
+\fBth_read\fP() and \fBth_write\fP() will fail if:
+.IP \fBEINVAL\fP
+Less than \fBT_BLOCKSIZE\fP blocks were read or written.
+.PP
+.SH SEE ALSO
+.BR tar_block_read (3),
+.BR tar_block_write (3)