1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
|
.\" SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.Dd June 2, 2015
.Dt INSTALL-MIMIC 1
.Os
.Sh NAME
.Nm install-mimic
.Nd overwrite files preserving the destination's ownership and access mode
.Sh SYNOPSIS
.Nm
.Op Fl v
.Op Fl r Ar reffile
.Ar srcfile
.Ar dstfile
.Nm
.Op Fl v
.Op Fl r Ar reffile
.Ar file1
.Op Ar file2...
.Ar directory
.Nm
.Fl V | Fl h
.Sh DESCRIPTION
The
.Nm
utility copies the specified files to the specified destination (file or
directory) similarly to
.Xr install 1 ,
but it preserves the ownership and access mode of the destination files.
This is useful when updating files that have already been installed with
locally modified copies that may be owned by the current user and not by
the desired owner of the destination file (e.g. root).
.Pp
Options:
.Bl -tag -width indent
.It Fl h
Display program usage information and exit.
.It Fl r
Specify a file to obtain the ownership and access information from;
useful when installing a new file that should be similar to other files in
the same location.
.It Fl V
Display program version information and exit.
.It Fl v
Verbose operation; display diagnostic output.
.El
.Sh RETURN VALUES
.Ex -std
.Sh ENVIRONMENT
The
.Nm
utility's operation is currently not directly affected by its environment.
.Sh FILES
The
.Nm
utility's operation is currently not directly affected by any files.
.Sh EXAMPLES
Overwrite a system file with a local copy:
.Pp
.Dl install-mimic ./install-mimic.pl /usr/bin/install-mimic
.Pp
Overwrite several files with local copies with the same name:
.Pp
.Dl install-mimic cinder/*.py /usr/lib/python2.7/dist-packages/cinder/
.Pp
Install a new file similar to a system file:
.Pp
.Dl install-mimic -v -r /usr/bin/install-mimic install-none /usr/bin/
.Pp
.Sh HISTORY
The
.Nm
utility was written by
.An Peter Pentchev
in 2015.
.Sh AUTHORS
.An Peter Penchev
.Aq roam@ringlet.net
|