2 * Copyright (c) 1987, 1993
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. Neither the name of the University nor the names of its contributors
14 * may be used to endorse or promote products derived from this software
15 * without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * @(#) Copyright (c) 1987, 1993 The Regents of the University of California. All rights reserved.
30 * @(#)xinstall.c 8.1 (Berkeley) 7/21/93
31 * $FreeBSD: src/usr.bin/xinstall/xinstall.c,v 1.38.2.8 2002/08/07 16:29:48 ru Exp $
34 #include <sys/param.h>
36 #include <sys/mount.h>
54 /* Bootstrap aid - this doesn't exist in most older releases */
56 #define MAP_FAILED ((void *)-1) /* from <sys/mman.h> */
59 #define UF_NOHISTORY 0
62 #define MAX_CMP_SIZE (16 * 1024 * 1024)
64 #define DIRECTORY 0x01 /* Tell install it's a directory. */
65 #define SETFLAGS 0x02 /* Tell install to set flags. */
66 #define NOCHANGEBITS (UF_IMMUTABLE | UF_APPEND | SF_IMMUTABLE | SF_APPEND)
67 #define BACKUP_SUFFIX ".old"
69 static struct passwd
*pp
;
70 static struct group
*gp
;
73 static int dobackup
, docompare
, dodir
, dopreserve
, dostrip
, dounpriv
, nommap
,
75 static mode_t mode
= S_IRWXU
| S_IRGRP
| S_IXGRP
| S_IROTH
| S_IXOTH
;
76 static const char *suffix
= BACKUP_SUFFIX
;
77 static char *destdir
, *fflags
;
79 static int file_getgroup(const char *etcdir
, const char *group
, gid_t
*gidret
);
80 static int file_getowner(const char *etcdir
, const char *owner
, uid_t
*uidret
);
82 static int compare(int, const char *, size_t, int, const char *, size_t);
83 static void copy(int, const char *, int, const char *, off_t
);
84 static int create_newfile(const char *, int, struct stat
*);
85 static int create_tempfile(const char *, char *, size_t);
86 static void install(const char *, const char *, u_long
, u_long
, u_int
);
87 static void install_dir(char *);
88 u_long
numeric_id(const char *, const char *);
89 static void strip(const char *);
90 static int trymmap(int);
91 static void usage(void);
94 main(int argc
, char *argv
[])
96 struct stat from_sb
, to_sb
;
103 const char *group
, *owner
, *to_name
;
114 while ((ch
= getopt(argc
, argv
, "L:B:bCcD:df:g:lMm:N:o:pSsUv")) != -1)
126 /* For backwards compatibility. */
147 if (!(set
= setmode(optarg
)))
148 errx(EX_USAGE
, "invalid file mode: %s",
150 mode
= getmode(set
, 0);
154 /* -L option kept for compatibility with pre-5.4 */
155 warnx("Option -L is deprecated, use -N instead");
164 docompare
= dopreserve
= 1;
185 /* some options make no sense when creating directories */
186 if (dostrip
&& dodir
) {
187 warnx("-d and -s may not be specified together");
191 if (getenv("DONTSTRIP") != NULL
) {
192 warnx("DONTSTRIP set - will not strip installed binaries");
196 /* must have at least two arguments, except when creating directories */
197 if (argc
< 2 && !dodir
)
200 /* need to make a temp copy so we can compare stripped version */
201 if (docompare
&& dostrip
)
204 /* no etcdir specified, always try the system */
210 /* get group and owner id's */
211 if (group
!= NULL
&& !dounpriv
) {
212 if (etcdir
&& file_getgroup(etcdir
, group
, &gid
)) {
214 } else if (trysys
&& (gp
= getgrnam(group
)) != NULL
) {
217 gid
= (gid_t
)numeric_id(group
, "group");
221 if (owner
!= NULL
&& !dounpriv
) {
222 if (etcdir
&& file_getowner(etcdir
, owner
, &uid
)) {
224 } else if (trysys
&& (pp
= getpwnam(owner
)) != NULL
) {
227 uid
= (uid_t
)numeric_id(owner
, "user");
231 if (fflags
!= NULL
&& !dounpriv
) {
232 if (strtofflags(&fflags
, &fset
, &fclr
))
233 errx(EX_USAGE
, "%s: invalid flag", fflags
);
238 for (; *argv
!= NULL
; ++argv
)
244 to_name
= argv
[argc
- 1];
245 no_target
= stat(to_name
, &to_sb
);
246 if (!no_target
&& S_ISDIR(to_sb
.st_mode
)) {
247 for (; *argv
!= to_name
; ++argv
)
248 install(*argv
, to_name
, fset
, fclr
, iflags
| DIRECTORY
);
253 /* can't do file1 file2 directory/file */
256 warnx("target directory `%s' does not exist",
259 warnx("target `%s' is not a directory",
265 if (stat(*argv
, &from_sb
))
266 err(EX_OSERR
, "%s", *argv
);
267 if (!S_ISREG(to_sb
.st_mode
)) {
269 err(EX_OSERR
, "%s", to_name
);
271 if (to_sb
.st_dev
== from_sb
.st_dev
&&
272 to_sb
.st_ino
== from_sb
.st_ino
)
274 "%s and %s are the same file", *argv
, to_name
);
276 install(*argv
, to_name
, fset
, fclr
, iflags
);
282 numeric_id(const char *name
, const char *type
)
289 * We know that uid_t's and gid_t's are unsigned longs.
292 val
= strtoul(name
, &ep
, 10);
294 err(EX_NOUSER
, "%s", name
);
296 errx(EX_NOUSER
, "unknown %s %s", type
, name
);
302 file_getgroup(const char *etcdir
, const char *group
, gid_t
*gidret
)
311 grlen
= strlen(group
);
313 if (asprintf(&path
, "%s/group", etcdir
) < 0)
314 errx(EX_OSERR
, "asprintf()");
315 if ((fp
= fopen(path
, "r")) != NULL
) {
316 while ((ptr
= fgetln(fp
, &len
)) != NULL
&& len
) {
318 if ((scan
= strchr(ptr
, ':')) == NULL
)
320 if ((size_t)(scan
- ptr
) != grlen
)
322 if (strncmp(ptr
, group
, grlen
) != 0)
324 if ((scan
= strchr(scan
+ 1, ':')) == NULL
)
326 *gidret
= strtoul(scan
+ 1, NULL
, 10);
332 return((*gidret
== (gid_t
)-1) ? 0 : 1);
337 file_getowner(const char *etcdir
, const char *owner
, uid_t
*uidret
)
346 owner_len
= strlen(owner
);
348 if (asprintf(&path
, "%s/master.passwd", etcdir
) < 0)
349 errx(EX_OSERR
, "asprintf()");
350 if ((fp
= fopen(path
, "r")) != NULL
) {
351 while ((ptr
= fgetln(fp
, &len
)) != NULL
&& len
) {
353 if ((scan
= strchr(ptr
, ':')) == NULL
)
355 if ((size_t)(scan
- ptr
) != owner_len
)
357 if (strncmp(ptr
, owner
, owner_len
) != 0)
359 if ((scan
= strchr(scan
+ 1, ':')) == NULL
)
361 *uidret
= strtoul(scan
+ 1, NULL
, 10);
367 return((*uidret
== (uid_t
)-1) ? 0 : 1);
372 * build a path name and install the file
375 install(const char *from_name
, const char *to_name
, u_long fset
, u_long fclr
,
378 struct stat from_sb
, temp_sb
, to_sb
;
380 int devnull
, files_match
, from_fd
, serrno
, target
;
381 int tempcopy
, temp_fd
, to_fd
;
383 char backup
[MAXPATHLEN
], *p
, pathbuf
[MAXPATHLEN
], tempfile
[MAXPATHLEN
];
388 /* If try to install NULL file to a directory, fails. */
389 if (flags
& DIRECTORY
|| strcmp(from_name
, _PATH_DEVNULL
)) {
390 if (stat(from_name
, &from_sb
))
391 err(EX_OSERR
, "%s", from_name
);
392 if (!S_ISREG(from_sb
.st_mode
)) {
394 err(EX_OSERR
, "%s", from_name
);
396 /* Build the target path. */
397 if (flags
& DIRECTORY
) {
398 (void)snprintf(pathbuf
, sizeof(pathbuf
), "%s/%s",
400 (p
= strrchr(from_name
, '/')) ? ++p
: from_name
);
408 target
= stat(to_name
, &to_sb
) == 0;
410 /* Only install to regular files. */
411 if (target
&& !S_ISREG(to_sb
.st_mode
)) {
417 /* Only copy safe if the target exists. */
418 tempcopy
= safecopy
&& target
;
420 if (!devnull
&& (from_fd
= open(from_name
, O_RDONLY
, 0)) < 0)
421 err(EX_OSERR
, "%s", from_name
);
423 /* If we don't strip, we can compare first. */
424 if (docompare
&& !dostrip
&& target
) {
425 if ((to_fd
= open(to_name
, O_RDONLY
, 0)) < 0)
426 err(EX_OSERR
, "%s", to_name
);
428 files_match
= to_sb
.st_size
== 0;
430 files_match
= !(compare(from_fd
, from_name
,
431 (size_t)from_sb
.st_size
, to_fd
,
432 to_name
, (size_t)to_sb
.st_size
));
434 /* Close "to" file unless we match. */
441 to_fd
= create_tempfile(to_name
, tempfile
,
444 err(EX_OSERR
, "%s", tempfile
);
446 if ((to_fd
= create_newfile(to_name
, target
,
448 err(EX_OSERR
, "%s", to_name
);
450 (void)printf("install: %s -> %s\n",
454 copy(from_fd
, from_name
, to_fd
,
455 tempcopy
? tempfile
: to_name
, from_sb
.st_size
);
459 strip(tempcopy
? tempfile
: to_name
);
462 * Re-open our fd on the target, in case we used a strip
463 * that does not work in-place -- like GNU binutils strip.
466 to_fd
= open(tempcopy
? tempfile
: to_name
, O_RDONLY
, 0);
468 err(EX_OSERR
, "stripping %s", to_name
);
472 * Compare the stripped temp file with the target.
474 if (docompare
&& dostrip
&& target
) {
477 /* Re-open to_fd using the real target name. */
478 if ((to_fd
= open(to_name
, O_RDONLY
, 0)) < 0)
479 err(EX_OSERR
, "%s", to_name
);
481 if (fstat(temp_fd
, &temp_sb
)) {
483 (void)unlink(tempfile
);
485 err(EX_OSERR
, "%s", tempfile
);
488 if (compare(temp_fd
, tempfile
, (size_t)temp_sb
.st_size
, to_fd
,
489 to_name
, (size_t)to_sb
.st_size
) == 0) {
491 * If target has more than one link we need to
492 * replace it in order to snap the extra links.
493 * Need to preserve target file times, though.
495 if (to_sb
.st_nlink
!= 1) {
496 utb
.actime
= to_sb
.st_atime
;
497 utb
.modtime
= to_sb
.st_mtime
;
498 utime(tempfile
, &utb
);
501 (void)unlink(tempfile
);
503 (void) close(temp_fd
);
508 * Move the new file into place if doing a safe copy
509 * and the files are different (or just not compared).
511 if (tempcopy
&& !files_match
) {
512 /* Try to turn off the immutable bits. */
513 if (to_sb
.st_flags
& NOCHANGEBITS
)
514 (void)chflags(to_name
, to_sb
.st_flags
& ~NOCHANGEBITS
);
516 if ((size_t)snprintf(backup
, MAXPATHLEN
, "%s%s", to_name
,
517 suffix
) != strlen(to_name
) + strlen(suffix
)) {
519 errx(EX_OSERR
, "%s: backup filename too long",
523 (void)printf("install: %s -> %s\n", to_name
, backup
);
524 if (rename(to_name
, backup
) < 0) {
528 err(EX_OSERR
, "rename: %s to %s", to_name
,
533 (void)printf("install: %s -> %s\n", from_name
, to_name
);
534 if (rename(tempfile
, to_name
) < 0) {
538 err(EX_OSERR
, "rename: %s to %s",
542 /* Re-open to_fd so we aren't hosed by the rename(2). */
544 if ((to_fd
= open(to_name
, O_RDONLY
, 0)) < 0)
545 err(EX_OSERR
, "%s", to_name
);
549 * Preserve the timestamp of the source file if necessary.
551 if (dopreserve
&& !files_match
&& !devnull
) {
552 utb
.actime
= from_sb
.st_atime
;
553 utb
.modtime
= from_sb
.st_mtime
;
554 utime(to_name
, &utb
);
557 if (fstat(to_fd
, &to_sb
) == -1) {
559 (void)unlink(to_name
);
561 err(EX_OSERR
, "%s", to_name
);
565 * Set owner, group, mode for target; do the chown first,
566 * chown may lose the setuid bits.
568 if (!dounpriv
&& ((gid
!= (gid_t
)-1 && gid
!= to_sb
.st_gid
) ||
569 (uid
!= (uid_t
)-1 && uid
!= to_sb
.st_uid
) ||
570 (mode
!= to_sb
.st_mode
))) {
571 /* Try to turn off the immutable bits. */
572 if (to_sb
.st_flags
& NOCHANGEBITS
)
573 (void)fchflags(to_fd
, to_sb
.st_flags
& ~NOCHANGEBITS
);
577 (gid
!= (gid_t
)-1 && gid
!= to_sb
.st_gid
) ||
578 (uid
!= (uid_t
)-1 && uid
!= to_sb
.st_uid
)))
579 if (fchown(to_fd
, uid
, gid
) == -1) {
581 (void)unlink(to_name
);
583 err(EX_OSERR
,"%s: chown/chgrp", to_name
);
586 if (mode
!= to_sb
.st_mode
) {
588 dounpriv
? mode
& (S_IRWXU
|S_IRWXG
|S_IRWXO
) : mode
)) {
590 (void)unlink(to_name
);
592 err(EX_OSERR
, "%s: chmod", to_name
);
597 * If provided a set of flags, set them, otherwise, preserve the
598 * flags, except for the dump and history flags. The dump flag
599 * is left clear on the target while the history flag from when
600 * the target was created (which is inherited from the target's
601 * parent directory) is retained.
603 if (flags
& SETFLAGS
) {
604 nfset
= (to_sb
.st_flags
| fset
) & ~fclr
;
606 nfset
= (from_sb
.st_flags
& ~(UF_NODUMP
| UF_NOHISTORY
)) |
607 (to_sb
.st_flags
& UF_NOHISTORY
);
611 * NFS does not support flags. Ignore EOPNOTSUPP flags if we're just
612 * trying to turn off UF_NODUMP. If we're trying to set real flags,
613 * then warn if the fs doesn't support it, otherwise fail.
615 if (!dounpriv
&& !devnull
&& fchflags(to_fd
, nfset
)) {
616 if (flags
& SETFLAGS
) {
617 if (errno
== EOPNOTSUPP
)
618 warn("%s: chflags", to_name
);
621 (void)unlink(to_name
);
623 err(EX_OSERR
, "%s: chflags", to_name
);
630 (void)close(from_fd
);
635 * compare two files; non-zero means files differ
638 compare(int from_fd
, const char *from_name __unused
, size_t from_len
,
639 int to_fd
, const char *to_name __unused
, size_t to_len
)
646 if (from_len
!= to_len
)
649 if (from_len
<= MAX_CMP_SIZE
) {
651 if (trymmap(from_fd
) && trymmap(to_fd
)) {
652 p
= mmap(NULL
, from_len
, PROT_READ
, MAP_SHARED
, from_fd
, (off_t
)0);
653 if (p
== (char *)MAP_FAILED
)
655 q
= mmap(NULL
, from_len
, PROT_READ
, MAP_SHARED
, to_fd
, (off_t
)0);
656 if (q
== (char *)MAP_FAILED
) {
661 rv
= memcmp(p
, q
, from_len
);
673 lseek(from_fd
, 0, SEEK_SET
);
674 lseek(to_fd
, 0, SEEK_SET
);
676 n1
= read(from_fd
, buf1
, sizeof(buf1
));
680 n2
= read(to_fd
, buf2
, n1
);
682 rv
= memcmp(buf1
, buf2
, n1
);
684 rv
= 1; /* out of sync */
686 rv
= 1; /* read failure */
688 lseek(from_fd
, 0, SEEK_SET
);
689 lseek(to_fd
, 0, SEEK_SET
);
692 rv
= 1; /* don't bother in this case */
699 * create a temporary file based on path and open it
702 create_tempfile(const char *path
, char *temp
, size_t tsize
)
706 (void)strncpy(temp
, path
, tsize
);
707 temp
[tsize
- 1] = '\0';
708 if ((p
= strrchr(temp
, '/')) != NULL
)
712 (void)strncpy(p
, "INS@XXXX", &temp
[tsize
- 1] - p
);
713 temp
[tsize
- 1] = '\0';
714 return (mkstemp(temp
));
719 * create a new file, overwriting an existing one if necessary
722 create_newfile(const char *path
, int target
, struct stat
*sbp
)
724 char backup
[MAXPATHLEN
];
728 * Unlink now... avoid ETXTBSY errors later. Try to turn
729 * off the append/immutable bits -- if we fail, go ahead,
732 if (sbp
->st_flags
& NOCHANGEBITS
)
733 (void)chflags(path
, sbp
->st_flags
& ~NOCHANGEBITS
);
736 if ((size_t)snprintf(backup
, MAXPATHLEN
, "%s%s",
737 path
, suffix
) != strlen(path
) + strlen(suffix
))
738 errx(EX_OSERR
, "%s: backup filename too long",
740 (void)snprintf(backup
, MAXPATHLEN
, "%s%s",
743 (void)printf("install: %s -> %s\n",
745 if (rename(path
, backup
) < 0)
746 err(EX_OSERR
, "rename: %s to %s", path
, backup
);
751 return (open(path
, O_CREAT
| O_RDWR
| O_TRUNC
, S_IRUSR
| S_IWUSR
));
756 * copy from one file to another
759 copy(int from_fd
, const char *from_name
, int to_fd
,
760 const char *to_name
, off_t size
)
768 /* Rewind file descriptors. */
769 if (lseek(from_fd
, (off_t
)0, SEEK_SET
) == (off_t
)-1)
770 err(EX_OSERR
, "lseek: %s", from_name
);
771 if (lseek(to_fd
, (off_t
)0, SEEK_SET
) == (off_t
)-1)
772 err(EX_OSERR
, "lseek: %s", to_name
);
775 * Mmap and write if less than 8M (the limit is so we don't totally
776 * trash memory on big files. This is really a minor hack, but it
777 * wins some CPU back.
780 if (size
<= 8 * 1048576 && trymmap(from_fd
) &&
781 (p
= mmap(NULL
, (size_t)size
, PROT_READ
, MAP_SHARED
,
782 from_fd
, (off_t
)0)) != (char *)MAP_FAILED
) {
783 if ((nw
= write(to_fd
, p
, size
)) != size
) {
785 (void)unlink(to_name
);
786 errno
= nw
> 0 ? EIO
: serrno
;
787 err(EX_OSERR
, "%s", to_name
);
792 while ((nr
= read(from_fd
, buf
, sizeof(buf
))) > 0) {
793 if ((nw
= write(to_fd
, buf
, nr
)) != nr
) {
795 (void)unlink(to_name
);
796 errno
= nw
> 0 ? EIO
: serrno
;
797 err(EX_OSERR
, "%s", to_name
);
802 (void)unlink(to_name
);
804 err(EX_OSERR
, "%s", from_name
);
811 * use strip(1) to strip the target file
814 strip(const char *to_name
)
816 const char *stripbin
;
822 (void)unlink(to_name
);
824 err(EX_TEMPFAIL
, "fork");
826 stripbin
= getenv("STRIPBIN");
827 if (stripbin
== NULL
)
829 execlp(stripbin
, stripbin
, to_name
, NULL
);
830 err(EX_OSERR
, "exec(%s)", stripbin
);
832 if (wait(&status
) == -1 || status
) {
834 (void)unlink(to_name
);
835 errc(EX_SOFTWARE
, serrno
, "wait");
842 * When doing a concurrent make -j N multiple install's can race the mkdir.
846 mkdir_race(const char *path
, int nmode
)
851 res
= mkdir(path
, nmode
);
852 if (res
< 0 && errno
== EEXIST
) {
853 if (stat(path
, &sb
) == 0 && S_ISDIR(sb
.st_mode
))
855 res
= mkdir(path
, nmode
);
862 * build directory hierarchy
865 install_dir(char *path
)
872 if (!*p
|| (p
!= path
&& *p
== '/')) {
875 if (stat(path
, &sb
)) {
876 if (errno
!= ENOENT
||
877 mkdir_race(path
, 0755) < 0) {
878 err(EX_OSERR
, "mkdir %s", path
);
881 (void)printf("install: mkdir %s\n",
883 } else if (!S_ISDIR(sb
.st_mode
))
884 errx(EX_OSERR
, "%s exists but is not a directory", path
);
890 if ((gid
!= (gid_t
)-1 || uid
!= (uid_t
)-1) &&
891 chown(path
, uid
, gid
))
892 warn("chown %u:%u %s", uid
, gid
, path
);
893 /* XXXBED: should we do the chmod in the dounpriv case? */
894 if (chmod(path
, mode
))
895 warn("chmod %o %s", mode
, path
);
901 * print a usage message and die
907 "usage: install [-bCcpSsUv] [-B suffix] [-D dest] [-f flags] [-g group]\n"
908 " [-N dbdir] [-m mode] [-o owner] file1 file2\n"
909 " install [-bCcpSsUv] [-B suffix] [-D dest] [-f flags] [-g group]\n"
910 " [-N dbdir] [-m mode] [-o owner] file1 ... fileN directory\n"
911 " install -d [-lUv] [-D dest] [-g group] [-m mode] [-N dbdir] [-o owner]\n"
919 * return true (1) if mmap should be tried, false (0) if not.
925 * The ifdef is for bootstrapping - f_fstypename doesn't exist in
926 * pre-Lite2-merge systems.
931 if (nommap
|| fstatfs(fd
, &stfs
) != 0)
933 if (strcmp(stfs
.f_fstypename
, "ufs") == 0 ||
934 strcmp(stfs
.f_fstypename
, "cd9660") == 0)