Skyler Grey | 303dce4 | 2023-02-13 06:29:30 +0000 | [diff] [blame] | 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: |