INSTALL(1M) INSTALL(1M)
NAME
install - install commands
SYNOPSIS
/etc/install [-c dira] [-f dirb] [-i] [-n dirc] [-m mode]
[-u user] [-g group] [-o] [-s] [-F dirb] [-dir] [-ln source]
[-lns source] [-src source] [-idb idbattr] filelist [dirx
...]
DESCRIPTION
The install command is most commonly used in ``makefiles''
[See make(1)] to install a filelist (a single updated target
file or a quoted list of several target file) in a specific
place within a file system. Each file in filelist is
installed by copying it into the appropriate directory,
thereby retaining the mode and owner of the original
command. The files in filelist may be simple filenames in
the current directory or relative pathnames containing
directory components. In the latter case, the directory
components will be created with default mode and ownership
if they do not exist already in the target tree. 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 (dirx ...) 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 the current file in filelist. When the first
occurrence is found, install issues a message saying that it
is overwriting that file with the current 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 (dirx ...) are specified after
filelist, those directories will be searched before the
directories specified in the default list. In any case the
target directory selected will be prefixed by the value of
the environment variable ROOT.
Unless otherwise specified, the -idb option may be used with
any other options. The meanings of the options are:
-c dira Installs new commands (filelist) in the
directory specified by dira, only if
they are not found. If any file in
filelist is found, install issues a
message saying that the file already
exists, and exits without overwriting
it. May be used alone or with the -m,
-u, -g, -s, -ln, -lns, and -src options.
-f dirb Forces files in filelist to be installed
Page 1 (last mod. 8/20/87)
INSTALL(1M) INSTALL(1M)
in the given directory, whether or not
they already exist. If a 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. May be used alone or
with the -o or -s options.
-i Ignores the default directory list,
searching only through the given
directories (dirx ...). May be used
alone or with any options other than -c
-f, -F, and -dir.
-n dirc If a file in filelist 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.
May be used alone or with any options
other than -c, -f, -F, and -dir.
-m mode The mode of the new file is set to mode.
Available only to the superuser; may not
be used with -f.
-u user The owner of the new file is set to
user. Available only to the superuser;
may not be used with -f.
-g group The group id of the new file is set to
group. Available only to the superuser;
may not be used with -f.
-o If a file in filelist is found, this
option saves 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 /etc/getty,
where the existing file cannot be
removed. -o may be used alone or with
any options other than -c.
-s Suppresses printing of messages other
than error messages. May be used alone
or with any other options.
-F dirb Like -f, but does not force mode and
ownership of a new file to that of the
Page 2 (last mod. 8/20/87)
INSTALL(1M) INSTALL(1M)
old one if it exists in dirb. May be
used with any options other than -i, -c,
-f, -n, and -dir.
-dir Takes filelist to be a list of
directories to be created in the target
tree. Directory names will be prefixed
with the value of the ROOT environment
variable. May be used with any options
other than -i, -c, -f, -F, and -n.
-ln source Makes hard links to the installed file
source (prefixed by ROOT) from the files
listed in filelist. May not be used
with -f, -lns, and -src.
-lns source Makes symbolic links to the installed
file source (prefixed by ROOT) from the
files listed in filelist. May not be
used with -f, -ln, and -src.
-src source Uses source as the pathname to the
single source file to be installed.
This option allows renaming to be
combined with installation.
-idb idbattr Ignored by this version of install, this
option allows arbitrary attributes to be
passed to an installation database
initializer.
SEE ALSO
make(1).
ORIGIN
AT&T V.3
Page 3 (last mod. 8/20/87)