[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    install(1M) manual page Table of Contents

Name

install - install commands

Synopsis

/usr/sbin/install -c dira [ -m mode ] [ -u user ] [ -g group ] [ -o ] [ -s ] file
/usr/sbin/install -f dirb [ -m mode ] [ -u user ] [ -g group ] [ -o ] [ -s ] file
/usr/sbin/install -n dirc [ -m mode ] [ -u user ] [ -g group ] [ -o ] [ -s ] file
/usr/sbin/install -d|-i [ -m mode ] [ -u user ] [ -g group ] [ -o ] [ -s ] dirx ...
/usr/sbin/install [ -m mode ] [ -u user ] [ -g group ] [ -o ] [ -s ] file [ dirx ... ]

Availability

SUNWcsu

Description

install is most commonly used in ‘‘makefiles’’ (see make(1S) ) to install a file in specific locations, or to create directories within a file system. Each file is installed by copying it into the appropriate directory.

install uses no special privileges to copy files from one place to another. The implications of this are:

install prints messages telling the user 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.

If one or more directories (dirx ...) are specified after file, those directories are searched before the default directories.

Options

-c dira
Install file in the directory specified by dira, if file does not yet exist. If it is found, install issues a message saying that the file already exists, and exits without overwriting it.
-f dirb
Force file to be installed in given directory, even if 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 already existing file.
-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, respectively.
-d
Create a directory. Missing parent directories are created as required as in mkdir -p. If the directory already exists, the owner, group and mode will be set to the values given on the command line.
-i
Ignore default directory list, searching only through the given directories (dirx ...).
-m mode
The mode of the new file is set to mode. Set to 0755 by default.
-u user
The owner of the new file is set to user. Only available to the super-user. Set to bin by default.
-g group
The group id of the new file is set to group. Only available to the super-user. Set to bin by default.
-o
If file is found, save the ‘‘found’’ file by copying it to OLD file 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.
-s
Suppress printing of messages other than error messages.

See Also

chgrp(1) , chmod(1) , chown(1) , cp(1) , make(1S) , mkdir(1) , chown(1M)


Table of Contents