xref: /src/sbin/dump/main.c

/*	$NetBSD: main.c,v 1.79 2024/10/04 11:38:44 rillig Exp $	*/

/*-
 * Copyright (c) 1980, 1991, 1993, 1994
 *	The Regents of the University of California.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

#include <sys/cdefs.h>
#ifndef lint
__COPYRIGHT("@(#) Copyright (c) 1980, 1991, 1993, 1994\
 The Regents of the University of California.  All rights reserved.");
#endif /* not lint */

#ifndef lint
#if 0
static char sccsid[] = "@(#)main.c	8.6 (Berkeley) 5/1/95";
#else
__RCSID("$NetBSD: main.c,v 1.79 2024/10/04 11:38:44 rillig Exp $");
#endif
#endif /* not lint */

#include <sys/param.h>
#include <sys/time.h>
#include <sys/stat.h>
#include <sys/mount.h>
#include <sys/sysctl.h>

#include <ufs/ffs/fs.h>
#include <ufs/ffs/ffs_extern.h>

#include <ctype.h>
#include <err.h>
#include <errno.h>
#include <fcntl.h>
#include <fstab.h>
#include <signal.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <unistd.h>
#include <util.h>

#include "dump.h"
#include "pathnames.h"
#include "snapshot.h"

union u_spcl u_spcl;
struct ufsi *ufsib;
int	mapsize;
char	*usedinomap;
char	*dumpdirmap;
char	*dumpinomap;
char	*disk;
char	*disk_dev;
const char *tape;
const char *dumpdates;
const char *temp;
char	lastlevel;
char	level;
int	uflag;
const char *dumpdev;
int	eflag;
int	lflag;
int	diskfd;
int	tapefd;
int	pipeout;
int	trueinc;
ino_t	curino;
int	newtape;
u_int64_t	tapesize;
long	tsize;
long	asize;
int	etapes;
int	nonodump;
int	unlimited;
time_t	tstart_writing;
time_t	tstart_volume;
int	xferrate;
char	sblock_buf[MAXBSIZE];
int	dev_bshift;
int	tp_bshift;
int needswap;

int	timestamp;		/* print message timestamps */
int	notify;			/* notify operator flag */
u_int64_t	blockswritten;	/* number of blocks written on current tape */
int	tapeno;			/* current tape number */
int	density;		/* density in bytes/0.1" */
int	ntrec = NTREC;		/* # tape blocks in each tape record */
int	cartridge;		/* Assume non-cartridge tape */
long	dev_bsize = 1;		/* recalculated below */
long	blocksperfile;		/* output blocks per file */
const char *host;		/* remote host (if any) */
int	readcache = -1;		/* read cache size (in readblksize blks) */
int	readblksize = -1;	/* read block size */
char    default_time_string[] = "%T %Z"; /* default timestamp string */
char    *time_string = default_time_string; /* timestamp string */

static long numarg(const char *, long, long);
static void obsolete(int *, char **[]);
static void usage(void);

