INSTALL(1M) SysV INSTALL(1M)
NAME
install - install commands
SYNOPSIS
/etc/install [-c dira] [-f dirb] [-i] [-n dirc] [-m mode] [-u user] [-g
group] [-o] [-s] file[ dirx ...]
DESCRIPTION
install is most commonly used in "makefiles" [See make(1)] to install a
file (updated target file) in a specific place within a file system.
Each file is installed by copying it into the appropriate directory,
thereby retaining the mode and owner of the original command. The
program prints messages telling you exactly what files it is replacing or
creating and where they are going.
If no options or directories (dirx...) are given, install searches a set
of default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that
order) for a file with the same name as file. When the first occurrence
is found, install issues a message saying that it is overwriting that
file with file, and proceeds to do so. If the file is not found, the
program states this and exits without further action.
If one or more directories are specified after file, those directories
are searched before the directories specified in the default list.
OPTIONS
-c dira Installs a new command (file) in the directory specified by
dira, only if it is not found. If it is found, install issues
a message saying the file already exists, and exits without
overwriting it. You can use this option alone or with the -s
option.
-f dirb Forces file to be installed in the directory specified by dirb,
whether or not one already exists. If the file being installed
does not already exist, the mode and owner of the new file are
set to 755 and bin, respectively. If the file already exists,
the mode and owner are set to that of the already existing
file. You can use this option alone or with the -o or -s
options.
-i Ignores the default directory list, searching only through the
given directories (dirx...). You can use this optionn alone or
with any other options except -c and -f.
-n dirc If file is not found in any of the searched directories, it is
put in the directory specified in dirc. The mode and owner of
the new file are set to 755 and bin, respectively. You can use
this option alone or with any other options except -c and -f.
-m mode The mode of the new file is set to mode. This option is
available only to the super-user.
-u user The owner of the new file is set to user. This option is
available only to the super-user.
-g group The group id of the new file is set to group. This option is
available only to the super-user.
-o If file is found, this option saves the "found" file by copying
it to OLDfile in the directory in which it was found. This
option is useful when you install a frequently used file such
as /bin/sh or /etc/getty, where the existing file cannot be
removed. You can use this option alone or with any other
options except -c.
-s Suppresses printing of messages other than error messages. You
can use this option alone or with any other options.
SEE ALSO
make(1).