version 1.10, 1999/10/17 20:35:48 |
version 1.11, 2000/03/14 14:58:27 |
|
|
If the target file already exists and the files are the same, |
If the target file already exists and the files are the same, |
then don't change the modification time of the target. |
then don't change the modification time of the target. |
.It Fl c |
.It Fl c |
Copy the file. This is actually the default. The |
Copy the file. |
|
This is actually the default. |
|
The |
.Fl c |
.Fl c |
option is only included for backwards compatibility. |
option is only included for backwards compatibility. |
.It Fl d |
.It Fl d |
|
|
.Xr chflags 1 |
.Xr chflags 1 |
for a list of possible flags and their meanings.) |
for a list of possible flags and their meanings.) |
.It Fl g |
.It Fl g |
Specify a group. A numeric GID is allowed. |
Specify a group. |
|
A numeric GID is allowed. |
.It Fl m |
.It Fl m |
Specify an alternate mode. |
Specify an alternate mode. |
The default mode is set to rwxr-xr-x (0755). |
The default mode is set to rwxr-xr-x (0755). |
The specified mode may be either an octal or symbolic value; see |
The specified mode may be either an octal or symbolic value; see |
.Xr chmod 1 |
.Xr chmod 1 |
for a description of possible mode values. |
for a description of possible mode values. |
.It Fl o |
.It Fl o |
Specify an owner. A numeric UID is allowed. |
Specify an owner. |
|
A numeric UID is allowed. |
.It Fl p |
.It Fl p |
Preserve the modification time. |
Preserve the modification time. |
Copy the file, as if the |
Copy the file, as if the |
|
|
except if the target file doesn't already exist or is different, |
except if the target file doesn't already exist or is different, |
then preserve the modification time of the file. |
then preserve the modification time of the file. |
.It Fl S |
.It Fl S |
Safe copy. Normally, |
Safe copy. |
.Nm install |
Normally, |
unlinks an existing target before installing the new file. With the |
.Nm |
|
unlinks an existing target before installing the new file. |
|
With the |
.Fl S |
.Fl S |
flag a temporary file is used and then renamed to be |
flag a temporary file is used and then renamed to be |
the target. The reason this is safer is that if the copy or |
the target. |
|
The reason this is safer is that if the copy or |
rename fails, the existing target is left untouched. |
rename fails, the existing target is left untouched. |
.It Fl s |
.It Fl s |
.Nm install |
.Nm |
exec's the command |
exec's the command |
.Pa /usr/bin/strip |
.Pa /usr/bin/strip |
to strip binaries so that install can be portable over a large |
to strip binaries so that install can be portable over a large |
number of systems and binary types. If the environment variable |
number of systems and binary types. |
|
If the environment variable |
.Ev STRIP |
.Ev STRIP |
is set, it is used instead. |
is set, it is used instead. |
.El |
.El |
.Pp |
.Pp |
By default, |
By default, |
.Nm install |
.Nm |
preserves all file flags, with the exception of the ``nodump'' flag. |
preserves all file flags, with the exception of the |
|
.Dq nodump |
|
flag. |
.Pp |
.Pp |
The |
The |
.Nm install |
.Nm |
utility attempts to prevent moving a file onto itself. |
utility attempts to prevent moving a file onto itself. |
.Pp |
.Pp |
Installing |
Installing |
|
|
.Xr mkstemp 3 , |
.Xr mkstemp 3 , |
are created in the target directory. |
are created in the target directory. |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Nm |
The following environment variables affect the execution of |
utilizes the following environment variables. |
.Nm install : |
.Bl -tag -width "STRIP" |
.Bl -tag -width "STRIP" |
.It Ev STRIP |
.It Ev STRIP |
For an alternate |
For an alternate |
.Xr strip 1 |
.Xr strip 1 |
program to run. Default is |
program to run. |
|
Default is |
.Pa /usr/bin/strip . |
.Pa /usr/bin/strip . |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr chflags 1 , |
.Xr chflags 1 , |
|
|
.Xr chown 8 |
.Xr chown 8 |
.Sh HISTORY |
.Sh HISTORY |
The |
The |
.Nm install |
.Nm |
utility appeared in |
utility appeared in |
.Bx 4.2 . |
.Bx 4.2 . |
.Sh CAVEATS |
.Sh CAVEATS |
|
|
flags are non-standard and should not relied upon for portability. |
flags are non-standard and should not relied upon for portability. |
.Pp |
.Pp |
Temporary files may be left in the target directory if |
Temporary files may be left in the target directory if |
.Nm install |
.Nm |
exits abnormally. |
exits abnormally. |