System Administration 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 destina-
tion 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.
SunOS 5.11 Last change: 3 Nov 2005 1
System Administration Commands install(1M)
Note that if the ROT environment variable is set, each of
the default directory paths are prefixed by its value (for
example, $ROT/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 compati-
ble 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 speci-
fied in dirc. The mode and owner of the new file
is set to 755 and bin, respectively.
SunOS 5.11 Last change: 3 Nov 2005 2
System Administration Commands install(1M)
-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 instal-
ling 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).
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 3 Nov 2005 3
System Administration Commands install(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
SEE ALSO
chgrp(1), chmod(1), chown(1), cp(1), install(1B), make(1S),
mkdir(1), attributes(5), largefile(5)
SunOS 5.11 Last change: 3 Nov 2005 4
|
