install(1M) install(1M)NAME install - install files in specified directories SYNOPSIS /etc/install [-c dira] [-f dirb] [-g group] [-i] [-m mode] [-n dirc] [-o] [-s] [-u user] file [dirx...] DESCRIPTION install is a command most commonly used in ``makefiles'' (see make(1)) to install file as an updated target file in a specific place within a file system. Each file is installed by copying it into the appropriate directory, thereby re- taining the mode and owner of the original command. The program prints messages telling the user exactly what files it is replacing or creating and where they are going. If no flag options or directories (dirx...) are given, in- stall searches a set of default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the same name as file. When the first occurrence is found, in- stall issues a message saying that it is overwriting that file with file, and then it 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 file, those directories are searched before the directories specified in the default list. FLAG OPTIONS The following flag options are interpreted by install: -c dira Install a new command (file) in the directory specified by dira, only if a file with the same name is not found. If it is found, install is- sues a message saying that file already exists, and exits without overwriting it. This flag op- tion may be used alone or with the -s flag op- tion. -f dirb Force file to be installed in given directory, whether or not a file by the same name already exists. If the file already exists, the mode and ownership of the file is that of the already ex- isting file. This flag option may be used alone or with the -o or -s flag option. -gOgroup Use the specified group ID instead of the de- fault, bin, when setting the ownership of files that do not already exist. -i Ignore the default directory list, searching only April, 1990 1
install(1M) install(1M)through the given directories (dirx...). This flag option may be used alone or with any other flag options other than -c and -f. -mOmode Use the specified mode instead of the default, 775, when setting the mode of files that do not already exist. -n dirc Put file in the directory specified in dirc if file is not found in any of the searched direc- tories. This flag option may be used alone or with any other flag options other than -c and -f. -o If file is found, save the ``found'' file by copying it to OLDfile in the directory in which it was found. This flag option is useful when installing a normally text-busy file such as /bin/sh or /etc/getty, where the existing file cannot be removed. This flag option may be used alone or with any other flag options other than -c. -s Suppress the printing of messages other than er- ror messages. This flag option may be used alone or with any other flag options. -u user Use the specified user ID instead of the default, bin, when setting the ownership of files that do not already exist. FILES /etc/install SEE ALSO cpset(1M), make(1), chown(1), chgrp(1), chmod(1). 2 April, 1990