install(ADM)


install -- install commands

Syntax

/etc/install [ -s ] [ -o ] [ -n dirn ] [ -m mode ] [ -u user ] [ -g group ] file [ dir ... ]

/etc/install [ -s ] [ -o ] [ -i ] [ -n dirn ] [ -m mode ] [ -u user ] [ -g group ] file dir ...

/etc/install [ -s ] [ -o ] [ -f dirf ] [ -m mode ] [ -u user ] [ -g group ] file [ dir ... ]

/etc/install [ -s ] [ -c dirc ] [ -m mode ] [ -u user ] [ -g group ] file [ dir ... ]

Description

The install command is most commonly used in ``makefiles'' (see make(CP)) 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 what files it is replacing or creating and where they are going.

If no options or directories (dir ...) are given, install 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 (dir ...) are specified after file, those directories will be searched before the directories specified in the default list.

The meanings of the options are:


-c dirc
Installs a new command (file) in the directory specified by dirc if it is not already present there. If it is found, install issues a message saying that the file already exists, and exits without overwriting it. May be used with the -s option.

-f dirf
Forces file to be installed in the given directory dirf, whether or not the file 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 existing file. May be used with the -o or -s options.

-i
Ignores default directory list, searching only through the given directories (dir ...) May be used with any other options except -c and -f.

-n dirn
If file is not found in any of the searched directories, it is put in the directory specified in dirn. The mode and owner of the new file will be set to 755 and bin, respectively. May be used with any other options except -c and -f.

-o
If file is found, this option saves it by copying it to the file OLDfile in the directory in which it was found. This option is useful when installing a frequently used file such as /bin/sh or /etc/getty, where the existing file cannot be removed. May be used with any other options except -c.

-s
Suppresses printing of messages other than error messages. May be used with any other options.
The following options are only available to the super user and may be used with all other options:

-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.

See also

make(CP)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005