version 1.19, 2003/06/10 09:12:13 |
version 1.20, 2004/02/06 22:21:10 |
|
|
.Op Fl g Ar group |
.Op Fl g Ar group |
.Op Fl m Ar mode |
.Op Fl m Ar mode |
.Op Fl o Ar owner |
.Op Fl o Ar owner |
.Ar file1 |
.Ar file1 ... |
\&... |
|
.Ar fileN directory |
.Ar fileN directory |
.Nm install |
.Nm install |
.Fl d |
.Fl d |
.Op Fl g Ar group |
.Op Fl g Ar group |
.Op Fl m Ar mode |
.Op Fl m Ar mode |
.Op Fl o Ar owner |
.Op Fl o Ar owner |
.Ar directory |
.Ar directory ... |
\&... |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The file(s) are moved (or copied if the |
The file(s) are moved (or copied if the |
.Fl c |
.Fl c |
|
|
.Fl b |
.Fl b |
option is given |
option is given |
or overwritten |
or overwritten |
if permissions allow, An alternate backup suffix may be specified via the |
if permissions allow. |
|
An alternate backup suffix may be specified via the |
.Fl B |
.Fl B |
option's argument. |
option's argument. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width "-B suffix" |
|
.It Fl B Ar suffix |
|
Use |
|
.Ar suffix |
|
as the backup suffix if |
|
.Fl b |
|
is given. |
.It Fl b |
.It Fl b |
Backup any existing files before overwriting them by renaming |
Backup any existing files before overwriting them by renaming |
them to |
them to |
|
|
See |
See |
.Fl B |
.Fl B |
for specifying a different backup suffix. |
for specifying a different backup suffix. |
.It Fl B Ar suffix |
|
Use |
|
.Ar suffix |
|
as the backup suffix if |
|
.Fl b |
|
is given. |
|
.It Fl C |
.It Fl C |
Copy the file. |
Copy the file. |
If the target file already exists and the files are the same, |
If the target file already exists and the files are the same, |
|
|
.It Fl d |
.It Fl d |
Create directories. |
Create directories. |
Missing parent directories are created as required. |
Missing parent directories are created as required. |
.It Fl f |
.It Fl f Ar flags |
Specify the target's file flags. |
Specify the target's file |
|
.Ar flags . |
(See |
(See |
.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 Ar group |
Specify a group. |
Specify a |
|
.Ar group . |
A numeric GID is allowed. |
A numeric GID is allowed. |
.It Fl m |
.It Fl m Ar mode |
Specify an alternate mode. |
Specify an alternate |
|
.Ar 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 Ar owner |
Specify an owner. |
Specify an |
|
.Ar owner . |
A numeric UID is allowed. |
A numeric UID is allowed. |
.It Fl p |
.It Fl p |
Preserve the modification time. |
Preserve the modification time. |
|
|
creates an empty file. |
creates an empty file. |
.Pp |
.Pp |
Upon successful completion a value of 0 is returned. |
Upon successful completion a value of 0 is returned. |
Otherwise, a value >0 is returned. |
Otherwise, a value \*(Gt0 is returned. |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width "STRIP" |
.Bl -tag -width "STRIP" |
.It Ev STRIP |
.It Ev STRIP |
|
|
.Pa /usr/bin/strip . |
.Pa /usr/bin/strip . |
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width INS@XXXXXX -compact |
.Bl -tag -width INS@XXXXXXXXXX -compact |
.It Pa INS@XXXXXX |
.It Pa INS@XXXXXXXXXX |
If either |
If either |
.Fl S |
.Fl S |
option is specified, or the |
option is specified, or the |
|
|
.Fl p |
.Fl p |
option is used in conjunction with the |
option is used in conjunction with the |
.Fl s |
.Fl s |
option, temporary files named INS@XXXXXX, |
option, temporary files named INS@XXXXXXXXXX, |
where XXXXXX is decided by |
where XXXXXXXXXX is decided by |
.Xr mkstemp 3 , |
.Xr mkstemp 3 , |
are created in the target directory. |
are created in the target directory. |
.El |
.El |