source ... target ...
file(s) are copied to the
file or directory. If the
file already exists, it is either
renamed to file.old
option is given or overwritten if permissions
allow. An alternate backup suffix may be specified via the
option's argument. If the
option is given,
directories are created, and no files
The options are as follows:
- Use suffix as the backup
suffix if -b is given.
- Backup any existing files before overwriting them by
renaming them to file.old. See
-B for specifying a different backup
- Copy the file. If the target file already exists and the
files are the same, then don't change the modification time of the
- Copy the file. This is actually the default. The
-c option is only included for backwards
- Create all leading components of the target before
installing into it.
- Create directories. Missing parent directories are created
as required. This option cannot be used with the
-S, or -s
- Flush the file's contents to disk. When copying a file, use
the fsync(2) function to
synchronize the installed file's contents with the on-disk version.
- Specify the target's file
chflags(1) for a list of
possible flags and their meanings.)
- Specify a group. A numeric
GID is allowed.
- 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.
- Specify an owner. A
numeric UID is allowed.
- 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 modification time of the file.
- Safe copy. Normally, 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.
- install exec's the command
/usr/bin/strip to strip binaries so that
install can be portable over a large number of systems and binary types.
If the environment variable
set, it is used instead.
By default, install
preserves all file flags, with
the exception of the “nodump” flag.
utility attempts to prevent moving a
file onto itself.
creates an empty file.
- For an alternate
strip(1) program to run.
Default is /usr/bin/strip.
- If either -S option is
specified, or the -C or
-p option is used in conjunction with the
-s option, temporary files named
INS@XXXXXXXXXX, where XXXXXXXXXX is decided by
mkstemp(3), are created in
the target directory.
utility exits 0 on success,
and >0 if an error occurs.
utility appeared in
flags are non-standard and should not be
relied upon for portability.
Temporary files may be left in the target directory if