xinstall(1M)   UNIX System V(Application Compatibility Package)    xinstall(1M)


NAME
      xinstall - install commands

SYNOPSIS
      xinstall [-c dira] [-f dirb] [-n dirc] [-o] [-a] file [dirz . . .]

DESCRIPTION
      xinstall is a command most commonly used in "makefiles" [see make(CP)] to
      xinstall a file (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
      file.  The program prints messages telling you exactly what files it is
      replacing or creating and where they are going.

      If no options or directories (dirz . . .) are given, xinstall will search
      [using find(C)] a set of default directories (/usr/bin/usr/usr/bin, /etc,
      /usr/lib, and /usr/usr/lib, in that order) for a file with the same name
      as file.  When the first occurrence is found, xinstall 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 without
      further action.

      If one or more directories (dirz . . .) are specified after file, those
      directories will be searched before the directories specified in the
      default list.

      The meanings of the options are:

     -c dira
             Installs a new command file in the directory specified in dira.
             Looks for file in dira and xinstalls it there if it is not found.
             If it is found, xinstall issues a message saying that the file
             already exists, and exits without overwriting it.  May be used
             alone or with the -s option.

     -f dirb
             Forces file to be installed in given directory, whether or not one
             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 exists, the mode and owner will be
             that of the existing file.  May be used alone or with the -o or -s
             options.

     -1     Ignores default directory list, searching only through the given
             directories (dirz . . .).  May be used alone or with any other
             options except -c and -f.

     -n dirc
             If file 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 other options except -c and -f.


10/89                                                                    Page 1

xinstall(1M)   UNIX System V(Application Compatibility Package)    xinstall(1M)


     -o     If file is found, this option saves the "found" file by copying it
             to oldfile in the directory in which is was found.  May be used
             alone or with any other options except -c.

     -s     Suppresses printing of messages other than error messages.  May be
             used alone or with any other options.

SEE ALSO
      find(1), make(1)













































Page 2                                                                    10/89