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 own-
ership of the installed file with the -u or -g
options. If you are not the super-user, the installed
file will be owned by you, regardless of who owns the
original.
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 direc-
tories, 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 avail-
able 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 mes-
sages.
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).
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
chgrp(1), chmod(1), chown(1), cp(1), make(1S), mkdir(1),
chown(1M), attributes(5), largefile(5)
Man(1) output converted with
man2html