Home | History | Annotate | Line # | Download | only in cp
utils.c revision 1.46.2.1
      1  1.46.2.1    martin /* $NetBSD: utils.c,v 1.46.2.1 2021/09/23 10:11:02 martin Exp $ */
      2       1.3       cgd 
      3       1.1   mycroft /*-
      4       1.1   mycroft  * Copyright (c) 1991, 1993, 1994
      5       1.1   mycroft  *	The Regents of the University of California.  All rights reserved.
      6       1.1   mycroft  *
      7       1.1   mycroft  * Redistribution and use in source and binary forms, with or without
      8       1.1   mycroft  * modification, are permitted provided that the following conditions
      9       1.1   mycroft  * are met:
     10       1.1   mycroft  * 1. Redistributions of source code must retain the above copyright
     11       1.1   mycroft  *    notice, this list of conditions and the following disclaimer.
     12       1.1   mycroft  * 2. Redistributions in binary form must reproduce the above copyright
     13       1.1   mycroft  *    notice, this list of conditions and the following disclaimer in the
     14       1.1   mycroft  *    documentation and/or other materials provided with the distribution.
     15      1.25       agc  * 3. Neither the name of the University nor the names of its contributors
     16       1.1   mycroft  *    may be used to endorse or promote products derived from this software
     17       1.1   mycroft  *    without specific prior written permission.
     18       1.1   mycroft  *
     19       1.1   mycroft  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     20       1.1   mycroft  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     21       1.1   mycroft  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     22       1.1   mycroft  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     23       1.1   mycroft  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     24       1.1   mycroft  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     25       1.1   mycroft  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     26       1.1   mycroft  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     27       1.1   mycroft  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     28       1.1   mycroft  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     29       1.1   mycroft  * SUCH DAMAGE.
     30       1.1   mycroft  */
     31       1.1   mycroft 
     32       1.8   thorpej #include <sys/cdefs.h>
     33       1.1   mycroft #ifndef lint
     34       1.3       cgd #if 0
     35       1.3       cgd static char sccsid[] = "@(#)utils.c	8.3 (Berkeley) 4/1/94";
     36       1.3       cgd #else
     37  1.46.2.1    martin __RCSID("$NetBSD: utils.c,v 1.46.2.1 2021/09/23 10:11:02 martin Exp $");
     38       1.3       cgd #endif
     39       1.1   mycroft #endif /* not lint */
     40       1.1   mycroft 
     41      1.20       wiz #include <sys/mman.h>
     42       1.1   mycroft #include <sys/param.h>
     43       1.1   mycroft #include <sys/stat.h>
     44       1.1   mycroft #include <sys/time.h>
     45      1.40      manu #include <sys/extattr.h>
     46       1.1   mycroft 
     47       1.1   mycroft #include <err.h>
     48       1.1   mycroft #include <errno.h>
     49       1.1   mycroft #include <fcntl.h>
     50       1.1   mycroft #include <fts.h>
     51      1.36      tron #include <stdbool.h>
     52       1.1   mycroft #include <stdio.h>
     53       1.1   mycroft #include <stdlib.h>
     54       1.1   mycroft #include <string.h>
     55       1.1   mycroft #include <unistd.h>
     56       1.1   mycroft 
     57       1.1   mycroft #include "extern.h"
     58       1.1   mycroft 
     59      1.36      tron #define	MMAP_MAX_SIZE	(8 * 1048576)
     60      1.36      tron #define	MMAP_MAX_WRITE	(64 * 1024)
     61      1.36      tron 
     62       1.1   mycroft int
     63      1.20       wiz set_utimes(const char *file, struct stat *fs)
     64      1.16  wsanchez {
     65      1.43     enami     struct timespec ts[2];
     66      1.16  wsanchez 
     67      1.43     enami     ts[0] = fs->st_atimespec;
     68      1.43     enami     ts[1] = fs->st_mtimespec;
     69      1.16  wsanchez 
     70      1.43     enami     if (lutimens(file, ts)) {
     71      1.44     enami 	warn("lutimens: %s", file);
     72      1.16  wsanchez 	return (1);
     73      1.16  wsanchez     }
     74      1.16  wsanchez     return (0);
     75      1.16  wsanchez }
     76      1.16  wsanchez 
     77      1.41  christos struct finfo {
     78      1.41  christos 	const char *from;
     79      1.41  christos 	const char *to;
     80      1.45       mrg 	off_t size;
     81      1.41  christos };
     82      1.41  christos 
     83      1.41  christos static void
     84      1.45       mrg progress(const struct finfo *fi, off_t written)
     85      1.41  christos {
     86      1.41  christos 	int pcent = (int)((100.0 * written) / fi->size);
     87      1.41  christos 
     88      1.41  christos 	pinfo = 0;
     89      1.45       mrg 	(void)fprintf(stderr, "%s => %s %llu/%llu bytes %d%% written\n",
     90      1.45       mrg 	    fi->from, fi->to, (unsigned long long)written,
     91      1.45       mrg 	    (unsigned long long)fi->size, pcent);
     92      1.41  christos }
     93      1.41  christos 
     94      1.16  wsanchez int
     95      1.20       wiz copy_file(FTSENT *entp, int dne)
     96       1.1   mycroft {
     97       1.1   mycroft 	static char buf[MAXBSIZE];
     98       1.1   mycroft 	struct stat to_stat, *fs;
     99      1.32  jschauma 	int ch, checkch, from_fd, rcount, rval, to_fd, tolnk, wcount;
    100      1.36      tron 	char *p;
    101      1.45       mrg 	off_t ptotal = 0;
    102      1.46     darcy 
    103      1.46     darcy 	/* if hard linking then simply link and return */
    104      1.46     darcy 	if (lflag) {
    105      1.46     darcy 		(void)unlink(to.p_path);
    106      1.46     darcy 		if (link(entp->fts_path, to.p_path)) {
    107      1.46     darcy 			warn("%s", to.p_path);
    108      1.46     darcy 			return (1);
    109      1.46     darcy 		}
    110      1.46     darcy 		return (0);
    111      1.46     darcy 	}
    112      1.46     darcy 
    113       1.1   mycroft 	if ((from_fd = open(entp->fts_path, O_RDONLY, 0)) == -1) {
    114       1.1   mycroft 		warn("%s", entp->fts_path);
    115       1.1   mycroft 		return (1);
    116       1.1   mycroft 	}
    117       1.1   mycroft 
    118      1.32  jschauma 	to_fd = -1;
    119       1.1   mycroft 	fs = entp->fts_statp;
    120      1.32  jschauma 	tolnk = ((Rflag && !(Lflag || Hflag)) || Pflag);
    121       1.1   mycroft 
    122       1.1   mycroft 	/*
    123       1.1   mycroft 	 * If the file exists and we're interactive, verify with the user.
    124       1.1   mycroft 	 * If the file DNE, set the mode to be the from file, minus setuid
    125       1.1   mycroft 	 * bits, modified by the umask; arguably wrong, but it makes copying
    126       1.1   mycroft 	 * executables work right and it's been that way forever.  (The
    127       1.1   mycroft 	 * other choice is 666 or'ed with the execute bits on the from file
    128       1.1   mycroft 	 * modified by the umask.)
    129       1.1   mycroft 	 */
    130       1.1   mycroft 	if (!dne) {
    131      1.32  jschauma 		struct stat sb;
    132      1.32  jschauma 		int sval;
    133      1.32  jschauma 
    134       1.1   mycroft 		if (iflag) {
    135       1.1   mycroft 			(void)fprintf(stderr, "overwrite %s? ", to.p_path);
    136       1.1   mycroft 			checkch = ch = getchar();
    137       1.1   mycroft 			while (ch != '\n' && ch != EOF)
    138       1.1   mycroft 				ch = getchar();
    139       1.2   mycroft 			if (checkch != 'y' && checkch != 'Y') {
    140       1.1   mycroft 				(void)close(from_fd);
    141       1.1   mycroft 				return (0);
    142       1.1   mycroft 			}
    143       1.1   mycroft 		}
    144      1.32  jschauma 
    145      1.32  jschauma 		sval = tolnk ?
    146      1.32  jschauma 			lstat(to.p_path, &sb) : stat(to.p_path, &sb);
    147      1.32  jschauma 		if (sval == -1) {
    148      1.32  jschauma 			warn("stat: %s", to.p_path);
    149      1.38       wiz 			(void)close(from_fd);
    150      1.32  jschauma 			return (1);
    151      1.32  jschauma 		}
    152      1.32  jschauma 
    153      1.32  jschauma 		if (!(tolnk && S_ISLNK(sb.st_mode)))
    154      1.32  jschauma 			to_fd = open(to.p_path, O_WRONLY | O_TRUNC, 0);
    155       1.1   mycroft 	} else
    156       1.1   mycroft 		to_fd = open(to.p_path, O_WRONLY | O_TRUNC | O_CREAT,
    157       1.1   mycroft 		    fs->st_mode & ~(S_ISUID | S_ISGID));
    158       1.1   mycroft 
    159      1.32  jschauma 	if (to_fd == -1 && (fflag || tolnk)) {
    160      1.16  wsanchez 		/*
    161      1.16  wsanchez 		 * attempt to remove existing destination file name and
    162      1.16  wsanchez 		 * create a new file
    163      1.16  wsanchez 		 */
    164      1.16  wsanchez 		(void)unlink(to.p_path);
    165      1.16  wsanchez 		to_fd = open(to.p_path, O_WRONLY | O_TRUNC | O_CREAT,
    166      1.16  wsanchez 			     fs->st_mode & ~(S_ISUID | S_ISGID));
    167      1.16  wsanchez 	}
    168      1.16  wsanchez 
    169       1.1   mycroft 	if (to_fd == -1) {
    170       1.1   mycroft 		warn("%s", to.p_path);
    171       1.1   mycroft 		(void)close(from_fd);
    172      1.23    simonb 		return (1);
    173       1.1   mycroft 	}
    174       1.1   mycroft 
    175       1.1   mycroft 	rval = 0;
    176       1.1   mycroft 
    177  1.46.2.1    martin 	/*
    178      1.16  wsanchez 	 * There's no reason to do anything other than close the file
    179  1.46.2.1    martin 	 * now if it's regular and empty, so let's not bother.
    180       1.1   mycroft 	 */
    181  1.46.2.1    martin 	bool need_copy = !S_ISREG(fs->st_mode) || fs->st_size > 0;
    182      1.19       chs 
    183  1.46.2.1    martin 	struct finfo fi;
    184      1.36      tron 
    185  1.46.2.1    martin 	fi.from = entp->fts_path;
    186  1.46.2.1    martin 	fi.to = to.p_path;
    187  1.46.2.1    martin 	fi.size = fs->st_size;
    188      1.36      tron 
    189  1.46.2.1    martin 	/*
    190  1.46.2.1    martin 	 * Mmap and write if less than 8M (the limit is so
    191  1.46.2.1    martin 	 * we don't totally trash memory on big files).
    192  1.46.2.1    martin 	 * This is really a minor hack, but it wins some CPU back.
    193  1.46.2.1    martin 	 */
    194  1.46.2.1    martin 	if (S_ISREG(fs->st_mode) && fs->st_size && fs->st_size <= MMAP_MAX_SIZE) {
    195  1.46.2.1    martin 		size_t fsize = (size_t)fs->st_size;
    196  1.46.2.1    martin 		p = mmap(NULL, fsize, PROT_READ, MAP_FILE|MAP_SHARED,
    197  1.46.2.1    martin 		    from_fd, (off_t)0);
    198  1.46.2.1    martin 		if (p != MAP_FAILED) {
    199  1.46.2.1    martin 			size_t remainder;
    200  1.46.2.1    martin 
    201  1.46.2.1    martin 			need_copy = false;
    202  1.46.2.1    martin 
    203  1.46.2.1    martin 			(void) madvise(p, (size_t)fs->st_size, MADV_SEQUENTIAL);
    204  1.46.2.1    martin 
    205  1.46.2.1    martin 			/*
    206  1.46.2.1    martin 			 * Write out the data in small chunks to
    207  1.46.2.1    martin 			 * avoid locking the output file for a
    208  1.46.2.1    martin 			 * long time if the reading the data from
    209  1.46.2.1    martin 			 * the source is slow.
    210  1.46.2.1    martin 			 */
    211  1.46.2.1    martin 			remainder = fsize;
    212  1.46.2.1    martin 			do {
    213  1.46.2.1    martin 				ssize_t chunk;
    214  1.46.2.1    martin 
    215  1.46.2.1    martin 				chunk = (remainder > MMAP_MAX_WRITE) ?
    216  1.46.2.1    martin 				    MMAP_MAX_WRITE : remainder;
    217  1.46.2.1    martin 				if (write(to_fd, &p[fsize - remainder],
    218  1.46.2.1    martin 				    chunk) != chunk) {
    219      1.16  wsanchez 					warn("%s", to.p_path);
    220      1.16  wsanchez 					rval = 1;
    221      1.16  wsanchez 					break;
    222      1.16  wsanchez 				}
    223  1.46.2.1    martin 				remainder -= chunk;
    224  1.46.2.1    martin 				ptotal += chunk;
    225      1.41  christos 				if (pinfo)
    226      1.41  christos 					progress(&fi, ptotal);
    227  1.46.2.1    martin 			} while (remainder > 0);
    228  1.46.2.1    martin 
    229  1.46.2.1    martin 			if (munmap(p, fsize) < 0) {
    230      1.16  wsanchez 				warn("%s", entp->fts_path);
    231       1.1   mycroft 				rval = 1;
    232       1.1   mycroft 			}
    233       1.1   mycroft 		}
    234       1.1   mycroft 	}
    235       1.1   mycroft 
    236  1.46.2.1    martin 	if (need_copy) {
    237  1.46.2.1    martin 		while ((rcount = read(from_fd, buf, MAXBSIZE)) > 0) {
    238  1.46.2.1    martin 			wcount = write(to_fd, buf, (size_t)rcount);
    239  1.46.2.1    martin 			if (rcount != wcount || wcount == -1) {
    240  1.46.2.1    martin 				warn("%s", to.p_path);
    241  1.46.2.1    martin 				rval = 1;
    242  1.46.2.1    martin 				break;
    243  1.46.2.1    martin 			}
    244  1.46.2.1    martin 			ptotal += wcount;
    245  1.46.2.1    martin 			if (pinfo)
    246  1.46.2.1    martin 				progress(&fi, ptotal);
    247  1.46.2.1    martin 		}
    248  1.46.2.1    martin 		if (rcount < 0) {
    249  1.46.2.1    martin 			warn("%s", entp->fts_path);
    250  1.46.2.1    martin 			rval = 1;
    251  1.46.2.1    martin 		}
    252  1.46.2.1    martin 	}
    253  1.46.2.1    martin 
    254      1.40      manu 	if (pflag && (fcpxattr(from_fd, to_fd) != 0))
    255      1.40      manu 		warn("%s: error copying extended attributes", to.p_path);
    256      1.40      manu 
    257      1.39     darcy 	(void)close(from_fd);
    258      1.39     darcy 
    259       1.1   mycroft 	if (rval == 1) {
    260       1.1   mycroft 		(void)close(to_fd);
    261       1.1   mycroft 		return (1);
    262       1.1   mycroft 	}
    263       1.1   mycroft 
    264       1.1   mycroft 	if (pflag && setfile(fs, to_fd))
    265       1.1   mycroft 		rval = 1;
    266       1.1   mycroft 	/*
    267       1.1   mycroft 	 * If the source was setuid or setgid, lose the bits unless the
    268       1.1   mycroft 	 * copy is owned by the same user and group.
    269       1.1   mycroft 	 */
    270       1.1   mycroft #define	RETAINBITS \
    271       1.1   mycroft 	(S_ISUID | S_ISGID | S_ISVTX | S_IRWXU | S_IRWXG | S_IRWXO)
    272      1.33       jld 	if (!pflag && dne
    273      1.33       jld 	    && fs->st_mode & (S_ISUID | S_ISGID) && fs->st_uid == myuid) {
    274       1.1   mycroft 		if (fstat(to_fd, &to_stat)) {
    275       1.1   mycroft 			warn("%s", to.p_path);
    276       1.1   mycroft 			rval = 1;
    277       1.1   mycroft 		} else if (fs->st_gid == to_stat.st_gid &&
    278       1.1   mycroft 		    fchmod(to_fd, fs->st_mode & RETAINBITS & ~myumask)) {
    279       1.1   mycroft 			warn("%s", to.p_path);
    280       1.1   mycroft 			rval = 1;
    281       1.1   mycroft 		}
    282      1.15   thorpej 	}
    283       1.1   mycroft 	if (close(to_fd)) {
    284       1.1   mycroft 		warn("%s", to.p_path);
    285       1.1   mycroft 		rval = 1;
    286       1.1   mycroft 	}
    287      1.16  wsanchez 	/* set the mod/access times now after close of the fd */
    288      1.16  wsanchez 	if (pflag && set_utimes(to.p_path, fs)) {
    289      1.16  wsanchez 	    rval = 1;
    290      1.16  wsanchez 	}
    291       1.1   mycroft 	return (rval);
    292       1.1   mycroft }
    293       1.1   mycroft 
    294       1.1   mycroft int
    295      1.20       wiz copy_link(FTSENT *p, int exists)
    296       1.1   mycroft {
    297       1.1   mycroft 	int len;
    298      1.13   mycroft 	char target[MAXPATHLEN];
    299       1.1   mycroft 
    300      1.21    provos 	if ((len = readlink(p->fts_path, target, sizeof(target)-1)) == -1) {
    301       1.1   mycroft 		warn("readlink: %s", p->fts_path);
    302       1.1   mycroft 		return (1);
    303       1.1   mycroft 	}
    304      1.13   mycroft 	target[len] = '\0';
    305       1.1   mycroft 	if (exists && unlink(to.p_path)) {
    306       1.1   mycroft 		warn("unlink: %s", to.p_path);
    307       1.1   mycroft 		return (1);
    308       1.1   mycroft 	}
    309      1.13   mycroft 	if (symlink(target, to.p_path)) {
    310      1.13   mycroft 		warn("symlink: %s", target);
    311       1.1   mycroft 		return (1);
    312       1.1   mycroft 	}
    313       1.9     enami 	return (pflag ? setfile(p->fts_statp, 0) : 0);
    314       1.1   mycroft }
    315       1.1   mycroft 
    316       1.1   mycroft int
    317      1.20       wiz copy_fifo(struct stat *from_stat, int exists)
    318       1.1   mycroft {
    319       1.1   mycroft 	if (exists && unlink(to.p_path)) {
    320       1.1   mycroft 		warn("unlink: %s", to.p_path);
    321       1.1   mycroft 		return (1);
    322       1.1   mycroft 	}
    323       1.1   mycroft 	if (mkfifo(to.p_path, from_stat->st_mode)) {
    324       1.1   mycroft 		warn("mkfifo: %s", to.p_path);
    325       1.1   mycroft 		return (1);
    326       1.1   mycroft 	}
    327       1.1   mycroft 	return (pflag ? setfile(from_stat, 0) : 0);
    328       1.1   mycroft }
    329       1.1   mycroft 
    330       1.1   mycroft int
    331      1.20       wiz copy_special(struct stat *from_stat, int exists)
    332       1.1   mycroft {
    333       1.1   mycroft 	if (exists && unlink(to.p_path)) {
    334       1.1   mycroft 		warn("unlink: %s", to.p_path);
    335       1.1   mycroft 		return (1);
    336       1.1   mycroft 	}
    337       1.1   mycroft 	if (mknod(to.p_path, from_stat->st_mode, from_stat->st_rdev)) {
    338       1.1   mycroft 		warn("mknod: %s", to.p_path);
    339       1.1   mycroft 		return (1);
    340       1.1   mycroft 	}
    341       1.1   mycroft 	return (pflag ? setfile(from_stat, 0) : 0);
    342       1.1   mycroft }
    343       1.1   mycroft 
    344       1.1   mycroft 
    345      1.16  wsanchez /*
    346      1.16  wsanchez  * Function: setfile
    347      1.16  wsanchez  *
    348      1.16  wsanchez  * Purpose:
    349      1.16  wsanchez  *   Set the owner/group/permissions for the "to" file to the information
    350      1.16  wsanchez  *   in the stat structure.  If fd is zero, also call set_utimes() to set
    351      1.16  wsanchez  *   the mod/access times.  If fd is non-zero, the caller must do a utimes
    352      1.16  wsanchez  *   itself after close(fd).
    353      1.16  wsanchez  */
    354       1.1   mycroft int
    355      1.20       wiz setfile(struct stat *fs, int fd)
    356       1.1   mycroft {
    357       1.9     enami 	int rval, islink;
    358       1.1   mycroft 
    359       1.1   mycroft 	rval = 0;
    360       1.9     enami 	islink = S_ISLNK(fs->st_mode);
    361       1.1   mycroft 	fs->st_mode &= S_ISUID | S_ISGID | S_IRWXU | S_IRWXG | S_IRWXO;
    362       1.1   mycroft 
    363       1.1   mycroft 	/*
    364       1.1   mycroft 	 * Changing the ownership probably won't succeed, unless we're root
    365       1.1   mycroft 	 * or POSIX_CHOWN_RESTRICTED is not set.  Set uid/gid before setting
    366       1.1   mycroft 	 * the mode; current BSD behavior is to remove all setuid bits on
    367       1.1   mycroft 	 * chown.  If chown fails, lose setuid/setgid bits.
    368       1.1   mycroft 	 */
    369       1.1   mycroft 	if (fd ? fchown(fd, fs->st_uid, fs->st_gid) :
    370       1.9     enami 	    lchown(to.p_path, fs->st_uid, fs->st_gid)) {
    371       1.1   mycroft 		if (errno != EPERM) {
    372       1.1   mycroft 			warn("chown: %s", to.p_path);
    373       1.1   mycroft 			rval = 1;
    374       1.1   mycroft 		}
    375       1.1   mycroft 		fs->st_mode &= ~(S_ISUID | S_ISGID);
    376       1.1   mycroft 	}
    377       1.9     enami 	if (fd ? fchmod(fd, fs->st_mode) : lchmod(to.p_path, fs->st_mode)) {
    378      1.10   mycroft 		warn("chmod: %s", to.p_path);
    379       1.1   mycroft 		rval = 1;
    380       1.1   mycroft 	}
    381       1.1   mycroft 
    382      1.28      elad 	if (!islink && !Nflag) {
    383      1.29  christos 		unsigned long fflags = fs->st_flags;
    384       1.9     enami 		/*
    385       1.9     enami 		 * XXX
    386       1.9     enami 		 * NFS doesn't support chflags; ignore errors unless
    387       1.9     enami 		 * there's reason to believe we're losing bits.
    388       1.9     enami 		 * (Note, this still won't be right if the server
    389       1.9     enami 		 * supports flags and we were trying to *remove* flags
    390       1.9     enami 		 * on a file that we copied, i.e., that we didn't create.)
    391       1.9     enami 		 */
    392       1.9     enami 		errno = 0;
    393      1.29  christos 		if ((fd ? fchflags(fd, fflags) :
    394      1.29  christos 		    chflags(to.p_path, fflags)) == -1)
    395       1.9     enami 			if (errno != EOPNOTSUPP || fs->st_flags != 0) {
    396       1.9     enami 				warn("chflags: %s", to.p_path);
    397       1.9     enami 				rval = 1;
    398       1.9     enami 			}
    399       1.9     enami 	}
    400      1.16  wsanchez 	/* if fd is non-zero, caller must call set_utimes() after close() */
    401      1.16  wsanchez 	if (fd == 0 && set_utimes(to.p_path, fs))
    402      1.16  wsanchez 	    rval = 1;
    403       1.1   mycroft 	return (rval);
    404       1.1   mycroft }
    405       1.1   mycroft 
    406       1.1   mycroft void
    407      1.20       wiz usage(void)
    408       1.1   mycroft {
    409      1.20       wiz 	(void)fprintf(stderr,
    410      1.39     darcy 	    "usage: %s [-R [-H | -L | -P]] [-f | -i] [-alNpv] src target\n"
    411      1.39     darcy 	    "       %s [-R [-H | -L | -P]] [-f | -i] [-alNpv] src1 ... srcN directory\n",
    412      1.20       wiz 	    getprogname(), getprogname());
    413       1.1   mycroft 	exit(1);
    414      1.14   mycroft 	/* NOTREACHED */
    415       1.1   mycroft }
    416