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