INSTALL(1M)              DOMAIN/IX SYS5               INSTALL(1M)



NAME
     install - install commands

USAGE
     /etc/install [-c dira] [-f dirb] [-i] [-n dirc] [-o] [-s]
     file [dirx...]

DESCRIPTION
     Install is a command most commonly used in ``makefiles''
     (see make(1)) to install a file (updated target file) in a
     specific place within a file system.  Install copies each
     file into the appropriate directory, retaining the mode and
     owner of the original command.  The program prints messages
     telling you exactly which files it is replacing or creating
     and where they are going.

     If no options or directories (dirx ...) are specified,
     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 install finds the
     file, it issues a message saying that it is overwriting that
     file with file, then proceeds to do so.  If install can not
     find file, it states this and exits without any further
     action.

     If one or more directory names (dirx ...) are specified
     after file, install searches those directories before it
     searches directories specified in the default list.

OPTIONS
     The options are:

          -c  dira       installs a new command (file) in the
                         directory specified by dira, only if
                         file does not already exist there.  If
                         it is there, 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.

          -f  dirb       forcibly installs file in dirb, whether
                         or not it already exists there.  If file
                         does not exist, mode and owner will be
                         set to 755 and bin, respectively.  If
                         the file already exists, the mode and
                         owner of the new file will be the same
                         as that of the existing file.  This
                         option may be used alone or with the -o
                         or -s options.



Printed 12/4/86                                         INSTALL-1

INSTALL(1M)              DOMAIN/IX SYS5               INSTALL(1M)



          -i             ignores the default directory list,
                         searching only through the given direc-
                         tories (dirx ...).  This may be used
                         alone or with any other option but the
                         -c or -f options.

          -n  dirc       puts file in dirc, if it is not found in
                         any of the searched directories.  The
                         mode and owner of file are set to 755
                         and bin, respectively.  This option may
                         be used alone or with any other options
                         except -c and -f.

          -o             saves the previous copy of a file that
                         was found by copying it to OLDfile in
                         the directory in which it was found,
                         before installing the newest version of
                         file.  This option is useful when
                         installing a new version of a busy com-
                         mand like /bin/sh, where the existing
                         file cannot be removed.  This option may
                         be combined  with any other options
                         except -c.

          -s             suppresses the printing of messages
                         other than error messages.  It may be
                         combined with other options.

RELATED INFORMATION
     make(1)























INSTALL-2                                         Printed 12/4/86