11.3 install
: Copy files and set attributes
install
copies files while setting their permission modes and, if
possible, their owner and group. Synopses:
| install [option]... source dest
install [option]... source... directory
install -d [option]... directory...
|
In the first of these, the source file is copied to the dest
target file. In the second, each of the source files are copied
to the destination directory. In the last, each directory
(and any missing parent directories) is created.
install
is similar to cp
, but allows you to control the
attributes of destination files. It is typically used in Makefiles to
copy programs into their destination directories. It refuses to copy
files onto themselves.
The program accepts the following options. Also see 2. Common options.
- `-b'
- `--backup[=method]'
-
See section 2.1 Backup options.
Make a backup of each file that would otherwise be overwritten or removed.
- `-c'
-
Ignored; for compatibility with old Unix versions of
install
.
- `-d'
- `--directory'
-
Create each given directory and any missing parent directories, setting
the owner, group and mode as given on the command line or to the
defaults. It also gives any parent directories it creates those
attributes. (This is different from the SunOS 4.x
install
, which
gives directories that it creates the default attributes.)
- `-g group'
- `--group=group'
-
Set the group ownership of installed files or directories to
group. The default is the process' current group. group
may be either a group name or a numeric group id.
- `-m mode'
- `--mode=mode'
-
Set the permissions for the installed file or directory to mode,
which can be either an octal number, or a symbolic mode as in
chmod
, with 0 as the point of departure (see section 26. File permissions). The default mode is `u=rwx,go=rx'---read, write,
and execute for the owner, and read and execute for group and other.
- `-o owner'
- `--owner=owner'
-
If
install
has appropriate privileges (is run as root), set the
ownership of installed files or directories to owner. The default
is root
. owner may be either a user name or a numeric user
ID.
- `-p'
- `--preserve-timestamps'
-
Set the time of last access and the time of last modification of each
installed file to match those of each corresponding original file.
When a file is installed without this option, its last access and
last modification times are both set to the time of installation.
This option is useful if you want to use the last modification times
of installed files to keep track of when they were last built as opposed
to when they were last installed.
- `-s'
- `--strip'
-
Strip the symbol tables from installed binary executables.
- `-S suffix'
- `--suffix=suffix'
-
Append suffix to each backup file made with `-b'.
See section 2.1 Backup options.
- `--target-directory=directory'
-
Specify the destination directory.
See section 2.3 Target directory.
- `-v'
- `--verbose'
-
Print the name of each file before copying it.
- `-V method'
- `--version-control=method'
-
Change the type of backups made with `-b'. The method
argument can be `none' (or `off'), `numbered' (or
`t'), `existing' (or `nil'), or `never' (or
`simple'). See section 2.1 Backup options.
This document was generated
by Jeff Bailey on December, 28 2002
using texi2html