1 .\" Copyright (c) 1987, 1990, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. Neither the name of the University nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" From: @(#)install.1 8.1 (Berkeley) 6/6/93
29 .\" $FreeBSD: src/usr.bin/xinstall/install.1,v 1.16.2.9 2002/07/01 21:01:23 des Exp $
57 .Ar file1 ... fileN directory
68 The file(s) are copied
69 to the target file or directory.
70 If the destination is a directory, then the
74 with its original filename.
75 If the target file already exists, it is
83 An alternate backup suffix may be specified via the
87 The options are as follows:
88 .Bl -tag -width indent
90 Back up any existing files before overwriting them by renaming
95 for specifying a different backup suffix.
99 as the backup suffix if
104 If the target file already exists and the files are the same,
105 then don't change the modification time of the target.
108 This is actually the default.
111 option is only included for backwards compatibility.
114 Missing parent directories are created as required.
118 (top of the file hierarchy) that the items are installed into.
119 This option is implemented for compatibility with the
125 Specify the target's file flags; see
127 for a list of possible flags and their meanings.
130 A numeric GID is allowed.
134 option is specified and the owner or group cannot be found, fallback to
140 Specify an alternate mode.
141 The default mode is set to rwxr-xr-x (0755).
142 The specified mode may be either an octal or symbolic value; see
144 for a description of possible mode values.
146 Use the user database text file
148 and group database text file
152 rather than using the results from the system's
156 (and related) library calls.
159 A numeric UID is allowed.
161 Preserve the modification time.
162 Copy the file, as if the
164 (compare and copy) option is specified,
165 except if the target file doesn't already exist or is different,
166 then preserve the modification time of the file.
171 unlinks an existing target before installing the new file.
174 flag a temporary file is used and then renamed to be
176 The reason this is safer is that if the copy or
177 rename fails, the existing target is left untouched.
182 to strip binaries so that
184 can be portable over a large
185 number of systems and binary types.
189 is running unprivileged, and that it should not try to change
190 the owner, the group, or the file flags of the destination.
195 showing files as they are installed or backed up.
200 preserves all file flags, with the exception of the
206 utility attempts to prevent moving a file onto itself.
210 creates an empty file.
214 utility checks for the presence of the
216 environment variable and if present,
217 uses the assigned value as the program to run if and when the
219 option has been specified.
223 environment variable is present,
225 will ignore any specification of the
228 This is mainly for use in debugging the
233 .Bl -tag -width INS@XXXX -compact
237 option is specified, or the
241 option is used in conjunction with the
243 option, temporary files named
249 are created in the target directory.
256 moved files by default.
257 The default was changed to copy in
276 Temporary files may be left in the target directory if
280 File flags cannot be set by
282 over a NFS filesystem. Other filesystems do not have a concept of flags.
285 utility will only warn when flags could not be set on a filesystem
286 that does not support them.
292 falsely says a file is copied when