int
main(int argc, char *argv[])
{
	ino_t ino;
	int dirty;
	union dinode *dp;
	struct fstab *dt;
	struct statvfs *mntinfo, fsbuf;
	char *map, *cp;
	int ch;
	int i, anydirskipped, bflag = 0, Tflag = 0, Fflag = 0, honorlevel = 1;
	int snap_internal = 0;
	ino_t maxino;
	time_t tnow, date;
	int dirc;
	char *mountpoint;
	int just_estimate = 0;
	char labelstr[LBLSIZE];
	char buf[MAXPATHLEN], rbuf[MAXPATHLEN];
	char *new_time_format;
	char *snap_backup = NULL;

	spcl.c_date = 0;
	(void)time(&tnow);
	spcl.c_date = tnow;
	tzset(); /* set up timezone for strftime */
	if ((new_time_format = getenv("TIMEFORMAT")) != NULL)
		time_string = new_time_format;

	tsize = 0;	/* Default later, based on 'c' option for cart tapes */
	if ((tape = getenv("TAPE")) == NULL)
		tape = _PATH_DEFTAPE;
	dumpdates = _PATH_DUMPDATES;
	temp = _PATH_DTMP;
	strcpy(labelstr, "none");	/* XXX safe strcpy. */
	if (TP_BSIZE / DEV_BSIZE == 0 || TP_BSIZE % DEV_BSIZE != 0)
		quit("TP_BSIZE must be a multiple of DEV_BSIZE");
	level = '0';
	timestamp = 0;

	if (argc < 2)
		usage();

	obsolete(&argc, &argv);
	while ((ch = getopt(argc, argv,
	    "0123456789aB:b:cd:D:eFf:h:ik:l:L:nr:s:StT:uU:Wwx:X")) != -1)
		switch (ch) {
		/* dump level */
		case '0': case '1': case '2': case '3': case '4':
		case '5': case '6': case '7': case '8': case '9':
			level = ch;
			break;

		case 'a':		/* `auto-size', Write to EOM. */
			unlimited = 1;
			break;

		case 'B':		/* blocks per output file */
			blocksperfile = numarg("blocks per file", 1L, 0L);
			break;

		case 'b':		/* blocks per tape write */
			ntrec = numarg("blocks per write", 1L, 1000L);
			bflag = 1;
			break;

		case 'c':		/* Tape is cart. not 9-track */
			cartridge = 1;
			break;

		case 'd':		/* density, in bits per inch */
			density = numarg("density", 10L, 327670L) / 10;
			if (density >= 625 && !bflag)
				ntrec = HIGHDENSITYTREC;
			break;

		case 'D':		/* specify alt. dumpdates file */
			dumpdates = optarg;
			break;

		case 'e':		/* eject full tapes */
			eflag = 1;
			break;

		case 'F':		/* files-to-dump is an fs image */
			Fflag = 1;
			break;

		case 'f':		/* output file */
			tape = optarg;
			break;

		case 'h':
			honorlevel = numarg("honor level", 0L, 10L);
			break;

		case 'i':	/* "true incremental" regardless level */
			level = 'i';
			trueinc = 1;
			break;

		case 'k':
			readblksize = numarg("read block size", 0, 64) * 1024;
			break;

		case 'l':		/* autoload after eject full tapes */
			eflag = 1;
			lflag = numarg("timeout (in seconds)", 1, 0);
			break;

		case 'L':
			/*
			 * Note that although there are LBLSIZE characters,
			 * the last must be '\0', so the limit on strlen()
			 * is really LBLSIZE-1.
			 */
			if (strlcpy(labelstr, optarg, sizeof(labelstr))
			    >= sizeof(labelstr)) {
				msg(
		"WARNING Label `%s' is larger than limit of %lu characters.\n",
				    optarg,
				    (unsigned long)sizeof(labelstr) - 1);
				msg("WARNING: Using truncated label `%s'.\n",
				    labelstr);
			}
			break;
		case 'n':		/* notify operators */
			notify = 1;
			break;

		case 'r':		/* read cache size */
			readcache = numarg("read cache size", 0, 512);
			break;

		case 's':		/* tape size, feet */
			tsize = numarg("tape size", 1L, 0L) * 12 * 10;
			break;

		case 'S':		/* exit after estimating # of tapes */
			just_estimate = 1;
			break;

		case 't':
			timestamp = 1;
			break;

		case 'T':		/* time of last dump */
			spcl.c_ddate = unctime(optarg);
			if (spcl.c_ddate < 0) {
				(void)fprintf(stderr, "bad time \"%s\"\n",
				    optarg);
				exit(X_STARTUP);
			}
			Tflag = 1;
			lastlevel = '?';
			break;

		case 'u':		/* update /etc/dumpdates */
			uflag = 1;
			break;

		case 'U':		/* dump device in /etc/dumpdates */
			dumpdev = optarg;
			break;

		case 'W':		/* what to do */
		case 'w':
			lastdump(ch);
			exit(X_FINOK);	/* do nothing else */

		case 'x':
			snap_backup = optarg;
			break;

		case 'X':
			snap_internal = 1;
			break;

		default:
			usage();
		}
	argc -= optind;
	argv += optind;

	if (argc < 1) {
		(void)fprintf(stderr,
		    "Must specify disk or image, or file list\n");
		exit(X_STARTUP);
	}


	/*
	 *	determine if disk is a subdirectory, and setup appropriately
	 */
	getfstab();		/* /etc/fstab snarfed */
	disk = NULL;
	disk_dev = NULL;
	mountpoint = NULL;
	dirc = 0;
	for (i = 0; i < argc; i++) {
		struct stat sb;
		int error;

		error = lstat(argv[i], &sb);
		if (Fflag || (!error && (S_ISCHR(sb.st_mode) || S_ISBLK(sb.st_mode)))) {
			if (error)
				quite(errno, "can't stat %s", argv[i]);
			disk = argv[i];
 multicheck:
			if (dirc != 0)
				quit("can't dump a disk or image at the same"
				" time as a file list");
			break;
		}
		if ((dt = fstabsearch(argv[i])) != NULL) {
			disk = argv[i];
			mountpoint = xstrdup(dt->fs_file);
			goto multicheck;
		}
		if (statvfs(argv[i], &fsbuf) == -1)
			quite(errno, "can't statvfs %s", argv[i]);
		disk = fsbuf.f_mntfromname;
		if (strcmp(argv[i], fsbuf.f_mntonname) == 0)
			goto multicheck;
		if (mountpoint == NULL) {
			mountpoint = xstrdup(fsbuf.f_mntonname);
			if (uflag) {
				msg("Ignoring u flag for subdir dump\n");
				uflag = 0;
			}
			if (level > '0') {
				msg("Subdir dump is done at level 0\n");
				level = '0';
			}
			msg("Dumping sub files/directories from %s\n",
			    mountpoint);
		} else {
			if (strcmp(mountpoint, fsbuf.f_mntonname) != 0)
				quit("%s is not on %s", argv[i], mountpoint);
		}
		msg("Dumping file/directory %s\n", argv[i]);
		dirc++;
	}
	if (mountpoint)
		free(mountpoint);

	if (dirc == 0) {
		argv++;
		if (argc != 1) {
			(void)fprintf(stderr, "Excess arguments to dump:");
			while (--argc)
				(void)fprintf(stderr, " %s", *argv++);
			(void)fprintf(stderr, "\n");
			exit(X_STARTUP);
		}
	}
	if (Tflag && uflag) {
		(void)fprintf(stderr,
		    "You cannot use the T and u flags together.\n");
		exit(X_STARTUP);
	}
	if (strcmp(tape, "-") == 0) {
		pipeout++;
		tape = "standard output";
	}

	if (blocksperfile)
		blocksperfile = blocksperfile / ntrec * ntrec; /* round down */
	else if (!unlimited) {
		/*
		 * Determine how to default tape size and density
		 *
		 *		density				tape size
		 * 9-track	1600 bpi (160 bytes/.1")	2300 ft.
		 * 9-track	6250 bpi (625 bytes/.1")	2300 ft.
		 * cartridge	8000 bpi (100 bytes/.1")	1700 ft.
		 *						(450*4 - slop)
		 */
		if (density == 0)
			density = cartridge ? 100 : 160;
		if (tsize == 0)
			tsize = cartridge ? 1700L*120L : 2300L*120L;
	}

	/* LINTED 346 "call to 'strchr' effectively discards 'const'" */
	if ((cp = strchr(tape, ':')) != NULL) {
		host = tape;
		/* This is fine, because all the const strings don't have : */
		*cp++ = '\0';
		tape = cp;
#ifdef RDUMP
		if (rmthost(host) == 0)
			exit(X_STARTUP);
#else
		(void)fprintf(stderr, "remote dump not enabled\n");
		exit(X_STARTUP);
#endif
	}

	if (signal(SIGHUP, SIG_IGN) != SIG_IGN)
		signal(SIGHUP, sig);
	if (signal(SIGTRAP, SIG_IGN) != SIG_IGN)
		signal(SIGTRAP, sig);
	if (signal(SIGFPE, SIG_IGN) != SIG_IGN)
		signal(SIGFPE, sig);
	if (signal(SIGBUS, SIG_IGN) != SIG_IGN)
		signal(SIGBUS, sig);
#if 0
	if (signal(SIGSEGV, SIG_IGN) != SIG_IGN)
		signal(SIGSEGV, sig);
#endif
	if (signal(SIGTERM, SIG_IGN) != SIG_IGN)
		signal(SIGTERM, sig);
	if (signal(SIGINT, interrupt) == SIG_IGN)
		signal(SIGINT, SIG_IGN);

	/*
	 *	disk can be either the full special file name, or
	 *	the file system name.
	 */
	mountpoint = NULL;
	mntinfo = mntinfosearch(disk);
	if ((dt = fstabsearch(disk)) != NULL) {
		if (getfsspecname(buf, sizeof(buf), dt->fs_spec) == NULL)
			quite(errno, "can't resolve mount %s (%s)", dt->fs_spec,
			    buf);
		if (getdiskrawname(rbuf, sizeof(rbuf), buf) == NULL)
			quite(errno, "can't get disk raw name for %s", buf);
		disk = rbuf;
		mountpoint = dt->fs_file;
		msg("Found %s on %s in %s\n", disk, mountpoint, _PATH_FSTAB);
	} else if (mntinfo != NULL) {
		if (getdiskrawname(rbuf, sizeof(rbuf), mntinfo->f_mntfromname)
		    == NULL)
			quite(errno, "can't get disk raw name for %s",
			    mntinfo->f_mntfromname);
		disk = rbuf;
		mountpoint = mntinfo->f_mntonname;
		msg("Found %s on %s in mount table\n", disk, mountpoint);
	}
	if (mountpoint != NULL) {
		if (dirc != 0)
			(void)snprintf(spcl.c_filesys, sizeof(spcl.c_filesys),
			    "a subset of %s", mountpoint);
		else
			(void)strlcpy(spcl.c_filesys, mountpoint,
			    sizeof(spcl.c_filesys));
	} else if (Fflag) {
		(void)strlcpy(spcl.c_filesys, "a file system image",
		    sizeof(spcl.c_filesys));
	} else {
		(void)strlcpy(spcl.c_filesys, "an unlisted file system",
		    sizeof(spcl.c_filesys));
	}
	(void)strlcpy(spcl.c_dev, disk, sizeof(spcl.c_dev));
	(void)strlcpy(spcl.c_label, labelstr, sizeof(spcl.c_label));
	(void)gethostname(spcl.c_host, sizeof(spcl.c_host));
	spcl.c_host[sizeof(spcl.c_host) - 1] = '\0';

	if ((snap_backup != NULL || snap_internal) && mntinfo == NULL) {
		msg("WARNING: Cannot use -x or -X on unmounted file system.\n");
		snap_backup = NULL;
		snap_internal = 0;
	}

#ifdef DUMP_LFS
	sync();
	if (snap_backup != NULL || snap_internal) {
		if (lfs_wrap_stop(mountpoint) < 0) {
			msg("Cannot stop writing on %s\n", mountpoint);
			exit(X_STARTUP);
		}
	}
	if ((diskfd = open(disk, O_RDONLY)) < 0) {
		msg("Cannot open %s\n", disk);
		exit(X_STARTUP);
	}
	disk_dev = disk;
#else /* ! DUMP_LFS */
	if (snap_backup != NULL || snap_internal) {
		diskfd = snap_open(mntinfo->f_mntonname, snap_backup,
		    &tnow, &disk_dev);
		if (diskfd < 0) {
			msg("Cannot open snapshot of %s\n",
				mntinfo->f_mntonname);
			exit(X_STARTUP);
		}
		spcl.c_date = tnow;
	} else {
		if ((diskfd = open(disk, O_RDONLY)) < 0) {
			msg("Cannot open %s\n", disk);
			exit(X_STARTUP);
		}
		disk_dev = disk;
	}
	sync();
#endif /* ! DUMP_LFS */

	needswap = fs_read_sblock(sblock_buf);

	/* true incremental is always a level 10 dump */
	spcl.c_level = trueinc? iswap32(10): iswap32(level - '0');
	spcl.c_type = iswap32(TS_TAPE);
	spcl.c_date = iswap32(spcl.c_date);
	spcl.c_ddate = iswap32(spcl.c_ddate);
	if (!Tflag)
		getdumptime();		/* /etc/dumpdates snarfed */

	date = iswap32(spcl.c_date);
	msg("Date of this level %c dump: %s", level,
		spcl.c_date == 0 ? "the epoch\n" : ctime(&date));
	date = iswap32(spcl.c_ddate);
 	msg("Date of last level %c dump: %s", lastlevel,
		spcl.c_ddate == 0 ? "the epoch\n" : ctime(&date));
	msg("Dumping ");
	if (snap_backup != NULL || snap_internal)
		msgtail("a snapshot of ");
	if (dirc != 0)
		msgtail("a subset of ");
	msgtail("%s (%s) ", disk, spcl.c_filesys);
	if (host)
		msgtail("to %s on host %s\n", tape, host);
	else
		msgtail("to %s\n", tape);
	msg("Label: %s\n", labelstr);

	ufsib = fs_parametrize();

	dev_bshift = ffs(dev_bsize) - 1;
	if (dev_bsize != (1 << dev_bshift))
		quit("dev_bsize (%ld) is not a power of 2", dev_bsize);
	tp_bshift = ffs(TP_BSIZE) - 1;
	if (TP_BSIZE != (1 << tp_bshift))
		quit("TP_BSIZE (%d) is not a power of 2", TP_BSIZE);
	maxino = fs_maxino();
	mapsize = roundup(howmany(maxino, NBBY), TP_BSIZE);
	usedinomap = (char *)xcalloc((unsigned) mapsize, sizeof(char));
	dumpdirmap = (char *)xcalloc((unsigned) mapsize, sizeof(char));
	dumpinomap = (char *)xcalloc((unsigned) mapsize, sizeof(char));
	tapesize = 3 * (howmany(mapsize * sizeof(char), TP_BSIZE) + 1);

	nonodump = iswap32(spcl.c_level) < honorlevel;

	initcache(readcache, readblksize);

	(void)signal(SIGINFO, statussig);

	msg("mapping (Pass I) [regular files]\n");
	anydirskipped = mapfiles(maxino, &tapesize, mountpoint,
	    (dirc ? argv : NULL));

	msg("mapping (Pass II) [directories]\n");
	while (anydirskipped) {
		anydirskipped = mapdirs(maxino, &tapesize);
	}

	if (pipeout || unlimited) {
		tapesize += 10;	/* 10 trailer blocks */
		msg("estimated %llu tape blocks.\n",
		    (unsigned long long)tapesize);
	} else {
		double fetapes;

		if (blocksperfile)
			fetapes = (double) tapesize / blocksperfile;
		else if (cartridge) {
			/* Estimate number of tapes, assuming streaming stops at
			   the end of each block written, and not in mid-block.
			   Assume no erroneous blocks; this can be compensated
			   for with an artificially low tape size. */
			fetapes =
			(	  (double) tapesize	/* blocks */
				* TP_BSIZE	/* bytes/block */
				* (1.0/density)	/* 0.1" / byte */
			  +
				  (double) tapesize	/* blocks */
				* (1.0/ntrec)	/* streaming-stops per block */
				* 15.48		/* 0.1" / streaming-stop */
			) * (1.0 / tsize );	/* tape / 0.1" */
		} else {
			/* Estimate number of tapes, for old fashioned 9-track
			   tape */
			int tenthsperirg = (density == 625) ? 3 : 7;
			fetapes =
			(	  tapesize	/* blocks */
				* TP_BSIZE	/* bytes / block */
				* (1.0/density)	/* 0.1" / byte */
			  +
				  tapesize	/* blocks */
				* (1.0/ntrec)	/* IRG's / block */
				* tenthsperirg	/* 0.1" / IRG */
			) * (1.0 / tsize );	/* tape / 0.1" */
		}
		etapes = fetapes;		/* truncating assignment */
		etapes++;
		/* count the dumped inodes map on each additional tape */
		tapesize += (etapes - 1) *
			(howmany(mapsize * sizeof(char), TP_BSIZE) + 1);
		tapesize += etapes + 10;	/* headers + 10 trailer blks */
		msg("estimated %llu tape blocks on %3.2f tape(s).\n",
		    (unsigned long long)tapesize, fetapes);
	}
	/*
	 * If the user only wants an estimate of the number of
	 * tapes, exit now.
	 */
	if (just_estimate)
		exit(X_FINOK);

	/*
	 * Allocate tape buffer.
	 */
	if (!alloctape())
		quit("can't allocate tape buffers - try a smaller"
		    " blocking factor.");

	startnewtape(1);
	(void)time((time_t *)&(tstart_writing));
	xferrate = 0;
	dumpmap(usedinomap, TS_CLRI, maxino - 1);

	msg("dumping (Pass III) [directories]\n");
	dirty = 0;		/* XXX just to get gcc to shut up */
	for (map = dumpdirmap, ino = 1; ino < maxino; ino++) {
		if (((ino - 1) % NBBY) == 0)	/* map is offset by 1 */
			dirty = *map++;
		else
			dirty >>= 1;
		if ((dirty & 1) == 0)
			continue;
		/*
		 * Skip directory inodes deleted and maybe reallocated
		 */
		dp = getino(ino);
		if ((DIP(dp, mode) & IFMT) != IFDIR)
			continue;
		(void)dumpino(dp, ino);
	}

	msg("dumping (Pass IV) [regular files]\n");
	for (map = dumpinomap, ino = 1; ino < maxino; ino++) {
		int mode;

		if (((ino - 1) % NBBY) == 0)	/* map is offset by 1 */
			dirty = *map++;
		else
			dirty >>= 1;
		if ((dirty & 1) == 0)
			continue;
		/*
		 * Skip inodes deleted and reallocated as directories.
		 */
		dp = getino(ino);
		mode = DIP(dp, mode) & IFMT;
		if (mode == IFDIR)
			continue;
		(void)dumpino(dp, ino);
	}

	spcl.c_type = iswap32(TS_END);
	for (i = 0; i < ntrec; i++)
		writeheader(maxino - 1);
	if (pipeout)
		msg("%lld tape blocks\n",(long long)iswap64(spcl.c_tapea));
	else
		msg("%lld tape blocks on %d volume%s\n",
		    (long long)iswap64(spcl.c_tapea), iswap32(spcl.c_volume),
		    (iswap32(spcl.c_volume) == 1) ? "" : "s");
	tnow = do_stats();
	date = iswap32(spcl.c_date);
	msg("Date of this level %c dump: %s", level,
		spcl.c_date == 0 ? "the epoch\n" : ctime(&date));
	msg("Date this dump completed:  %s", ctime(&tnow));
	msg("Average transfer rate: %d KB/s\n", xferrate / tapeno);
	putdumptime();
	trewind(0);
	broadcast("DUMP IS DONE!\a\a\n");
#ifdef DUMP_LFS
	lfs_wrap_go();
#endif /* DUMP_LFS */
	msg("DUMP IS DONE\n");
	Exit(X_FINOK);
	/* NOTREACHED */
	exit(X_FINOK);		/* XXX: to satisfy gcc */
}

