2
# install - install a program, script, or datafile
4
scriptversion=2004-04-01.17
6
# This originates from X11R5 (mit/util/scripts/install.sh), which was
7
# later released in X11R6 (xc/config/util/install.sh) with the
8
# following copyright and license.
10
# Copyright (C) 1994 X Consortium
12
# Permission is hereby granted, free of charge, to any person obtaining a copy
13
# of this software and associated documentation files (the "Software"), to
14
# deal in the Software without restriction, including without limitation the
15
# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
16
# sell copies of the Software, and to permit persons to whom the Software is
17
# furnished to do so, subject to the following conditions:
19
# The above copyright notice and this permission notice shall be included in
20
# all copies or substantial portions of the Software.
22
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
23
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
25
# X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
26
# AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNEC-
27
# TION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29
# Except as contained in this notice, the name of the X Consortium shall not
30
# be used in advertising or otherwise to promote the sale, use or other deal-
31
# ings in this Software without prior written authorization from the X Consor-
35
# FSF changes to this file are in the public domain.
37
# Calling this script install-sh is preferred over install.sh, to prevent
38
# `make' implicit rules from creating a file called install from it
39
# when there is no Makefile.
41
# This script is compatible with the BSD install script, but was written
42
# from scratch. It can only install one file at a time, a restriction
43
# shared with many OS's install programs.
45
# set DOITPROG to echo to test this script
47
# Don't use :- since 4.3BSD and earlier shells don't like it.
50
# put in absolute paths if you don't have them in your path; or use env. vars.
54
chmodprog="${CHMODPROG-chmod}"
55
chownprog="${CHOWNPROG-chown}"
56
chgrpprog="${CHGRPPROG-chgrp}"
57
stripprog="${STRIPPROG-strip}"
59
mkdirprog="${MKDIRPROG-mkdir}"
64
chmodcmd="$chmodprog 0755"
74
usage="Usage: $0 [OPTION]... SRCFILE DSTFILE
75
or: $0 [OPTION]... SRCFILES... DIRECTORY
76
or: $0 -d DIRECTORIES...
78
In the first form, install SRCFILE to DSTFILE, removing SRCFILE by default.
79
In the second, create the directory path DIR.
83
-c copy source (using $cpprog) instead of moving (using $mvprog).
84
-d create directories instead of installing files.
85
-g GROUP $chgrp installed files to GROUP.
86
-m MODE $chmod installed files to MODE.
87
-o USER $chown installed files to USER.
88
-s strip installed files (using $stripprog).
90
--help display this help and exit.
91
--version display version info and exit.
93
Environment variables override the default commands:
94
CHGRPPROG CHMODPROG CHOWNPROG CPPROG MKDIRPROG MVPROG RMPROG STRIPPROG
97
while test -n "$1"; do
99
-b=*) transformbasename=`echo $1 | sed 's/-b=//'`
111
-g) chgrpcmd="$chgrpprog $2"
116
--help) echo "$usage"; exit 0;;
118
-m) chmodcmd="$chmodprog $2"
123
-o) chowncmd="$chownprog $2"
128
-s) stripcmd=$stripprog
132
-t=*) transformarg=`echo $1 | sed 's/-t=//'`
136
--version) echo "$0 $scriptversion"; exit 0;;
138
*) # When -d is used, all remaining arguments are directories to create.
139
test -n "$dir_arg" && break
140
# Otherwise, the last argument is the destination. Remove it from $@.
143
if test -n "$dstarg"; then
144
# $@ is not empty: it contains at least $arg.
145
set fnord "$@" "$dstarg"
155
if test -z "$1"; then
156
if test -z "$dir_arg"; then
157
echo "$0: no input file specified." >&2
160
# It's OK to call `install-sh -d' without argument.
161
# This can happen when creating conditional directories.
167
# Protect names starting with `-'.
172
if test -n "$dir_arg"; then
176
if test -d "$dst"; then
183
# Waiting for this to be detected by the "$instcmd $src $dsttmp" command
184
# might cause directories to be created, which would be especially bad
185
# if $src (and thus $dsttmp) contains '*'.
186
if test ! -f "$src" && test ! -d "$src"; then
187
echo "$0: $src does not exist." >&2
191
if test -z "$dstarg"; then
192
echo "$0: no destination specified." >&2
197
# Protect names starting with `-'.
202
# If destination is a directory, append the input filename; won't work
203
# if double slashes aren't ignored.
204
if test -d "$dst"; then
205
dst=$dst/`basename "$src"`
209
# This sed command emulates the dirname command.
210
dstdir=`echo "$dst" | sed -e 's,[^/]*$,,;s,/$,,;s,^$,.,'`
212
# Make sure that the destination directory exists.
214
# Skip lots of stat calls in the usual case.
215
if test ! -d "$dstdir"; then
218
IFS="${IFS-$defaultIFS}"
221
# Some sh's can't handle IFS=/ for some reason.
223
set - `echo "$dstdir" | sed -e 's@/@%@g' -e 's@^%@/@'`
228
while test $# -ne 0 ; do
231
if test ! -d "$pathcomp"; then
232
$mkdirprog "$pathcomp" || lasterr=$?
233
# mkdir can fail with a `File exist' error in case several
234
# install-sh are creating the directory concurrently. This
236
test ! -d "$pathcomp" && { (exit ${lasterr-1}); exit; }
242
if test -n "$dir_arg"; then
243
$doit $instcmd "$dst" \
244
&& { test -z "$chowncmd" || $doit $chowncmd "$dst"; } \
245
&& { test -z "$chgrpcmd" || $doit $chgrpcmd "$dst"; } \
246
&& { test -z "$stripcmd" || $doit $stripcmd "$dst"; } \
247
&& { test -z "$chmodcmd" || $doit $chmodcmd "$dst"; }
250
# If we're going to rename the final executable, determine the name now.
251
if test -z "$transformarg"; then
252
dstfile=`basename "$dst"`
254
dstfile=`basename "$dst" $transformbasename \
255
| sed $transformarg`$transformbasename
258
# don't allow the sed command to completely eliminate the filename.
259
test -z "$dstfile" && dstfile=`basename "$dst"`
261
# Make a couple of temp file names in the proper directory.
262
dsttmp=$dstdir/_inst.$$_
263
rmtmp=$dstdir/_rm.$$_
265
# Trap to clean up those temp files at exit.
266
trap 'status=$?; rm -f "$dsttmp" "$rmtmp" && exit $status' 0
267
trap '(exit $?); exit' 1 2 13 15
269
# Move or copy the file name to the temp name
270
$doit $instcmd "$src" "$dsttmp" &&
272
# and set any options; do chmod last to preserve setuid bits.
274
# If any of these fail, we abort the whole thing. If we want to
275
# ignore errors from any of these, just make sure not to ignore
276
# errors from the above "$doit $instcmd $src $dsttmp" command.
278
{ test -z "$chowncmd" || $doit $chowncmd "$dsttmp"; } \
279
&& { test -z "$chgrpcmd" || $doit $chgrpcmd "$dsttmp"; } \
280
&& { test -z "$stripcmd" || $doit $stripcmd "$dsttmp"; } \
281
&& { test -z "$chmodcmd" || $doit $chmodcmd "$dsttmp"; } &&
283
# Now rename the file to the real destination.
284
{ $doit $mvcmd -f "$dsttmp" "$dstdir/$dstfile" 2>/dev/null \
286
# The rename failed, perhaps because mv can't rename something else
287
# to itself, or perhaps because mv is so ancient that it does not
290
# Now remove or move aside any old file at destination location.
291
# We try this two ways since rm can't unlink itself on some
292
# systems and the destination file might be busy for other
293
# reasons. In this case, the final cleanup might fail but the new
294
# file should still install successfully.
296
if test -f "$dstdir/$dstfile"; then
297
$doit $rmcmd -f "$dstdir/$dstfile" 2>/dev/null \
298
|| $doit $mvcmd -f "$dstdir/$dstfile" "$rmtmp" 2>/dev/null \
300
echo "$0: cannot unlink or rename $dstdir/$dstfile" >&2
308
# Now rename the file to the real destination.
309
$doit $mvcmd "$dsttmp" "$dstdir/$dstfile"
312
fi || { (exit 1); exit; }
315
# The final little trick to "correctly" pass the exit status to the exit trap.
321
# eval: (add-hook 'write-file-hooks 'time-stamp)
322
# time-stamp-start: "scriptversion="
323
# time-stamp-format: "%:y-%02m-%02d.%02H"
324
# time-stamp-end: "$"