Annotation of freem/install-sh, revision 1.1
1.1 ! snw 1: #!/bin/sh
! 2: # install - install a program, script, or datafile
! 3:
! 4: scriptversion=2024-06-19.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: Report bugs to <bug-automake@gnu.org>.
! 128: GNU Automake home page: <https://www.gnu.org/software/automake/>.
! 129: General help using GNU software: <https://www.gnu.org/gethelp/>."
! 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 (GNU Automake) $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-writable /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 incompatibility 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:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to install-sh CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Coherent Logic Development] / freem