1 |
#!/bin/sh |
2 |
# install - install a program, script, or datafile |
3 |
|
4 |
scriptversion=2020-11-14.01; # UTC |
5 |
|
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. |
9 |
# |
10 |
# Copyright (C) 1994 X Consortium |
11 |
# |
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: |
18 |
# |
19 |
# The above copyright notice and this permission notice shall be included in |
20 |
# all copies or substantial portions of the Software. |
21 |
# |
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. |
28 |
# |
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- |
32 |
# tium. |
33 |
# |
34 |
# |
35 |
# FSF changes to this file are in the public domain. |
36 |
# |
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. |
40 |
# |
41 |
# This script is compatible with the BSD install script, but was written |
42 |
# from scratch. |
43 |
|
44 |
tab=' ' |
45 |
nl=' |
46 |
' |
47 |
IFS=" $tab$nl" |
48 |
|
49 |
# Set DOITPROG to "echo" to test this script. |
50 |
|
51 |
doit=${DOITPROG-} |
52 |
doit_exec=${doit:-exec} |
53 |
|
54 |
# Put in absolute file names if you don't have them in your path; |
55 |
# or use environment vars. |
56 |
|
57 |
chgrpprog=${CHGRPPROG-chgrp} |
58 |
chmodprog=${CHMODPROG-chmod} |
59 |
chownprog=${CHOWNPROG-chown} |
60 |
cmpprog=${CMPPROG-cmp} |
61 |
cpprog=${CPPROG-cp} |
62 |
mkdirprog=${MKDIRPROG-mkdir} |
63 |
mvprog=${MVPROG-mv} |
64 |
rmprog=${RMPROG-rm} |
65 |
stripprog=${STRIPPROG-strip} |
66 |
|
67 |
posix_mkdir= |
68 |
|
69 |
# Desired mode of installed file. |
70 |
mode=0755 |
71 |
|
72 |
# Create dirs (including intermediate dirs) using mode 755. |
73 |
# This is like GNU 'install' as of coreutils 8.32 (2020). |
74 |
mkdir_umask=22 |
75 |
|
76 |
backupsuffix= |
77 |
chgrpcmd= |
78 |
chmodcmd=$chmodprog |
79 |
chowncmd= |
80 |
mvcmd=$mvprog |
81 |
rmcmd="$rmprog -f" |
82 |
stripcmd= |
83 |
|
84 |
src= |
85 |
dst= |
86 |
dir_arg= |
87 |
dst_arg= |
88 |
|
89 |
copy_on_change=false |
90 |
is_target_a_directory=possibly |
91 |
|
92 |
usage="\ |
93 |
Usage: $0 [OPTION]... [-T] SRCFILE DSTFILE |
94 |
or: $0 [OPTION]... SRCFILES... DIRECTORY |
95 |
or: $0 [OPTION]... -t DIRECTORY SRCFILES... |
96 |
or: $0 [OPTION]... -d DIRECTORIES... |
97 |
|
98 |
In the 1st form, copy SRCFILE to DSTFILE. |
99 |
In the 2nd and 3rd, copy all SRCFILES to DIRECTORY. |
100 |
In the 4th, create DIRECTORIES. |
101 |
|
102 |
Options: |
103 |
--help display this help and exit. |
104 |
--version display version info and exit. |
105 |
|
106 |
-c (ignored) |
107 |
-C install only if different (preserve data modification time) |
108 |
-d create directories instead of installing files. |
109 |
-g GROUP $chgrpprog installed files to GROUP. |
110 |
-m MODE $chmodprog installed files to MODE. |
111 |
-o USER $chownprog installed files to USER. |
112 |
-p pass -p to $cpprog. |
113 |
-s $stripprog installed files. |
114 |
-S SUFFIX attempt to back up existing files, with suffix SUFFIX. |
115 |
-t DIRECTORY install into DIRECTORY. |
116 |
-T report an error if DSTFILE is a directory. |
117 |
|
118 |
Environment variables override the default commands: |
119 |
CHGRPPROG CHMODPROG CHOWNPROG CMPPROG CPPROG MKDIRPROG MVPROG |
120 |
RMPROG STRIPPROG |
121 |
|
122 |
By default, rm is invoked with -f; when overridden with RMPROG, |
123 |
it's up to you to specify -f if you want it. |
124 |
|
125 |
If -S is not specified, no backups are attempted. |
126 |
|
127 |
Email bug reports to bug-automake@gnu.org. |
128 |
Automake home page: https://www.gnu.org/software/automake/ |
129 |
" |
130 |
|
131 |
while test $# -ne 0; do |
132 |
case $1 in |
133 |
-c) ;; |
134 |
|
135 |
-C) copy_on_change=true;; |
136 |
|
137 |
-d) dir_arg=true;; |
138 |
|
139 |
-g) chgrpcmd="$chgrpprog $2" |
140 |
shift;; |
141 |
|
142 |
--help) echo "$usage"; exit $?;; |
143 |
|
144 |
-m) mode=$2 |
145 |
case $mode in |
146 |
*' '* | *"$tab"* | *"$nl"* | *'*'* | *'?'* | *'['*) |
147 |
echo "$0: invalid mode: $mode" >&2 |
148 |
exit 1;; |
149 |
esac |
150 |
shift;; |
151 |
|
152 |
-o) chowncmd="$chownprog $2" |
153 |
shift;; |
154 |
|
155 |
-p) cpprog="$cpprog -p";; |
156 |
|
157 |
-s) stripcmd=$stripprog;; |
158 |
|
159 |
-S) backupsuffix="$2" |
160 |
shift;; |
161 |
|
162 |
-t) |
163 |
is_target_a_directory=always |
164 |
dst_arg=$2 |
165 |
# Protect names problematic for 'test' and other utilities. |
166 |
case $dst_arg in |
167 |
-* | [=\(\)!]) dst_arg=./$dst_arg;; |
168 |
esac |
169 |
shift;; |
170 |
|
171 |
-T) is_target_a_directory=never;; |
172 |
|
173 |
--version) echo "$0 $scriptversion"; exit $?;; |
174 |
|
175 |
--) shift |
176 |
break;; |
177 |
|
178 |
-*) echo "$0: invalid option: $1" >&2 |
179 |
exit 1;; |
180 |
|
181 |
*) break;; |
182 |
esac |
183 |
shift |
184 |
done |
185 |
|
186 |
# We allow the use of options -d and -T together, by making -d |
187 |
# take the precedence; this is for compatibility with GNU install. |
188 |
|
189 |
if test -n "$dir_arg"; then |
190 |
if test -n "$dst_arg"; then |
191 |
echo "$0: target directory not allowed when installing a directory." >&2 |
192 |
exit 1 |
193 |
fi |
194 |
fi |
195 |
|
196 |
if test $# -ne 0 && test -z "$dir_arg$dst_arg"; then |
197 |
# When -d is used, all remaining arguments are directories to create. |
198 |
# When -t is used, the destination is already specified. |
199 |
# Otherwise, the last argument is the destination. Remove it from $@. |
200 |
for arg |
201 |
do |
202 |
if test -n "$dst_arg"; then |
203 |
# $@ is not empty: it contains at least $arg. |
204 |
set fnord "$@" "$dst_arg" |
205 |
shift # fnord |
206 |
fi |
207 |
shift # arg |
208 |
dst_arg=$arg |
209 |
# Protect names problematic for 'test' and other utilities. |
210 |
case $dst_arg in |
211 |
-* | [=\(\)!]) dst_arg=./$dst_arg;; |
212 |
esac |
213 |
done |
214 |
fi |
215 |
|
216 |
if test $# -eq 0; then |
217 |
if test -z "$dir_arg"; then |
218 |
echo "$0: no input file specified." >&2 |
219 |
exit 1 |
220 |
fi |
221 |
# It's OK to call 'install-sh -d' without argument. |
222 |
# This can happen when creating conditional directories. |
223 |
exit 0 |
224 |
fi |
225 |
|
226 |
if test -z "$dir_arg"; then |
227 |
if test $# -gt 1 || test "$is_target_a_directory" = always; then |
228 |
if test ! -d "$dst_arg"; then |
229 |
echo "$0: $dst_arg: Is not a directory." >&2 |
230 |
exit 1 |
231 |
fi |
232 |
fi |
233 |
fi |
234 |
|
235 |
if test -z "$dir_arg"; then |
236 |
do_exit='(exit $ret); exit $ret' |
237 |
trap "ret=129; $do_exit" 1 |
238 |
trap "ret=130; $do_exit" 2 |
239 |
trap "ret=141; $do_exit" 13 |
240 |
trap "ret=143; $do_exit" 15 |
241 |
|
242 |
# Set umask so as not to create temps with too-generous modes. |
243 |
# However, 'strip' requires both read and write access to temps. |
244 |
case $mode in |
245 |
# Optimize common cases. |
246 |
*644) cp_umask=133;; |
247 |
*755) cp_umask=22;; |
248 |
|
249 |
*[0-7]) |
250 |
if test -z "$stripcmd"; then |
251 |
u_plus_rw= |
252 |
else |
253 |
u_plus_rw='% 200' |
254 |
fi |
255 |
cp_umask=`expr '(' 777 - $mode % 1000 ')' $u_plus_rw`;; |
256 |
*) |
257 |
if test -z "$stripcmd"; then |
258 |
u_plus_rw= |
259 |
else |
260 |
u_plus_rw=,u+rw |
261 |
fi |
262 |
cp_umask=$mode$u_plus_rw;; |
263 |
esac |
264 |
fi |
265 |
|
266 |
for src |
267 |
do |
268 |
# Protect names problematic for 'test' and other utilities. |
269 |
case $src in |
270 |
-* | [=\(\)!]) src=./$src;; |
271 |
esac |
272 |
|
273 |
if test -n "$dir_arg"; then |
274 |
dst=$src |
275 |
dstdir=$dst |
276 |
test -d "$dstdir" |
277 |
dstdir_status=$? |
278 |
# Don't chown directories that already exist. |
279 |
if test $dstdir_status = 0; then |
280 |
chowncmd="" |
281 |
fi |
282 |
else |
283 |
|
284 |
# Waiting for this to be detected by the "$cpprog $src $dsttmp" command |
285 |
# might cause directories to be created, which would be especially bad |
286 |
# if $src (and thus $dsttmp) contains '*'. |
287 |
if test ! -f "$src" && test ! -d "$src"; then |
288 |
echo "$0: $src does not exist." >&2 |
289 |
exit 1 |
290 |
fi |
291 |
|
292 |
if test -z "$dst_arg"; then |
293 |
echo "$0: no destination specified." >&2 |
294 |
exit 1 |
295 |
fi |
296 |
dst=$dst_arg |
297 |
|
298 |
# If destination is a directory, append the input filename. |
299 |
if test -d "$dst"; then |
300 |
if test "$is_target_a_directory" = never; then |
301 |
echo "$0: $dst_arg: Is a directory" >&2 |
302 |
exit 1 |
303 |
fi |
304 |
dstdir=$dst |
305 |
dstbase=`basename "$src"` |
306 |
case $dst in |
307 |
*/) dst=$dst$dstbase;; |
308 |
*) dst=$dst/$dstbase;; |
309 |
esac |
310 |
dstdir_status=0 |
311 |
else |
312 |
dstdir=`dirname "$dst"` |
313 |
test -d "$dstdir" |
314 |
dstdir_status=$? |
315 |
fi |
316 |
fi |
317 |
|
318 |
case $dstdir in |
319 |
*/) dstdirslash=$dstdir;; |
320 |
*) dstdirslash=$dstdir/;; |
321 |
esac |
322 |
|
323 |
obsolete_mkdir_used=false |
324 |
|
325 |
if test $dstdir_status != 0; then |
326 |
case $posix_mkdir in |
327 |
'') |
328 |
# With -d, create the new directory with the user-specified mode. |
329 |
# Otherwise, rely on $mkdir_umask. |
330 |
if test -n "$dir_arg"; then |
331 |
mkdir_mode=-m$mode |
332 |
else |
333 |
mkdir_mode= |
334 |
fi |
335 |
|
336 |
posix_mkdir=false |
337 |
# The $RANDOM variable is not portable (e.g., dash). Use it |
338 |
# here however when possible just to lower collision chance. |
339 |
tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$ |
340 |
|
341 |
trap ' |
342 |
ret=$? |
343 |
rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir" 2>/dev/null |
344 |
exit $ret |
345 |
' 0 |
346 |
|
347 |
# Because "mkdir -p" follows existing symlinks and we likely work |
348 |
# directly in world-writeable /tmp, make sure that the '$tmpdir' |
349 |
# directory is successfully created first before we actually test |
350 |
# 'mkdir -p'. |
351 |
if (umask $mkdir_umask && |
352 |
$mkdirprog $mkdir_mode "$tmpdir" && |
353 |
exec $mkdirprog $mkdir_mode -p -- "$tmpdir/a/b") >/dev/null 2>&1 |
354 |
then |
355 |
if test -z "$dir_arg" || { |
356 |
# Check for POSIX incompatibilities with -m. |
357 |
# HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or |
358 |
# other-writable bit of parent directory when it shouldn't. |
359 |
# FreeBSD 6.1 mkdir -m -p sets mode of existing directory. |
360 |
test_tmpdir="$tmpdir/a" |
361 |
ls_ld_tmpdir=`ls -ld "$test_tmpdir"` |
362 |
case $ls_ld_tmpdir in |
363 |
d????-?r-*) different_mode=700;; |
364 |
d????-?--*) different_mode=755;; |
365 |
*) false;; |
366 |
esac && |
367 |
$mkdirprog -m$different_mode -p -- "$test_tmpdir" && { |
368 |
ls_ld_tmpdir_1=`ls -ld "$test_tmpdir"` |
369 |
test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1" |
370 |
} |
371 |
} |
372 |
then posix_mkdir=: |
373 |
fi |
374 |
rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir" |
375 |
else |
376 |
# Remove any dirs left behind by ancient mkdir implementations. |
377 |
rmdir ./$mkdir_mode ./-p ./-- "$tmpdir" 2>/dev/null |
378 |
fi |
379 |
trap '' 0;; |
380 |
esac |
381 |
|
382 |
if |
383 |
$posix_mkdir && ( |
384 |
umask $mkdir_umask && |
385 |
$doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir" |
386 |
) |
387 |
then : |
388 |
else |
389 |
|
390 |
# mkdir does not conform to POSIX, |
391 |
# or it failed possibly due to a race condition. Create the |
392 |
# directory the slow way, step by step, checking for races as we go. |
393 |
|
394 |
case $dstdir in |
395 |
/*) prefix='/';; |
396 |
[-=\(\)!]*) prefix='./';; |
397 |
*) prefix='';; |
398 |
esac |
399 |
|
400 |
oIFS=$IFS |
401 |
IFS=/ |
402 |
set -f |
403 |
set fnord $dstdir |
404 |
shift |
405 |
set +f |
406 |
IFS=$oIFS |
407 |
|
408 |
prefixes= |
409 |
|
410 |
for d |
411 |
do |
412 |
test X"$d" = X && continue |
413 |
|
414 |
prefix=$prefix$d |
415 |
if test -d "$prefix"; then |
416 |
prefixes= |
417 |
else |
418 |
if $posix_mkdir; then |
419 |
(umask $mkdir_umask && |
420 |
$doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir") && break |
421 |
# Don't fail if two instances are running concurrently. |
422 |
test -d "$prefix" || exit 1 |
423 |
else |
424 |
case $prefix in |
425 |
*\'*) qprefix=`echo "$prefix" | sed "s/'/'\\\\\\\\''/g"`;; |
426 |
*) qprefix=$prefix;; |
427 |
esac |
428 |
prefixes="$prefixes '$qprefix'" |
429 |
fi |
430 |
fi |
431 |
prefix=$prefix/ |
432 |
done |
433 |
|
434 |
if test -n "$prefixes"; then |
435 |
# Don't fail if two instances are running concurrently. |
436 |
(umask $mkdir_umask && |
437 |
eval "\$doit_exec \$mkdirprog $prefixes") || |
438 |
test -d "$dstdir" || exit 1 |
439 |
obsolete_mkdir_used=true |
440 |
fi |
441 |
fi |
442 |
fi |
443 |
|
444 |
if test -n "$dir_arg"; then |
445 |
{ test -z "$chowncmd" || $doit $chowncmd "$dst"; } && |
446 |
{ test -z "$chgrpcmd" || $doit $chgrpcmd "$dst"; } && |
447 |
{ test "$obsolete_mkdir_used$chowncmd$chgrpcmd" = false || |
448 |
test -z "$chmodcmd" || $doit $chmodcmd $mode "$dst"; } || exit 1 |
449 |
else |
450 |
|
451 |
# Make a couple of temp file names in the proper directory. |
452 |
dsttmp=${dstdirslash}_inst.$$_ |
453 |
rmtmp=${dstdirslash}_rm.$$_ |
454 |
|
455 |
# Trap to clean up those temp files at exit. |
456 |
trap 'ret=$?; rm -f "$dsttmp" "$rmtmp" && exit $ret' 0 |
457 |
|
458 |
# Copy the file name to the temp name. |
459 |
(umask $cp_umask && |
460 |
{ test -z "$stripcmd" || { |
461 |
# Create $dsttmp read-write so that cp doesn't create it read-only, |
462 |
# which would cause strip to fail. |
463 |
if test -z "$doit"; then |
464 |
: >"$dsttmp" # No need to fork-exec 'touch'. |
465 |
else |
466 |
$doit touch "$dsttmp" |
467 |
fi |
468 |
} |
469 |
} && |
470 |
$doit_exec $cpprog "$src" "$dsttmp") && |
471 |
|
472 |
# and set any options; do chmod last to preserve setuid bits. |
473 |
# |
474 |
# If any of these fail, we abort the whole thing. If we want to |
475 |
# ignore errors from any of these, just make sure not to ignore |
476 |
# errors from the above "$doit $cpprog $src $dsttmp" command. |
477 |
# |
478 |
{ test -z "$chowncmd" || $doit $chowncmd "$dsttmp"; } && |
479 |
{ test -z "$chgrpcmd" || $doit $chgrpcmd "$dsttmp"; } && |
480 |
{ test -z "$stripcmd" || $doit $stripcmd "$dsttmp"; } && |
481 |
{ test -z "$chmodcmd" || $doit $chmodcmd $mode "$dsttmp"; } && |
482 |
|
483 |
# If -C, don't bother to copy if it wouldn't change the file. |
484 |
if $copy_on_change && |
485 |
old=`LC_ALL=C ls -dlL "$dst" 2>/dev/null` && |
486 |
new=`LC_ALL=C ls -dlL "$dsttmp" 2>/dev/null` && |
487 |
set -f && |
488 |
set X $old && old=:$2:$4:$5:$6 && |
489 |
set X $new && new=:$2:$4:$5:$6 && |
490 |
set +f && |
491 |
test "$old" = "$new" && |
492 |
$cmpprog "$dst" "$dsttmp" >/dev/null 2>&1 |
493 |
then |
494 |
rm -f "$dsttmp" |
495 |
else |
496 |
# If $backupsuffix is set, and the file being installed |
497 |
# already exists, attempt a backup. Don't worry if it fails, |
498 |
# e.g., if mv doesn't support -f. |
499 |
if test -n "$backupsuffix" && test -f "$dst"; then |
500 |
$doit $mvcmd -f "$dst" "$dst$backupsuffix" 2>/dev/null |
501 |
fi |
502 |
|
503 |
# Rename the file to the real destination. |
504 |
$doit $mvcmd -f "$dsttmp" "$dst" 2>/dev/null || |
505 |
|
506 |
# The rename failed, perhaps because mv can't rename something else |
507 |
# to itself, or perhaps because mv is so ancient that it does not |
508 |
# support -f. |
509 |
{ |
510 |
# Now remove or move aside any old file at destination location. |
511 |
# We try this two ways since rm can't unlink itself on some |
512 |
# systems and the destination file might be busy for other |
513 |
# reasons. In this case, the final cleanup might fail but the new |
514 |
# file should still install successfully. |
515 |
{ |
516 |
test ! -f "$dst" || |
517 |
$doit $rmcmd "$dst" 2>/dev/null || |
518 |
{ $doit $mvcmd -f "$dst" "$rmtmp" 2>/dev/null && |
519 |
{ $doit $rmcmd "$rmtmp" 2>/dev/null; :; } |
520 |
} || |
521 |
{ echo "$0: cannot unlink or rename $dst" >&2 |
522 |
(exit 1); exit 1 |
523 |
} |
524 |
} && |
525 |
|
526 |
# Now rename the file to the real destination. |
527 |
$doit $mvcmd "$dsttmp" "$dst" |
528 |
} |
529 |
fi || exit 1 |
530 |
|
531 |
trap '' 0 |
532 |
fi |
533 |
done |
534 |
|
535 |
# Local variables: |
536 |
# eval: (add-hook 'before-save-hook 'time-stamp) |
537 |
# time-stamp-start: "scriptversion=" |
538 |
# time-stamp-format: "%:y-%02m-%02d.%02H" |
539 |
# time-stamp-time-zone: "UTC0" |
540 |
# time-stamp-end: "; # UTC" |
541 |
# End: |