version 1.30, 2016/05/13 17:51:15 |
version 1.31, 2019/02/08 12:53:44 |
|
|
Missing parent directories are created as required. |
Missing parent directories are created as required. |
This option cannot be used with the |
This option cannot be used with the |
.Fl B , b , C , c , |
.Fl B , b , C , c , |
.Fl f , p , S , |
.Fl f , p , |
or |
or |
.Fl s |
.Fl s |
options. |
options. |
|
|
then preserve the modification time of the file. |
then preserve the modification time of the file. |
.It Fl S |
.It Fl S |
Safe copy. |
Safe copy. |
Normally, |
This option has no effect and is supported only for compatibility. |
.Nm |
When installing a file, a temporary file is created and written first |
unlinks an existing target before installing the new file. |
in the destination directory, then atomically renamed. |
With the |
This avoids both race conditions and the destruction of existing |
.Fl S |
files in case of write failures. |
flag a temporary file is used and then renamed to be |
|
the target. |
|
The reason this is safer is that if the copy or |
|
rename fails, the existing target is left untouched. |
|
.It Fl s |
.It Fl s |
.Nm |
.Nm |
exec's the command |
exec's the command |
|
|
.Sh FILES |
.Sh FILES |
.Bl -tag -width INS@XXXXXXXXXX -compact |
.Bl -tag -width INS@XXXXXXXXXX -compact |
.It Pa INS@XXXXXXXXXX |
.It Pa INS@XXXXXXXXXX |
If either |
Temporary files created in the target directory by |
.Fl S |
.Xr mkstemp 3 . |
option is specified, or the |
|
.Fl C |
|
or |
|
.Fl p |
|
option is used in conjunction with the |
|
.Fl s |
|
option, temporary files named INS@XXXXXXXXXX, |
|
where XXXXXXXXXX is decided by |
|
.Xr mkstemp 3 , |
|
are created in the target directory. |
|
.El |
.El |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std install |
.Ex -std install |