INSTALL(1M) Maintenance Commands INSTALL(1M)


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


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:

o You must have permission to read the files to be installed.

o You must have permission to copy into the destination
directory.

o You must have permission to change the modes on the final copy
of the file if you want to use the -m option.

o You must be super-user if you want to specify the ownership of
the installed file with the -u or -g options. If you are not
the super-user, the installed file is owned by you, regardless
of who owns the original.


Note that if the ROOT environment variable is set, each of the default
directory paths are prefixed by its value (for example, $ROOT/bin and so
on).


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.


This version of install (/usr/sbin/install) is not compatible with the
install binaries in many versions of Unix other than Solaris. For a
higher degree of compatibility with other Unix versions, use
/usr/ucb/install, which is described in the install(1B) man page.

OPTIONS


The following options are supported:

-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 is set to
755 and bin , respectively. If the file already exists, the
mode and owner is 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 is 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 is 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
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.


-s
Suppress printing of messages other than error messages.


USAGE


See largefile(5) for the description of the behavior of install when
encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).

SEE ALSO


chgrp(1), chmod(1), chown(1), cp(1), install(1B), make(1S), mkdir(1),
attributes(5), largefile(5)


November 3, 2005 INSTALL(1M)