* Copyright (c) 1992 Keith Muller.
* Copyright (c) 1992, 1993
* The Regents of the University of California. All rights reserved.
* This code is derived from software contributed to Berkeley by
* Keith Muller of the University of California, San Diego.
* %sccs.include.redist.c%
static char copyright
[] =
"@(#) Copyright (c) 1992, 1993\n\
The Regents of the University of California. All rights reserved.\n";
static char sccsid
[] = "@(#)pax.c 8.2 (Berkeley) %G%";
#include <sys/resource.h>
static int gen_init
__P((void));
* PAX main routines, general globals and some simple start up routines
* Variables that can be accessed by any routine within pax
int act
= DEFOP
; /* read/write/append/copy */
FSUB
*frmt
= NULL
; /* archive format type */
int cflag
; /* match all EXCEPT pattern/file */
int dflag
; /* directory member match only */
int iflag
; /* interactive file/archive rename */
int kflag
; /* do not overwrite existing files */
int lflag
; /* use hard links when possible */
int nflag
; /* select first archive member match */
int tflag
; /* restore access time after read */
int uflag
; /* ignore older modification time files */
int vflag
; /* produce verbose output */
int Dflag
; /* same as uflag except inode change time */
int Hflag
; /* follow command line symlinks (write only) */
int Lflag
; /* follow symlinks when writing */
int Xflag
; /* archive files with same device id only */
int Yflag
; /* same as Dflg except after name mode */
int Zflag
; /* same as uflg except after name mode */
int vfpart
; /* is partial verbose output in progress */
int patime
= 1; /* preserve file access time */
int pmtime
= 1; /* preserve file modification times */
int pmode
; /* preserve file mode bits */
int pids
; /* preserve file uid/gid */
int exit_val
; /* exit value */
int docrc
; /* check/create file crc */
char *dirptr
; /* destination dir in a copy */
char *ltmfrmt
; /* -v locale time format (if any) */
char *argv0
; /* root of argv[0] */
sigset_t s_mask
; /* signal mask for cleanup critical sect */
* PAX - Portable Archive Interchange
* A utility to read, write, and write lists of the members of archive
* files and copy directory hierarchies. A variety of archive formats
* are supported (some are described in POSIX 1003.1 10.1):
* ustar - 10.1.1 extended tar interchange format
* cpio - 10.1.2 extended cpio interchange format
* tar - old BSD 4.3 tar format
* binary cpio - old cpio with binary header format
* sysVR4 cpio - with and without CRC
* This version is a superset of IEEE Std 1003.2b-d3
* Summary of Extensions to the IEEE Standard:
* 1.1 Operations which read archives will continue to operate even when
* processing archives which may be damaged, truncated, or fail to meet
* format specs in several different ways. Damaged sections of archives
* are detected and avoided if possible. Attempts will be made to resync
* archive read operations even with badly damaged media.
* 1.2 Blocksize requirements are not strictly enforced on archive read.
* Tapes which have variable sized records can be read without errors.
* 1.3 The user can specify via the non-standard option flag -E if error
* resync operation should stop on a media error, try a specified number
* of times to correct, or try to correct forever.
* 1.4 Sparse files (lseek holes) stored on the archive (but stored with blocks
* of all zeros will be restored with holes appropriate for the target
* 1.5 The user is notified whenever something is found during archive
* read operations which violates spec (but the read will continue).
* 1.6 Multiple archive volumes can be read and may span over different
* 1.7 Rigidly restores all file attributes exactly as they are stored on the
* 1.8 Modification change time ranges can be specified via multiple -T
* options. These allow a user to select files whose modification time
* lies within a specific time range.
* 1.9 Files can be selected based on owner (user name or uid) via one or more
* 1.10 Files can be selected based on group (group name or gid) via one o
* 1.11 File modification time can be checked against exisiting file after
* 2.1 Write operation will stop instead of allowing a user to create a flawed
* flawed archive (due to any problem).
* 2.2 Archives writtens by pax are forced to strictly conform to both the
* archive and pax the spceific format specifications.
* 2.3 Blocking size and format is rigidly enforced on writes.
* 2.4 Formats which may exhibit header overflow problems (they have fields
* too small for large file systems, such as inode number storage), use
* routines designed to repair this problem. These techniques still
* conform to both pax and format specifications, but no longer truncate
* these fields. This removes any restrictions on using these archive
* formats on large file systems.
* 2.5 Multiple archive volumes can be written and may span over different
* 2.6 A archive volume record limit allows the user to specify the number
* of bytes stored on an archive volume. When reached the user is
* prompted for the next archive volume. This is specified with the
* non-standard -B flag. THe limit is rounded up to the next blocksize.
* 2.7 All archive padding during write use zero filled sections. This makes
* it much easier to pull data out of flawed archive during read
* 2.8 Access time reset with the -t applies to all file nodes (including
* 2.9 Symbolic links can be followed with -L (optional in the spec).
* 2.10 Modification or inode change time ranges can be specified via
* multiple -T options. These allow a user to select files whose
* modification or inode change time lies within a specific time range.
* 2.11 Files can be selected based on owner (user name or uid) via one or more
* 2.12 Files can be selected based on group (group name or gid) via one o
* 2.13 Symlinks which appear on the command line can be followed (without
* following other symlinks; -H flag)
* 3.1 Sparse files (lseek holes) can be copied without expanding the holes
* into zero filled blocks. The file copy is created with holes which are
* appropriate for the target filesystem
* 3.2 Access time as well as modification time on copied file trees can be
* preserved with the appropriate -p options.
* 3.3 Access time reset with the -t applies to all file nodes (including
* 3.4 Symbolic links can be followed with -L (optional in the spec).
* 3.5 Modification or inode change time ranges can be specified via
* multiple -T options. These allow a user to select files whose
* modification or inode change time lies within a specific time range.
* 3.6 Files can be selected based on owner (user name or uid) via one or more
* 3.7 Files can be selected based on group (group name or gid) via one o
* 3.8 Symlinks which appear on the command line can be followed (without
* following other symlinks; -H flag)
* 3.9 File inode change time can be checked against exisiting file before
* 3.10 File inode change time can be checked against exisiting file after
* 3.11 File modification time can be checked against exisiting file after
* 4.1 Internal structure is designed to isolate format dependent and
* independent functions. Formats are selected via a format driver table.
* This encourages the addition of new archive formats by only having to
* write those routines which id, read and write the archive header.
* parse options, set up and operate as specified by the user.
* any operational flaw will set exit_val to non-zero
* Return: 0 if ok, 1 otherwise
main(int argc
, char **argv
)
* parse options, determine operational mode, general init
if ((gen_init() < 0) || (tty_init() < 0))
* select a primary operation mode
* when interrupted we try to do whatever delayed processing we can.
* This is not critical, but we really ought to limit our damage when we
* are aborted by the user.
sig_cleanup(int which_sig
)
* restore modes and times for any dirs we may have created
* or any dirs we may have read. Set vflag and vfpart so the user
* will clearly see the message on a line by itself.
if (which_sig
== SIGXCPU
)
warn(0, "Cpu time limit reached, cleaning up.");
warn(0, "Signal caught, cleaning up.");
* general setup routines. Not all are required, but they really help
* when dealing with a medium to large sized archives.
* Really needed to handle large archives. We can run out of memory for
* internal tables really fast when we have a whole lot of files...
if (getrlimit(RLIMIT_DATA
, &reslimit
) == 0){
reslimit
.rlim_cur
= reslimit
.rlim_max
;
(void)setrlimit(RLIMIT_DATA
, &reslimit
);
* should file size limits be waived? if the os limits us, this is
* needed if we want to write a large archive
if (getrlimit(RLIMIT_FSIZE
, &reslimit
) == 0){
reslimit
.rlim_cur
= reslimit
.rlim_max
;
(void)setrlimit(RLIMIT_FSIZE
, &reslimit
);
* increase the size the stack can grow to
if (getrlimit(RLIMIT_STACK
, &reslimit
) == 0){
reslimit
.rlim_cur
= reslimit
.rlim_max
;
(void)setrlimit(RLIMIT_STACK
, &reslimit
);
* not really needed, but doesn't hurt
if (getrlimit(RLIMIT_RSS
, &reslimit
) == 0){
reslimit
.rlim_cur
= reslimit
.rlim_max
;
(void)setrlimit(RLIMIT_RSS
, &reslimit
);
* set user defines time printing format for -v option
ltmfrmt
= getenv("LC_TIME");
* signal handling to reset stored directory times and modes. Since
* we deal with broken pipes via failed writes we ignore it. We also
* deal with any file size limit thorugh failed writes. Cpu time
* limits are caught and a cleanup is forced.
if ((sigemptyset(&s_mask
) < 0) || (sigaddset(&s_mask
, SIGTERM
) < 0) ||
(sigaddset(&s_mask
,SIGINT
) < 0)||(sigaddset(&s_mask
,SIGHUP
) < 0) ||
(sigaddset(&s_mask
,SIGPIPE
) < 0)||(sigaddset(&s_mask
,SIGQUIT
)<0) ||
(sigaddset(&s_mask
,SIGXCPU
) < 0)||(sigaddset(&s_mask
,SIGXFSZ
)<0)) {
warn(1, "Unable to set up signal mask");
n_hand
.sa_handler
= sig_cleanup
;
if ((sigaction(SIGHUP
, &n_hand
, &o_hand
) < 0) &&
(o_hand
.sa_handler
== SIG_IGN
) &&
(sigaction(SIGHUP
, &o_hand
, &o_hand
) < 0))
if ((sigaction(SIGTERM
, &n_hand
, &o_hand
) < 0) &&
(o_hand
.sa_handler
== SIG_IGN
) &&
(sigaction(SIGTERM
, &o_hand
, &o_hand
) < 0))
if ((sigaction(SIGINT
, &n_hand
, &o_hand
) < 0) &&
(o_hand
.sa_handler
== SIG_IGN
) &&
(sigaction(SIGINT
, &o_hand
, &o_hand
) < 0))
if ((sigaction(SIGQUIT
, &n_hand
, &o_hand
) < 0) &&
(o_hand
.sa_handler
== SIG_IGN
) &&
(sigaction(SIGQUIT
, &o_hand
, &o_hand
) < 0))
if ((sigaction(SIGXCPU
, &n_hand
, &o_hand
) < 0) &&
(o_hand
.sa_handler
== SIG_IGN
) &&
(sigaction(SIGXCPU
, &o_hand
, &o_hand
) < 0))
n_hand
.sa_handler
= SIG_IGN
;
if ((sigaction(SIGPIPE
, &n_hand
, &o_hand
) < 0) ||
(sigaction(SIGXFSZ
, &n_hand
, &o_hand
) < 0))
syswarn(1, errno
, "Unable to set up signal handler");