install(1) install(1)
NAME
install - install files
SYNOPSIS
/usr/sbin/install [option...] file [directory...]
DESCRIPTION
The install command 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 com-
mand. The program prints messages telling the user exactly what files
it is replacing or creating and where they are going.
If no options or directories are specified, install will search a set
of default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in
that order) for a file with the name file. If a file is found, install
issues a message saying that it is overwriting that file with file. If
no file is found, the program states this and exits without further
action.
If a directory or directories are specified after file, those direc-
tories will be 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 that the file already exists, and
exits without overwriting it. May be used alone or with the
-s option.
-f dirb Forces file to be installed in given directory, whether or
not one already exists. If the file being installed does not
already exist, the mode and owner of the new file will be
set to 755 and bin, respectively. If the file already
exists, the mode and owner will be that of the already
existing file. May be used alone or with the -o or -s
options.
-i Ignores default directory list, searching only through the
specified
directories. May be used 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 will be set to 755 and bin, respec-
tively. May be used alone or with any other options except
-c and -f.
Page 1 Reliant UNIX 5.44 Printed 11/98
install(1) install(1)
-m mode The mode of the new file is set to mode.
-u user The owner of the new file is set to user.
-g group The group id of the new file is set to group. Only available
to the superuser.
-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 installing a frequently
used file such as /bin/sh or /lib/saf/ttymon, where the
existing file cannot be removed. May be used alone or with
any other options except -c.
-s Suppresses printing of messages other than error messages.
May be used alone or with any other options.
SEE ALSO
make(1).
Page 2 Reliant UNIX 5.44 Printed 11/98