Home | History | Annotate | Line # | Download | only in pax
pax.c revision 1.6
      1 /*	$NetBSD: pax.c,v 1.6 1997/07/20 20:32:40 christos Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1992 Keith Muller.
      5  * Copyright (c) 1992, 1993
      6  *	The Regents of the University of California.  All rights reserved.
      7  *
      8  * This code is derived from software contributed to Berkeley by
      9  * Keith Muller of the University of California, San Diego.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, this list of conditions and the following disclaimer.
     16  * 2. Redistributions in binary form must reproduce the above copyright
     17  *    notice, this list of conditions and the following disclaimer in the
     18  *    documentation and/or other materials provided with the distribution.
     19  * 3. All advertising materials mentioning features or use of this software
     20  *    must display the following acknowledgement:
     21  *	This product includes software developed by the University of
     22  *	California, Berkeley and its contributors.
     23  * 4. Neither the name of the University nor the names of its contributors
     24  *    may be used to endorse or promote products derived from this software
     25  *    without specific prior written permission.
     26  *
     27  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     28  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     29  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     30  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     31  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     32  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     33  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     34  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     35  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     36  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     37  * SUCH DAMAGE.
     38  */
     39 
     40 #include <sys/cdefs.h>
     41 #ifndef lint
     42 __COPYRIGHT("@(#) Copyright (c) 1992, 1993\n\
     43 	The Regents of the University of California.  All rights reserved.\n");
     44 #endif /* not lint */
     45 
     46 #ifndef lint
     47 #if 0
     48 static char sccsid[] = "@(#)pax.c	8.2 (Berkeley) 4/18/94";
     49 #else
     50 __RCSID("$NetBSD: pax.c,v 1.6 1997/07/20 20:32:40 christos Exp $");
     51 #endif
     52 #endif /* not lint */
     53 
     54 #include <stdio.h>
     55 #include <sys/types.h>
     56 #include <sys/param.h>
     57 #include <sys/stat.h>
     58 #include <sys/time.h>
     59 #include <sys/resource.h>
     60 #include <signal.h>
     61 #include <unistd.h>
     62 #include <stdlib.h>
     63 #include <errno.h>
     64 #include "pax.h"
     65 #include "extern.h"
     66 static int gen_init __P((void));
     67 
     68 /*
     69  * PAX main routines, general globals and some simple start up routines
     70  */
     71 
     72 /*
     73  * Variables that can be accessed by any routine within pax
     74  */
     75 int	act = DEFOP;		/* read/write/append/copy */
     76 FSUB	*frmt = NULL;		/* archive format type */
     77 int	cflag;			/* match all EXCEPT pattern/file */
     78 int	dflag;			/* directory member match only  */
     79 int	iflag;			/* interactive file/archive rename */
     80 int	kflag;			/* do not overwrite existing files */
     81 int	lflag;			/* use hard links when possible */
     82 int	nflag;			/* select first archive member match */
     83 int	tflag;			/* restore access time after read */
     84 int	uflag;			/* ignore older modification time files */
     85 int	vflag;			/* produce verbose output */
     86 int	zflag;			/* use gzip */
     87 int	Dflag;			/* same as uflag except inode change time */
     88 int	Hflag;			/* follow command line symlinks (write only) */
     89 int	Lflag;			/* follow symlinks when writing */
     90 int	Xflag;			/* archive files with same device id only */
     91 int	Yflag;			/* same as Dflg except after name mode */
     92 int	Zflag;			/* same as uflg except after name mode */
     93 int	vfpart;			/* is partial verbose output in progress */
     94 int	patime = 1;		/* preserve file access time */
     95 int	pmtime = 1;		/* preserve file modification times */
     96 int	pmode;			/* preserve file mode bits */
     97 int	pids;			/* preserve file uid/gid */
     98 int	exit_val;		/* exit value */
     99 int	docrc;			/* check/create file crc */
    100 char	*dirptr;		/* destination dir in a copy */
    101 char	*ltmfrmt;		/* -v locale time format (if any) */
    102 char	*argv0;			/* root of argv[0] */
    103 sigset_t s_mask;		/* signal mask for cleanup critical sect */
    104 
    105 /*
    106  *	PAX - Portable Archive Interchange
    107  *
    108  * 	A utility to read, write, and write lists of the members of archive
    109  *	files and copy directory hierarchies. A variety of archive formats
    110  *	are supported (some are described in POSIX 1003.1 10.1):
    111  *
    112  *		ustar - 10.1.1 extended tar interchange format
    113  *		cpio  - 10.1.2 extended cpio interchange format
    114  *		tar - old BSD 4.3 tar format
    115  *		binary cpio - old cpio with binary header format
    116  *		sysVR4 cpio -  with and without CRC
    117  *
    118  * This version is a superset of IEEE Std 1003.2b-d3
    119  *
    120  * Summary of Extensions to the IEEE Standard:
    121  *
    122  * 1	READ ENHANCEMENTS
    123  * 1.1	Operations which read archives will continue to operate even when
    124  *	processing archives which may be damaged, truncated, or fail to meet
    125  *	format specs in several different ways. Damaged sections of archives
    126  *	are detected and avoided if possible. Attempts will be made to resync
    127  *	archive read operations even with badly damaged media.
    128  * 1.2	Blocksize requirements are not strictly enforced on archive read.
    129  *	Tapes which have variable sized records can be read without errors.
    130  * 1.3	The user can specify via the non-standard option flag -E if error
    131  *	resync operation should stop on a media error, try a specified number
    132  *	of times to correct, or try to correct forever.
    133  * 1.4	Sparse files (lseek holes) stored on the archive (but stored with blocks
    134  *	of all zeros will be restored with holes appropriate for the target
    135  *	filesystem
    136  * 1.5	The user is notified whenever something is found during archive
    137  *	read operations which violates spec (but the read will continue).
    138  * 1.6	Multiple archive volumes can be read and may span over different
    139  *	archive devices
    140  * 1.7	Rigidly restores all file attributes exactly as they are stored on the
    141  *	archive.
    142  * 1.8	Modification change time ranges can be specified via multiple -T
    143  *	options. These allow a user to select files whose modification time
    144  *	lies within a specific time range.
    145  * 1.9	Files can be selected based on owner (user name or uid) via one or more
    146  *	-U options.
    147  * 1.10	Files can be selected based on group (group name or gid) via one o
    148  *	more -G options.
    149  * 1.11	File modification time can be checked against exisiting file after
    150  *	name modification (-Z)
    151  *
    152  * 2	WRITE ENHANCEMENTS
    153  * 2.1	Write operation will stop instead of allowing a user to create a flawed
    154  *	flawed archive (due to any problem).
    155  * 2.2	Archives writtens by pax are forced to strictly conform to both the
    156  *	archive and pax the spceific format specifications.
    157  * 2.3	Blocking size and format is rigidly enforced on writes.
    158  * 2.4	Formats which may exhibit header overflow problems (they have fields
    159  *	too small for large file systems, such as inode number storage), use
    160  *	routines designed to repair this problem. These techniques still
    161  *	conform to both pax and format specifications, but no longer truncate
    162  *	these fields. This removes any restrictions on using these archive
    163  *	formats on large file systems.
    164  * 2.5	Multiple archive volumes can be written and may span over different
    165  *	archive devices
    166  * 2.6	A archive volume record limit allows the user to specify the number
    167  *	of bytes stored on an archive volume. When reached the user is
    168  *	prompted for the next archive volume. This is specified with the
    169  *	non-standard -B flag. THe limit is rounded up to the next blocksize.
    170  * 2.7	All archive padding during write use zero filled sections. This makes
    171  *	it much easier to pull data out of flawed archive during read
    172  *	operations.
    173  * 2.8	Access time reset with the -t applies to all file nodes (including
    174  *	directories).
    175  * 2.9	Symbolic links can be followed with -L (optional in the spec).
    176  * 2.10	Modification or inode change time ranges can be specified via
    177  *	multiple -T options. These allow a user to select files whose
    178  *	modification or inode change time lies within a specific time range.
    179  * 2.11	Files can be selected based on owner (user name or uid) via one or more
    180  *	-U options.
    181  * 2.12	Files can be selected based on group (group name or gid) via one o
    182  *	more -G options.
    183  * 2.13	Symlinks which appear on the command line can be followed (without
    184  *	following other symlinks; -H flag)
    185  *
    186  * 3	COPY ENHANCEMENTS
    187  * 3.1	Sparse files (lseek holes) can be copied without expanding the holes
    188  *	into zero filled blocks. The file copy is created with holes which are
    189  *	appropriate for the target filesystem
    190  * 3.2	Access time as well as modification time on copied file trees can be
    191  *	preserved with the appropriate -p options.
    192  * 3.3	Access time reset with the -t applies to all file nodes (including
    193  *	directories).
    194  * 3.4	Symbolic links can be followed with -L (optional in the spec).
    195  * 3.5	Modification or inode change time ranges can be specified via
    196  *	multiple -T options. These allow a user to select files whose
    197  *	modification or inode change time lies within a specific time range.
    198  * 3.6	Files can be selected based on owner (user name or uid) via one or more
    199  *	-U options.
    200  * 3.7	Files can be selected based on group (group name or gid) via one o
    201  *	more -G options.
    202  * 3.8	Symlinks which appear on the command line can be followed (without
    203  *	following other symlinks; -H flag)
    204  * 3.9  File inode change time can be checked against exisiting file before
    205  *	name modification (-D)
    206  * 3.10 File inode change time can be checked against exisiting file after
    207  *	name modification (-Y)
    208  * 3.11	File modification time can be checked against exisiting file after
    209  *	name modification (-Z)
    210  *
    211  * 4	GENERAL ENHANCEMENTS
    212  * 4.1	Internal structure is designed to isolate format dependent and
    213  *	independent functions. Formats are selected via a format driver table.
    214  *	This encourages the addition of new archive formats by only having to
    215  *	write those routines which id, read and write the archive header.
    216  */
    217 
    218 /*
    219  * main()
    220  *	parse options, set up and operate as specified by the user.
    221  *	any operational flaw will set exit_val to non-zero
    222  * Return: 0 if ok, 1 otherwise
    223  */
    224 
    225 #if __STDC__
    226 int
    227 main(int argc, char **argv)
    228 #else
    229 int
    230 main(argc, argv)
    231 	int argc;
    232 	char **argv;
    233 #endif
    234 {
    235 	/*
    236 	 * parse options, determine operational mode, general init
    237 	 */
    238 	options(argc, argv);
    239         if ((gen_init() < 0) || (tty_init() < 0))
    240 		return(exit_val);
    241 
    242 	/*
    243 	 * select a primary operation mode
    244 	 */
    245 	switch(act) {
    246 	case EXTRACT:
    247 		extract();
    248 		break;
    249 	case ARCHIVE:
    250 		archive();
    251 		break;
    252 	case APPND:
    253 		append();
    254 		break;
    255 	case COPY:
    256 		copy();
    257 		break;
    258 	default:
    259 	case LIST:
    260 		list();
    261 		break;
    262 	}
    263 	return(exit_val);
    264 }
    265 
    266 /*
    267  * sig_cleanup()
    268  *	when interrupted we try to do whatever delayed processing we can.
    269  *	This is not critical, but we really ought to limit our damage when we
    270  *	are aborted by the user.
    271  * Return:
    272  *	never....
    273  */
    274 
    275 #if __STDC__
    276 void
    277 sig_cleanup(int which_sig)
    278 #else
    279 void
    280 sig_cleanup(which_sig)
    281 	int which_sig;
    282 #endif
    283 {
    284 	/*
    285 	 * restore modes and times for any dirs we may have created
    286 	 * or any dirs we may have read. Set vflag and vfpart so the user
    287 	 * will clearly see the message on a line by itself.
    288 	 */
    289 	vflag = vfpart = 1;
    290 	if (which_sig == SIGXCPU)
    291 		tty_warn(0, "Cpu time limit reached, cleaning up.");
    292 	else
    293 		tty_warn(0, "Signal caught, cleaning up.");
    294 
    295 	ar_close();
    296 	proc_dir();
    297 	if (tflag)
    298 		atdir_end();
    299 	exit(1);
    300 }
    301 
    302 /*
    303  * gen_init()
    304  *	general setup routines. Not all are required, but they really help
    305  *	when dealing with a medium to large sized archives.
    306  */
    307 
    308 #if __STDC__
    309 static int
    310 gen_init(void)
    311 #else
    312 static int
    313 gen_init()
    314 #endif
    315 {
    316 	struct rlimit reslimit;
    317 	struct sigaction n_hand;
    318 	struct sigaction o_hand;
    319 
    320 	/*
    321 	 * Really needed to handle large archives. We can run out of memory for
    322 	 * internal tables really fast when we have a whole lot of files...
    323 	 */
    324 	if (getrlimit(RLIMIT_DATA , &reslimit) == 0){
    325 		reslimit.rlim_cur = reslimit.rlim_max;
    326 		(void)setrlimit(RLIMIT_DATA , &reslimit);
    327 	}
    328 
    329 	/*
    330 	 * should file size limits be waived? if the os limits us, this is
    331 	 * needed if we want to write a large archive
    332 	 */
    333 	if (getrlimit(RLIMIT_FSIZE , &reslimit) == 0){
    334 		reslimit.rlim_cur = reslimit.rlim_max;
    335 		(void)setrlimit(RLIMIT_FSIZE , &reslimit);
    336 	}
    337 
    338 	/*
    339 	 * increase the size the stack can grow to
    340 	 */
    341 	if (getrlimit(RLIMIT_STACK , &reslimit) == 0){
    342 		reslimit.rlim_cur = reslimit.rlim_max;
    343 		(void)setrlimit(RLIMIT_STACK , &reslimit);
    344 	}
    345 
    346 	/*
    347 	 * not really needed, but doesn't hurt
    348 	 */
    349 	if (getrlimit(RLIMIT_RSS , &reslimit) == 0){
    350 		reslimit.rlim_cur = reslimit.rlim_max;
    351 		(void)setrlimit(RLIMIT_RSS , &reslimit);
    352 	}
    353 
    354 	/*
    355 	 * Handle posix locale
    356 	 *
    357 	 * set user defines time printing format for -v option
    358 	 */
    359 	ltmfrmt = getenv("LC_TIME");
    360 
    361 	/*
    362 	 * signal handling to reset stored directory times and modes. Since
    363 	 * we deal with broken pipes via failed writes we ignore it. We also
    364 	 * deal with any file size limit thorugh failed writes. Cpu time
    365 	 * limits are caught and a cleanup is forced.
    366 	 */
    367 	if ((sigemptyset(&s_mask) < 0) || (sigaddset(&s_mask, SIGTERM) < 0) ||
    368 	    (sigaddset(&s_mask,SIGINT) < 0)||(sigaddset(&s_mask,SIGHUP) < 0) ||
    369 	    (sigaddset(&s_mask,SIGPIPE) < 0)||(sigaddset(&s_mask,SIGQUIT)<0) ||
    370 	    (sigaddset(&s_mask,SIGXCPU) < 0)||(sigaddset(&s_mask,SIGXFSZ)<0)) {
    371 		tty_warn(1, "Unable to set up signal mask");
    372 		return(-1);
    373 	}
    374 	n_hand.sa_mask = s_mask;
    375 	n_hand.sa_flags = 0;
    376 	n_hand.sa_handler = sig_cleanup;
    377 
    378 	if ((sigaction(SIGHUP, &n_hand, &o_hand) < 0) &&
    379 	    (o_hand.sa_handler == SIG_IGN) &&
    380 	    (sigaction(SIGHUP, &o_hand, &o_hand) < 0))
    381 		goto out;
    382 
    383 	if ((sigaction(SIGTERM, &n_hand, &o_hand) < 0) &&
    384 	    (o_hand.sa_handler == SIG_IGN) &&
    385 	    (sigaction(SIGTERM, &o_hand, &o_hand) < 0))
    386 		goto out;
    387 
    388 	if ((sigaction(SIGINT, &n_hand, &o_hand) < 0) &&
    389 	    (o_hand.sa_handler == SIG_IGN) &&
    390 	    (sigaction(SIGINT, &o_hand, &o_hand) < 0))
    391 		goto out;
    392 
    393 	if ((sigaction(SIGQUIT, &n_hand, &o_hand) < 0) &&
    394 	    (o_hand.sa_handler == SIG_IGN) &&
    395 	    (sigaction(SIGQUIT, &o_hand, &o_hand) < 0))
    396 		goto out;
    397 
    398 	if ((sigaction(SIGXCPU, &n_hand, &o_hand) < 0) &&
    399 	    (o_hand.sa_handler == SIG_IGN) &&
    400 	    (sigaction(SIGXCPU, &o_hand, &o_hand) < 0))
    401 		goto out;
    402 
    403 	n_hand.sa_handler = SIG_IGN;
    404 	if ((sigaction(SIGPIPE, &n_hand, &o_hand) < 0) ||
    405 	    (sigaction(SIGXFSZ, &n_hand, &o_hand) < 0))
    406 		goto out;
    407 	return(0);
    408 
    409     out:
    410 	syswarn(1, errno, "Unable to set up signal handler");
    411 	return(-1);
    412 }
    413