Home | History | Annotate | Download | only in build-aux
      1 #!/bin/sh
      2 # install - install a program, script, or datafile
      3 
      4 scriptversion=2011-11-20.07; # 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 nl='
     45 '
     46 IFS=" ""	$nl"
     47 
     48 # set DOITPROG to echo to test this script
     49 
     50 # Don't use :- since 4.3BSD and earlier shells don't like it.
     51 doit=${DOITPROG-}
     52 if test -z "$doit"; then
     53   doit_exec=exec
     54 else
     55   doit_exec=$doit
     56 fi
     57 
     58 # Put in absolute file names if you don't have them in your path;
     59 # or use environment vars.
     60 
     61 chgrpprog=${CHGRPPROG-chgrp}
     62 chmodprog=${CHMODPROG-chmod}
     63 chownprog=${CHOWNPROG-chown}
     64 cmpprog=${CMPPROG-cmp}
     65 cpprog=${CPPROG-cp}
     66 mkdirprog=${MKDIRPROG-mkdir}
     67 mvprog=${MVPROG-mv}
     68 rmprog=${RMPROG-rm}
     69 stripprog=${STRIPPROG-strip}
     70 
     71 posix_glob='?'
     72 initialize_posix_glob='
     73   test "$posix_glob" != "?" || {
     74     if (set -f) 2>/dev/null; then
     75       posix_glob=
     76     else
     77       posix_glob=:
     78     fi
     79   }
     80 '
     81 
     82 posix_mkdir=
     83 
     84 # Desired mode of installed file.
     85 mode=0755
     86 
     87 chgrpcmd=
     88 chmodcmd=$chmodprog
     89 chowncmd=
     90 mvcmd=$mvprog
     91 rmcmd="$rmprog -f"
     92 stripcmd=
     93 
     94 src=
     95 dst=
     96 dir_arg=
     97 dst_arg=
     98 
     99 copy_on_change=false
    100 no_target_directory=
    101 
    102 usage="\
    103 Usage: $0 [OPTION]... [-T] SRCFILE DSTFILE
    104    or: $0 [OPTION]... SRCFILES... DIRECTORY
    105    or: $0 [OPTION]... -t DIRECTORY SRCFILES...
    106    or: $0 [OPTION]... -d DIRECTORIES...
    107 
    108 In the 1st form, copy SRCFILE to DSTFILE.
    109 In the 2nd and 3rd, copy all SRCFILES to DIRECTORY.
    110 In the 4th, create DIRECTORIES.
    111 
    112 Options:
    113      --help     display this help and exit.
    114      --version  display version info and exit.
    115 
    116   -c            (ignored)
    117   -C            install only if different (preserve the last data modification time)
    118   -d            create directories instead of installing files.
    119   -g GROUP      $chgrpprog installed files to GROUP.
    120   -m MODE       $chmodprog installed files to MODE.
    121   -o USER       $chownprog installed files to USER.
    122   -s            $stripprog installed files.
    123   -t DIRECTORY  install into DIRECTORY.
    124   -T            report an error if DSTFILE is a directory.
    125 
    126 Environment variables override the default commands:
    127   CHGRPPROG CHMODPROG CHOWNPROG CMPPROG CPPROG MKDIRPROG MVPROG
    128   RMPROG STRIPPROG
    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 	  *' '* | *'	'* | *'
    147 '*	  | *'*'* | *'?'* | *'['*)
    148 	    echo "$0: invalid mode: $mode" >&2
    149 	    exit 1;;
    150 	esac
    151 	shift;;
    152 
    153     -o) chowncmd="$chownprog $2"
    154 	shift;;
    155 
    156     -s) stripcmd=$stripprog;;
    157 
    158     -t) dst_arg=$2
    159 	# Protect names problematic for 'test' and other utilities.
    160 	case $dst_arg in
    161 	  -* | [=\(\)!]) dst_arg=./$dst_arg;;
    162 	esac
    163 	shift;;
    164 
    165     -T) no_target_directory=true;;
    166 
    167     --version) echo "$0 $scriptversion"; exit $?;;
    168 
    169     --)	shift
    170 	break;;
    171 
    172     -*)	echo "$0: invalid option: $1" >&2
    173 	exit 1;;
    174 
    175     *)  break;;
    176   esac
    177   shift
    178 done
    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   do_exit='(exit $ret); exit $ret'
    212   trap "ret=129; $do_exit" 1
    213   trap "ret=130; $do_exit" 2
    214   trap "ret=141; $do_exit" 13
    215   trap "ret=143; $do_exit" 15
    216 
    217   # Set umask so as not to create temps with too-generous modes.
    218   # However, 'strip' requires both read and write access to temps.
    219   case $mode in
    220     # Optimize common cases.
    221     *644) cp_umask=133;;
    222     *755) cp_umask=22;;
    223 
    224     *[0-7])
    225       if test -z "$stripcmd"; then
    226 	u_plus_rw=
    227       else
    228 	u_plus_rw='% 200'
    229       fi
    230       cp_umask=`expr '(' 777 - $mode % 1000 ')' $u_plus_rw`;;
    231     *)
    232       if test -z "$stripcmd"; then
    233 	u_plus_rw=
    234       else
    235 	u_plus_rw=,u+rw
    236       fi
    237       cp_umask=$mode$u_plus_rw;;
    238   esac
    239 fi
    240 
    241 for src
    242 do
    243   # Protect names problematic for 'test' and other utilities.
    244   case $src in
    245     -* | [=\(\)!]) src=./$src;;
    246   esac
    247 
    248   if test -n "$dir_arg"; then
    249     dst=$src
    250     dstdir=$dst
    251     test -d "$dstdir"
    252     dstdir_status=$?
    253   else
    254 
    255     # Waiting for this to be detected by the "$cpprog $src $dsttmp" command
    256     # might cause directories to be created, which would be especially bad
    257     # if $src (and thus $dsttmp) contains '*'.
    258     if test ! -f "$src" && test ! -d "$src"; then
    259       echo "$0: $src does not exist." >&2
    260       exit 1
    261     fi
    262 
    263     if test -z "$dst_arg"; then
    264       echo "$0: no destination specified." >&2
    265       exit 1
    266     fi
    267     dst=$dst_arg
    268 
    269     # If destination is a directory, append the input filename; won't work
    270     # if double slashes aren't ignored.
    271     if test -d "$dst"; then
    272       if test -n "$no_target_directory"; then
    273 	echo "$0: $dst_arg: Is a directory" >&2
    274 	exit 1
    275       fi
    276       dstdir=$dst
    277       dst=$dstdir/`basename "$src"`
    278       dstdir_status=0
    279     else
    280       # Prefer dirname, but fall back on a substitute if dirname fails.
    281       dstdir=`
    282 	(dirname "$dst") 2>/dev/null ||
    283 	expr X"$dst" : 'X\(.*[^/]\)//*[^/][^/]*/*$' \| \
    284 	     X"$dst" : 'X\(//\)[^/]' \| \
    285 	     X"$dst" : 'X\(//\)$' \| \
    286 	     X"$dst" : 'X\(/\)' \| . 2>/dev/null ||
    287 	echo X"$dst" |
    288 	    sed '/^X\(.*[^/]\)\/\/*[^/][^/]*\/*$/{
    289 		   s//\1/
    290 		   q
    291 		 }
    292 		 /^X\(\/\/\)[^/].*/{
    293 		   s//\1/
    294 		   q
    295 		 }
    296 		 /^X\(\/\/\)$/{
    297 		   s//\1/
    298 		   q
    299 		 }
    300 		 /^X\(\/\).*/{
    301 		   s//\1/
    302 		   q
    303 		 }
    304 		 s/.*/./; q'
    305       `
    306 
    307       test -d "$dstdir"
    308       dstdir_status=$?
    309     fi
    310   fi
    311 
    312   obsolete_mkdir_used=false
    313 
    314   if test $dstdir_status != 0; then
    315     case $posix_mkdir in
    316       '')
    317 	# Create intermediate dirs using mode 755 as modified by the umask.
    318 	# This is like FreeBSD 'install' as of 1997-10-28.
    319 	umask=`umask`
    320 	case $stripcmd.$umask in
    321 	  # Optimize common cases.
    322 	  *[2367][2367]) mkdir_umask=$umask;;
    323 	  .*0[02][02] | .[02][02] | .[02]) mkdir_umask=22;;
    324 
    325 	  *[0-7])
    326 	    mkdir_umask=`expr $umask + 22 \
    327 	      - $umask % 100 % 40 + $umask % 20 \
    328 	      - $umask % 10 % 4 + $umask % 2
    329 	    `;;
    330 	  *) mkdir_umask=$umask,go-w;;
    331 	esac
    332 
    333 	# With -d, create the new directory with the user-specified mode.
    334 	# Otherwise, rely on $mkdir_umask.
    335 	if test -n "$dir_arg"; then
    336 	  mkdir_mode=-m$mode
    337 	else
    338 	  mkdir_mode=
    339 	fi
    340 
    341 	posix_mkdir=false
    342 	case $umask in
    343 	  *[123567][0-7][0-7])
    344 	    # POSIX mkdir -p sets u+wx bits regardless of umask, which
    345 	    # is incompatible with FreeBSD 'install' when (umask & 300) != 0.
    346 	    ;;
    347 	  *)
    348 	    tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$
    349 	    trap 'ret=$?; rmdir "$tmpdir/d" "$tmpdir" 2>/dev/null; exit $ret' 0
    350 
    351 	    if (umask $mkdir_umask &&
    352 		exec $mkdirprog $mkdir_mode -p -- "$tmpdir/d") >/dev/null 2>&1
    353 	    then
    354 	      if test -z "$dir_arg" || {
    355 		   # Check for POSIX incompatibilities with -m.
    356 		   # HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or
    357 		   # other-writable bit of parent directory when it shouldn't.
    358 		   # FreeBSD 6.1 mkdir -m -p sets mode of existing directory.
    359 		   ls_ld_tmpdir=`ls -ld "$tmpdir"`
    360 		   case $ls_ld_tmpdir in
    361 		     d????-?r-*) different_mode=700;;
    362 		     d????-?--*) different_mode=755;;
    363 		     *) false;;
    364 		   esac &&
    365 		   $mkdirprog -m$different_mode -p -- "$tmpdir" && {
    366 		     ls_ld_tmpdir_1=`ls -ld "$tmpdir"`
    367 		     test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1"
    368 		   }
    369 		 }
    370 	      then posix_mkdir=:
    371 	      fi
    372 	      rmdir "$tmpdir/d" "$tmpdir"
    373 	    else
    374 	      # Remove any dirs left behind by ancient mkdir implementations.
    375 	      rmdir ./$mkdir_mode ./-p ./-- 2>/dev/null
    376 	    fi
    377 	    trap '' 0;;
    378 	esac;;
    379     esac
    380 
    381     if
    382       $posix_mkdir && (
    383 	umask $mkdir_umask &&
    384 	$doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir"
    385       )
    386     then :
    387     else
    388 
    389       # The umask is ridiculous, or mkdir does not conform to POSIX,
    390       # or it failed possibly due to a race condition.  Create the
    391       # directory the slow way, step by step, checking for races as we go.
    392 
    393       case $dstdir in
    394 	/*) prefix='/';;
    395 	[-=\(\)!]*) prefix='./';;
    396 	*)  prefix='';;
    397       esac
    398 
    399       eval "$initialize_posix_glob"
    400 
    401       oIFS=$IFS
    402       IFS=/
    403       $posix_glob set -f
    404       set fnord $dstdir
    405       shift
    406       $posix_glob set +f
    407       IFS=$oIFS
    408 
    409       prefixes=
    410 
    411       for d
    412       do
    413 	test X"$d" = X && continue
    414 
    415 	prefix=$prefix$d
    416 	if test -d "$prefix"; then
    417 	  prefixes=
    418 	else
    419 	  if $posix_mkdir; then
    420 	    (umask=$mkdir_umask &&
    421 	     $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir") && break
    422 	    # Don't fail if two instances are running concurrently.
    423 	    test -d "$prefix" || exit 1
    424 	  else
    425 	    case $prefix in
    426 	      *\'*) qprefix=`echo "$prefix" | sed "s/'/'\\\\\\\\''/g"`;;
    427 	      *) qprefix=$prefix;;
    428 	    esac
    429 	    prefixes="$prefixes '$qprefix'"
    430 	  fi
    431 	fi
    432 	prefix=$prefix/
    433       done
    434 
    435       if test -n "$prefixes"; then
    436 	# Don't fail if two instances are running concurrently.
    437 	(umask $mkdir_umask &&
    438 	 eval "\$doit_exec \$mkdirprog $prefixes") ||
    439 	  test -d "$dstdir" || exit 1
    440 	obsolete_mkdir_used=true
    441       fi
    442     fi
    443   fi
    444 
    445   if test -n "$dir_arg"; then
    446     { test -z "$chowncmd" || $doit $chowncmd "$dst"; } &&
    447     { test -z "$chgrpcmd" || $doit $chgrpcmd "$dst"; } &&
    448     { test "$obsolete_mkdir_used$chowncmd$chgrpcmd" = false ||
    449       test -z "$chmodcmd" || $doit $chmodcmd $mode "$dst"; } || exit 1
    450   else
    451 
    452     # Make a couple of temp file names in the proper directory.
    453     dsttmp=$dstdir/_inst.$$_
    454     rmtmp=$dstdir/_rm.$$_
    455 
    456     # Trap to clean up those temp files at exit.
    457     trap 'ret=$?; rm -f "$dsttmp" "$rmtmp" && exit $ret' 0
    458 
    459     # Copy the file name to the temp name.
    460     (umask $cp_umask && $doit_exec $cpprog "$src" "$dsttmp") &&
    461 
    462     # and set any options; do chmod last to preserve setuid bits.
    463     #
    464     # If any of these fail, we abort the whole thing.  If we want to
    465     # ignore errors from any of these, just make sure not to ignore
    466     # errors from the above "$doit $cpprog $src $dsttmp" command.
    467     #
    468     { test -z "$chowncmd" || $doit $chowncmd "$dsttmp"; } &&
    469     { test -z "$chgrpcmd" || $doit $chgrpcmd "$dsttmp"; } &&
    470     { test -z "$stripcmd" || $doit $stripcmd "$dsttmp"; } &&
    471     { test -z "$chmodcmd" || $doit $chmodcmd $mode "$dsttmp"; } &&
    472 
    473     # If -C, don't bother to copy if it wouldn't change the file.
    474     if $copy_on_change &&
    475        old=`LC_ALL=C ls -dlL "$dst"	2>/dev/null` &&
    476        new=`LC_ALL=C ls -dlL "$dsttmp"	2>/dev/null` &&
    477 
    478        eval "$initialize_posix_glob" &&
    479        $posix_glob set -f &&
    480        set X $old && old=:$2:$4:$5:$6 &&
    481        set X $new && new=:$2:$4:$5:$6 &&
    482        $posix_glob set +f &&
    483 
    484        test "$old" = "$new" &&
    485        $cmpprog "$dst" "$dsttmp" >/dev/null 2>&1
    486     then
    487       rm -f "$dsttmp"
    488     else
    489       # Rename the file to the real destination.
    490       $doit $mvcmd -f "$dsttmp" "$dst" 2>/dev/null ||
    491 
    492       # The rename failed, perhaps because mv can't rename something else
    493       # to itself, or perhaps because mv is so ancient that it does not
    494       # support -f.
    495       {
    496 	# Now remove or move aside any old file at destination location.
    497 	# We try this two ways since rm can't unlink itself on some
    498 	# systems and the destination file might be busy for other
    499 	# reasons.  In this case, the final cleanup might fail but the new
    500 	# file should still install successfully.
    501 	{
    502 	  test ! -f "$dst" ||
    503 	  $doit $rmcmd -f "$dst" 2>/dev/null ||
    504 	  { $doit $mvcmd -f "$dst" "$rmtmp" 2>/dev/null &&
    505 	    { $doit $rmcmd -f "$rmtmp" 2>/dev/null; :; }
    506 	  } ||
    507 	  { echo "$0: cannot unlink or rename $dst" >&2
    508 	    (exit 1); exit 1
    509 	  }
    510 	} &&
    511 
    512 	# Now rename the file to the real destination.
    513 	$doit $mvcmd "$dsttmp" "$dst"
    514       }
    515     fi || exit 1
    516 
    517     trap '' 0
    518   fi
    519 done
    520 
    521 # Local variables:
    522 # eval: (add-hook 'write-file-hooks 'time-stamp)
    523 # time-stamp-start: "scriptversion="
    524 # time-stamp-format: "%:y-%02m-%02d.%02H"
    525 # time-stamp-time-zone: "UTC"
    526 # time-stamp-end: "; # UTC"
    527 # End:
    528