install(1M) DG/UX R4.11 install(1M)
NAME
install - install commands
SYNOPSIS
/etc/install [ -c dira] [ -f dirb] [ -g group] [ -i ] [ -m mode]
[ -n dirc] [ -o ] [ -s ] [ -u user] file [dirx ...]
DESCRIPTION
Install is a command 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 the user
exactly which files it is replacing or creating and where they are
going.
If you give no options or directories (dirx ...), 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 you specify one or more directories (dirx ...) after file, those
directories will be searched before the directories specified in the
default list.
Options are:
-c dira Install 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. This option can be used
alone or with the -s option.
-f dirb Install file 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 are set to 755
and bin, respectively. If the file already exists, the
mode and owner of the file stay the same. This option can
be used alone or with the -o or -s options.
-g group Set the group of file to group. You must have appropriate
privilege to perform this option.
-i Ignore the default directory list, searching only through
the given directories (dirx ...). This option can be used
alone or with any other options other than -c and -f.
-m mode Set the mode of file to mode. You must have appropriate
privilege to perform this option.
-n dirc Put file in directory dirc, if the file is not found in any
of the searched directories; set the mode and owner of the
new file to 755 and bin, respectively. This option can be
used alone or with any other options except -c and -f.
-o Save file, if found, by copying it to OLDfile in the
directory in which the file was found. This option is
useful when installing a normally text busy file such as
/bin/sh or /etc/getty, where the existing file cannot be
removed. May be used alone or with any other options other
than -c.
-s Suppress printing of messages other than error messages.
This option can be used alone or with any other options.
-u user Set the owner of file to user. You must have appropriate
privilege to perform this option.
SEE ALSO
chmod(1), make(1).
appropriateprivilege(5).
capdefaults(5).
NOTES
For systems supporting the DG/UX Capability Option, appropriate
privilege is defined as having one or more specific capabilities
enabled in the effective capability set of the user. See
capdefaults(5) for the default capabilities for this command.
On systems without the DG/UX Capability Option, appropriate privilege
means that your process has an effective UID of root. See the
appropriateprivilege(5) man page for more information.
Licensed material--property of copyright holder(s)