317
|
1 #!/usr/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:
|