NAME

Install − install commands

SYNOPSIS

/etc/Install [−c dira] [−f dirb] [−i] [−n dirc] [−m mode] [−u user] [−g group] [−o] [−s] [−F dirb] [−dir] [−ln source] [−lns source] [−src source] [−idb idbattr] filelist [dirx ...]

DESCRIPTION

The Install command is most commonly used in “makefiles” [See make(1)] to install a filelist (a single updated target file or a quoted list of several target files) in a specific place within a file system.  Each file in filelist is installed by copying it into the appropriate directory, thereby retaining the mode and owner of the original command.  The files in filelist may be simple filenames in the current directory or relative pathnames containing directory components.  In the latter case, the directory components will be created with default mode and ownership if they do not exist already in the target tree.  The program prints messages telling the user exactly what files it is replacing or creating and where they are going. 

If no options or directories (dirx ...) are given, Install will search a set of default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the same name as the current file in filelist. When the first occurrence is found, Install issues a message saying that it is overwriting that file with the current 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 (dirx ...) are specified after filelist, those directories will be searched before the directories specified in the default list. In any case the target directory selected will be prefixed by the value of the environment variable ROOT. 

Unless otherwise specified, the −idb option may be used with any other options.  The meanings of the options are:

−c  dira Installs new commands (filelist) in the directory specified by dira, only if they are not found. If any file in filelist is found, Install issues a message saying that the file already exists, and exits without overwriting it.  May be used alone or with the −m, −u, −g, −s, −ln, −lns, and −src options. 

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

−i Ignores the default directory list, searching only through the given directories (dirx ...). May be used alone or with any options other than −c −f, −F, and −dir. 

−n  dirc If a file in filelist 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 options other than −c, −f, −F, and −dir. 

−m  mode The mode of the new file is set to mode. Available only to the superuser; may not be used with −f. 

−u  user The owner of the new file is set to user. Available only to the superuser; may not be used with −f. 

−g  group The group id of the new file is set to group. Available only to the superuser; may not be used with −f. 

−o If a file in filelist is found, this option saves the “found” file by copying it to OLDfile in the directory in which it was found.  This option is useful when installing a frequently used file such as /bin/sh or /etc/getty, where the existing file cannot be removed. -o may be used alone or with any options other than −c. 

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

−F dirb Like -f, but does not force mode and ownership of a new file to that of the old one if it exists in dirb. May be used with any options other than −i, −c, −f, −n, and −dir. 

−dir Takes filelist to be a list of directories to be created in the target tree.  Directory names will be prefixed with the value of the ROOT environment variable.  May be used with any options other than −i, −c, −f, −F, and −n. 

−ln source Makes hard links to the installed file source (prefixed by ROOT) from the files listed in filelist. May not be used with -f, -lns, and -src. 

−lns source Makes symbolic links to the installed file source (prefixed by ROOT) from the files listed in filelist. May not be used with -f, -ln, and -src. 

−src source Uses source as the pathname to the single source file to be installed.  This option allows renaming to be combined with installation. 

−idb idbattr Ignored by this version of Install, this option allows arbitrary attributes to be passed to an installation database initializer.

NOTES

Install is provided for compatibility with the IRIS 4D software building methods. 

SEE ALSO

make(1)
install.1m.
 
 

Version 3.6  —  December 20, 1987