static void
usage(void)
{
	const char *prog = getprogname();

	(void)fprintf(stderr,
"usage: %s [-0123456789aceFinStuX] [-B records] [-b blocksize]\n"
"            [-d density] [-f file] [-h level] [-k read-blocksize]\n"
"            [-L label] [-l timeout] [-r cachesize] [-s feet]\n"
"            [-T date] [-U dumpdev] [-x snap-backup] files-to-dump\n"
"       %s [-W | -w]\n", prog, prog);
	exit(X_STARTUP);
}

/*
 * Pick up a numeric argument.  It must be nonnegative and in the given
 * range (except that a vmax of 0 means unlimited).
 */
static long
numarg(const char *meaning, long vmin, long vmax)
{
	char *p;
	long val;

	val = strtol(optarg, &p, 10);
	if (*p)
		errx(X_STARTUP, "illegal %s -- %s", meaning, optarg);
	if (val < vmin || (vmax && val > vmax))
		errx(X_STARTUP, "%s must be between %ld and %ld",
		    meaning, vmin, vmax);
	return (val);
}

void
sig(int signo)
{

	switch(signo) {
	case SIGALRM:
	case SIGBUS:
	case SIGFPE:
	case SIGHUP:
	case SIGTERM:
	case SIGTRAP:
		if (pipeout)
			quit("Signal on pipe: cannot recover");
		msg("Rewriting attempted as response to signal %s.\n", sys_siglist[signo]);
		(void)fflush(stderr);
		(void)fflush(stdout);
		close_rewind();
		exit(X_REWRITE);
		/* NOTREACHED */
	case SIGSEGV:
		msg("SIGSEGV: ABORTING!\n");
		(void)signal(SIGSEGV, SIG_DFL);
		(void)kill(0, SIGSEGV);
		/* NOTREACHED */
	}
}

