xinstall(1M)      MISC. REFERENCE MANUAL PAGES       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  direc-
     tories  (dirz  ...)  are  specified after file, those direc-
     tories will be searched before the directories specified  in
     the default list.  The meanings of the options are:

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

     -f dirbForces 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, respec-
            tively.  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 dircIf file is not found in any of  the  searched  direc-
            tories, 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.



            Last change: XENIX Compatibility Package            1

xinstall(1M)      MISC. REFERENCE MANUAL PAGES       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 mes-
            sages.  May be used alone or with any other options.

SEE ALSO
     find(1), make(1)













































            Last change: XENIX Compatibility Package            2