INSTALL(1) | General Commands Manual | INSTALL(1) |
install
— install
binaries
install |
[-bCcMpSsv ] [-B
suffix] [-f
flags] [-g
group] [-m
mode] [-o
owner] file1 file2 |
install |
[-bCcMpSsv ] [-B
suffix] [-f
flags] [-g
group] [-m
mode] [-o
owner] file1 ... fileN
directory |
install |
-d [-v ]
[-g group]
[-m mode]
[-o owner]
directory ... |
The file(s) are copied to the target file or directory. If the
destination is a directory, then the file is copied
into directory with its original filename. If the
target file already exists, it is either renamed to
file.old if the
-b
option is given or overwritten if permissions
allow. An alternate backup suffix may be specified via the
-B
option's argument.
The options are as follows:
-B
suffix-b
is given.-b
-B
for specifying a different backup suffix.-C
-c
-c
option is only included for backwards
compatibility.-d
-f
-g
-M
-m
-o
-p
-C
(compare and copy) option is specified, except
if the target file doesn't already exist or is different, then preserve
the modification time of the file.-S
install
unlinks an existing
target before installing the new file. With the -S
flag a temporary file is used and then renamed to be the target. The
reason this is safer is that if the copy or rename fails, the existing
target is left untouched.-s
install
exec's the command
strip(1) to strip binaries so that
install
can be portable over a large number of
systems and binary types.-v
install
to show when
-C
actually 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.
The install
utility exits 0 on success,
and 1 otherwise.
-S
option is specified, or the
-C
or -p
option is used in
conjuction with the -s
option, temporary files
named INS@XXXX, where XXXX
is decided by mkstemp(3), are
created in the target directory.Historically install
moved files by
default. The default was changed to copy in FreeBSD
4.4.
chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), mmap(2), chown(8)
The install
utility appeared in
4.2BSD.
Temporary files may be left in the target directory if
install
exits abnormally.
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.
May 7, 2001 | macOS 14.6 |