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

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