Home | History | Annotate | Line # | Download | only in cp
utils.c revision 1.45.16.4
      1  1.45.16.4    martin /* $NetBSD: utils.c,v 1.45.16.4 2020/04/21 19:37:30 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.45.16.4    martin __RCSID("$NetBSD: utils.c,v 1.45.16.4 2020/04/21 19:37:30 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.45.16.1  christos 
    103  1.45.16.1  christos 	/* if hard linking then simply link and return */
    104  1.45.16.1  christos 	if (lflag) {
    105  1.45.16.1  christos 		(void)unlink(to.p_path);
    106  1.45.16.1  christos 		if (link(entp->fts_path, to.p_path)) {
    107  1.45.16.1  christos 			warn("%s", to.p_path);
    108  1.45.16.1  christos 			return (1);
    109  1.45.16.1  christos 		}
    110  1.45.16.1  christos 		return (0);
    111  1.45.16.1  christos 	}
    112  1.45.16.1  christos 
    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.45.16.2    martin 	/*
    178       1.16  wsanchez 	 * There's no reason to do anything other than close the file
    179  1.45.16.2    martin 	 * now if it's regular and empty, so let's not bother.
    180        1.1   mycroft 	 */
    181  1.45.16.2    martin 	bool need_copy = !S_ISREG(fs->st_mode) || fs->st_size > 0;
    182       1.19       chs 
    183  1.45.16.2    martin 	struct finfo fi;
    184       1.36      tron 
    185  1.45.16.2    martin 	fi.from = entp->fts_path;
    186  1.45.16.2    martin 	fi.to = to.p_path;
    187  1.45.16.2    martin 	fi.size = fs->st_size;
    188       1.36      tron 
    189  1.45.16.2    martin 	/*
    190  1.45.16.2    martin 	 * Mmap and write if less than 8M (the limit is so
    191  1.45.16.2    martin 	 * we don't totally trash memory on big files).
    192  1.45.16.2    martin 	 * This is really a minor hack, but it wins some CPU back.
    193  1.45.16.2    martin 	 */
    194  1.45.16.2    martin 	if (S_ISREG(fs->st_mode) && fs->st_size && fs->st_size <= MMAP_MAX_SIZE) {
    195  1.45.16.2    martin 		size_t fsize = (size_t)fs->st_size;
    196  1.45.16.2    martin 		p = mmap(NULL, fsize, PROT_READ, MAP_FILE|MAP_SHARED,
    197  1.45.16.2    martin 		    from_fd, (off_t)0);
    198  1.45.16.2    martin 		if (p != MAP_FAILED) {
    199  1.45.16.2    martin 			size_t remainder;
    200  1.45.16.2    martin 
    201  1.45.16.2    martin 			need_copy = false;
    202  1.45.16.2    martin 
    203  1.45.16.2    martin 			(void) madvise(p, (size_t)fs->st_size, MADV_SEQUENTIAL);
    204  1.45.16.2    martin 
    205  1.45.16.2    martin 			/*
    206  1.45.16.2    martin 			 * Write out the data in small chunks to
    207  1.45.16.2    martin 			 * avoid locking the output file for a
    208  1.45.16.2    martin 			 * long time if the reading the data from
    209  1.45.16.2    martin 			 * the source is slow.
    210  1.45.16.2    martin 			 */
    211  1.45.16.2    martin 			remainder = fsize;
    212  1.45.16.2    martin 			do {
    213  1.45.16.2    martin 				ssize_t chunk;
    214  1.45.16.2    martin 
    215  1.45.16.2    martin 				chunk = (remainder > MMAP_MAX_WRITE) ?
    216  1.45.16.2    martin 				    MMAP_MAX_WRITE : remainder;
    217  1.45.16.2    martin 				if (write(to_fd, &p[fsize - remainder],
    218  1.45.16.2    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.45.16.2    martin 				remainder -= chunk;
    224  1.45.16.2    martin 				ptotal += chunk;
    225       1.41  christos 				if (pinfo)
    226       1.41  christos 					progress(&fi, ptotal);
    227  1.45.16.2    martin 			} while (remainder > 0);
    228  1.45.16.2    martin 
    229  1.45.16.2    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.45.16.2    martin 	if (need_copy) {
    237  1.45.16.2    martin 		while ((rcount = read(from_fd, buf, MAXBSIZE)) > 0) {
    238  1.45.16.2    martin 			wcount = write(to_fd, buf, (size_t)rcount);
    239  1.45.16.2    martin 			if (rcount != wcount || wcount == -1) {
    240  1.45.16.2    martin 				warn("%s", to.p_path);
    241  1.45.16.2    martin 				rval = 1;
    242  1.45.16.2    martin 				break;
    243  1.45.16.2    martin 			}
    244  1.45.16.2    martin 			ptotal += wcount;
    245  1.45.16.2    martin 			if (pinfo)
    246  1.45.16.2    martin 				progress(&fi, ptotal);
    247  1.45.16.2    martin 		}
    248  1.45.16.2    martin 		if (rcount < 0) {
    249  1.45.16.2    martin 			warn("%s", entp->fts_path);
    250  1.45.16.2    martin 			rval = 1;
    251  1.45.16.2    martin 		}
    252  1.45.16.2    martin 	}
    253  1.45.16.2    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