install(1M)                                           install(1M)



NAME
     install - places files in specified directories

SYNOPSIS
     install [-c dira] [-f dirb] [-g group] [-i] [-m mode]
     [-n dirc] [-o] [-s] [-u user] file [dirx]...

     install [-c dira] [-s] file [dirx]...

     install [-f dirb] [-o] [-s] file [dirx]...

     install [-g group] [-i] [-m mode] [-n dirc] [-o] [-s]
     [-u user] file [dirx]...

ARGUMENTS
     -c dira
          Installs a new command (file) in the directory
          specified by dira, only if a file with the same name is
          not found.  If it is found, install issues a message
          saying that file already exists, and exits without
          overwriting it.  This option may be used alone or with
          the -s option.

     dirx Specifies the directory to be searched before the
          directories specified in the default list.  The default
          list is:  /bin, /usr/bin, /etc, /lib, and /usr/lib, in
          that order.

     -f dirb
          Forces file to be installed in given directory (dirb),
          whether or not a file by the same name already exists.
          If the file already exists, the mode and ownership of
          the file is that of the already existing file.  This
          option may be used alone or with the -o or -s option.

     file Specifies the file to be installed.  If file is not
          found, the program states this and exits without
          further action.

     -g group
          Uses the specified group ID instead of the default,
          bin, when setting the ownership of files that do not
          already exist.

     -i   Ignores the default directory list, searching only
          through the given directories (dirx...).  This option
          may be used alone or with any other options except -c
          and -f.

     -m mode
          Uses the specified mode instead of the default, 775,
          when setting the mode of files that do not already



January 1992                                                    1

install(1M)                                           install(1M)



          exist.

     -n dirc
          Puts file in the directory specified in dirc, if file
          is not found in any of the searched directories.  This
          option may be used alone or with any other options
          except -c and -f.

     -o   Saves the ``found'' file by copying it to OLDfile in
          the directory in which it was found, if file is found.
          This option is useful when installing a normally text-
          busy file such as /bin/sh or /etc/getty, where the
          existing file cannot be removed.  This option may be
          used alone or with any other options except -c.

     -s   Suppresses the printing of messages other than error
          messages.  This option may be used alone or with any
          other options.

     -u user
          Uses the specified user ID instead of the default, bin,
          when setting the ownership of files that do not already
          exist.

DESCRIPTION
     install is a command most commonly used in ``makefiles''
     (see make(1)) to install file as an updated target file in a
     specific place within a file system.  Each file is installed
     by copying it into the appropriate directory, thereby
     retaining the mode and owner of the original command.  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 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 then it proceeds to do so.

FILES
     /etc/install
          Executable file

SEE ALSO
     cpset(1M)

     make(1), chown(1), chmod(1) in A/UX Command Reference







2                                                    January 1992