/*
 * obsolete --
 *	Change set of key letters and ordered arguments into something
 *	getopt(3) will like.
 */
static void
obsolete(int *argcp, char **argvp[])
{
	int argc, flags;
	char *ap, **argv, *flagsp, **nargv, *p;

	/* Setup. */
	argv = *argvp;
	argc = *argcp;

	/* Return if no arguments or first argument has leading dash. */
	ap = argv[1];
	if (argc == 1 || *ap == '-')
		return;

	/* Allocate space for new arguments. */
	*argvp = nargv = xmalloc((argc + 1) * sizeof(char *));
	p = flagsp = xmalloc(strlen(ap) + 2);

	*nargv++ = *argv;
	argv += 2;

	for (flags = 0; *ap; ++ap) {
		switch (*ap) {
		case 'B':
		case 'b':
		case 'd':
		case 'f':
		case 'h':
		case 's':
		case 'T':
		case 'x':
			if (*argv == NULL) {
				warnx("option requires an argument -- %c", *ap);
				usage();
			}
			nargv[0] = xmalloc(strlen(*argv) + 2 + 1);
			nargv[0][0] = '-';
			nargv[0][1] = *ap;
			(void)strcpy(&nargv[0][2], *argv); /* XXX safe strcpy */
			++argv;
			++nargv;
			break;
		default:
			if (!flags) {
				*p++ = '-';
				flags = 1;
			}
			*p++ = *ap;
			break;
		}
	}

	/* Terminate flags. */
	if (flags) {
		*p = '\0';
		*nargv++ = flagsp;
	} else
		free(flagsp);

	/* Copy remaining arguments. */
	while ((*nargv++ = *argv++) != NULL)
		;

	/* Update argument count. */
	*argcp = nargv - *argvp - 1;
}


void *
xcalloc(size_t number, size_t size)
{
	void *p;

	p = calloc(number, size);
	if (p == NULL)
		quite(errno, "Can't allocate %zu bytes", size * number);
	return (p);
}

void *
xmalloc(size_t size)
{
	void *p;

	p = malloc(size);
	if (p == NULL)
		quite(errno, "Can't allocate %zu bytes", size);
	return (p);
}

char *
xstrdup(const char *str)
{
	char *p;

	p = strdup(str);
	if (p == NULL)
		quite(errno, "Can't copy %s", str);
	return (p);
}