INSTALL(1) BSD Reference Manual INSTALL(1)NAMEinstall - install binaries
SYNOPSISinstall [-CcDMpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 file2
install [-CcDMpsv] [-f flags] [-g group] [-m mode] [-o owner] file1 ...
fileN directory
install-d [-v] [-g group] [-m mode] [-o owner] directory ...
DESCRIPTION
The file(s) are moved (or copied if the -c option is specified) to the
target file or directory. If the destination is a directory, then the
file is moved into directory with its original filename. If the target
file already exists, it is overwritten if permissions allow.
-C Copy the file, as if the -c option is specified, except if the
target file already exists and the files are the same, then don't
change the modification time of the target.
-c Copy the file. This flag turns off the default behavior of
install where it deletes the original file after creating the
target.
-D Print debugging information. If -D is specified one or more
times, then print the renaming steps for -C. If -D is specified
two or more times, then warn about files that aren't installed
with -C.
-d Create directories. Missing parent directories are created as
required.
-f Specify the target's file flags; see chflags(1) for a list of
possible flags and their meanings.
-g Specify a group. A numeric GID is allowed.
-M Disable all use of mmap(2).
-m Specify an alternate mode. The default mode is set to rwxr-xr-x
(0755). The specified mode may be either an octal or symbolic
value; see chmod(1) for a description of possible mode values.
-o Specify an owner. A numeric UID is allowed.
-p Preserve the modification time. Copy the file, as if the -C
(Compare and copy) option is specified, except if the target file
doesn't already exist or is different, then preserve the modifi-
cation time of the file.
-s Install exec's the command strip(1) to strip binaries so that in-
stall can be portable over a large number of systems and binary
types.
-v Causes install to show when -C acutally installs something.
By default, install preserves all file flags, with the exception of the
``nodump'' flag.
The install utility attempts to prevent moving a file onto itself.
Installing /dev/null creates an empty file.
DIAGNOSTICS
The install utility exits 0 on success, and 1 otherwise.
FILES
INS@XXXX If the -C or -p option is used, then temporary files named
INS@XXXX, where XXXX is decided by mkstemp(3), are created in
the target directory.
SEE ALSOchflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), mmap(2),
chown(8)HISTORY
The install utility appeared in 4.2BSD.
BUGS
Temporary files may be left in the target directory if install exits ab-
normally.
File flags cannot be set by fchflags(2) over a NFS file system. Other
file systems do not have a concept of flags. install will only warn when
flags could not be set on a file system that does not support them.
install with -v falsely says a file is copied when -C snaps hard links.
4.2 Berkeley Distribution September 22, 1996 2
