xinstall(1M)           (XENIX Compatibility Package)           xinstall(1M)


   NAME
         xinstall - installs 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.





   8/91                                                                 Page 1

   xinstall(1M)           (XENIX Compatibility Package)           xinstall(1M)


        -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.

        -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                                                                 8/91