build-aux/install-sh

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