install(8) CLIX install(8)
NAME
install - Installs commands
SYNOPSIS
/etc/install [-c dira] [-f dirb] [-i] [-n dirc] [-m mode] [-u user] [-g
group] [-o] [-s] file [dirx ... ]
FLAGS
Users can customize the install program by using the following flags:
-c dira If the file has not been located, this flag installs a new
command (file) in the directory specified by dira. If it is
found, then install issues a message saying that the file
already exists, and exits without overwriting it. This flag
may be used alone or with the -s flag.
-f dirb Forces file to be installed in a 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. This
flag nay be used alone or with the -o or -s flags.
-i This flag ignores the default directory list, searching only
through given directories (dirx). The -i flag may be used
alone or with any other flags except the -c and -f flags.
-n dirc If the 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, respectively. This
flag may be used alone or with any other flags except the -c
and -f flags.
-m mode The mode of the new file is set to mode and is only made
available to the superuser.
-u user The owner of the new file is set to user and is only available
to the superuser.
-g group The group ID of the new file is set to group and is only
available to the superuser.
-o If the file is found, this flag saves the ``found'' file by
copying it to oldfile in the directory in which it was found.
This flag is useful when installing a frequently used file such
as /bin/sh or /etc/getty, where the existing file cannot be
removed. This flag may be used alone or with any other flags
except -c.
2/94 - Intergraph Corporation 1
install(8) CLIX install(8)
-s Suppresses displaying of messages other than error messages.
May be used alone or with any other flags.
DESCRIPTION
The install command is most commonly used in makefiles to install a file
(updated target file) in a specific place within a file system. (See
make). Each file is installed by copying it into the appropriate
directory, thereby retaining the mode and owner of the original command.
The program displays messages telling the user exactly what files it is
replacing or creating and where they are going.
If no flags or directories (dirx) are given, the install command will
search 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 (dirx) are specified after file, those
directories will be searched before the directories specified in the
default list.
EXAMPLES
1. To locates the file util on one of the default directories, and copy
it with a move of 755 and the user and group set to bin:
install -m 755 -u bin -g bin util
2. To put the file util into the named directory, copying any existing
file named util in the directory to the file named oldutil:
install -f /usr/special/bin -o util
DIAGNOSTICS
file was not found anywhere!
The file to be installed was not found in any of the search
directories, and the -f or -c flag was not used.
EXIT VALUES
2 The given file could not be installed.
0 Installation was successful.
RELATED INFORMATION
2 Intergraph Corporation - 2/94
install(8) CLIX install(8)
Commands: make(1)
2/94 - Intergraph Corporation 3