Home | History | Annotate | Line # | Download | only in gcc
genmultilib revision 1.8
      1 #!/bin/sh 
      2 # Generates multilib.h.
      3 #   Copyright (C) 1994-2017 Free Software Foundation, Inc.
      4 
      5 #This file is part of GCC.
      6 
      7 #GCC is free software; you can redistribute it and/or modify it under
      8 #the terms of the GNU General Public License as published by the Free
      9 #Software Foundation; either version 3, or (at your option) any later
     10 #version.
     11 
     12 #GCC is distributed in the hope that it will be useful, but WITHOUT
     13 #ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
     14 #FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
     15 #for more details.
     16 
     17 #You should have received a copy of the GNU General Public License
     18 #along with GCC; see the file COPYING3.  If not see
     19 #<http://www.gnu.org/licenses/>.  
     20 
     21 # This shell script produces a header file which the gcc driver
     22 # program uses to pick which library to use based on the machine
     23 # specific options that it is given.
     24 
     25 # The first argument is a list of sets of options.  The elements in
     26 # the list are separated by spaces.  Within an element, the options
     27 # are separated by slashes or pipes.  No leading dash is used on the
     28 # options.
     29 # Each option in a set separated by slashes is mutually incompatible
     30 # with all other options
     31 # in the set.
     32 # Each option in a set separated by pipes will be used for the library
     33 # compilation and any of the options in the set will be sufficient
     34 # for it to be triggered.
     35 
     36 # The optional second argument is a list of subdirectory names.  If
     37 # the second argument is non-empty, there must be as many elements in
     38 # the second argument as there are options in the first argument.  The
     39 # elements in the second list are separated by spaces.  If the second
     40 # argument is empty, the option names will be used as the directory
     41 # names.
     42 
     43 # The optional third argument is a list of options which are
     44 # identical.  The elements in the list are separated by spaces.  Each
     45 # element must be of the form OPTION=OPTION.  The first OPTION should
     46 # appear in the first argument, and the second should be a synonym for
     47 # it.  Question marks are replaced with equal signs in both options.
     48 
     49 # The optional fourth argument is a list of multilib directory 
     50 # combinations that should not be built.
     51 
     52 # The optional fifth argument is a list of options that should be
     53 # used whenever building multilib libraries.
     54 
     55 # The optional sixth argument is a list of exclusions used internally by
     56 # the compiler similar to exceptions. The difference being that exclusions
     57 # allow matching default options that genmultilib does not know about and
     58 # is done at runtime as opposed to being sorted out at compile time.
     59 # Each element in the list is a separate exclusion rule. Each rule is
     60 # a list of options (sans preceding '-') separated by a '/'. The options
     61 # on the rule are grouped as an AND operation, and all options much match
     62 # for the rule to exclude a set. Options can be preceded with a '!' to
     63 # match a logical NOT.
     64 
     65 # The optional seventh argument is a list of OS subdirectory names.
     66 # The format is either the same as of the second argument, or a set of
     67 # mappings. When it is the same as the second argument, it describes
     68 # the multilib directories using OS conventions, rather than GCC
     69 # conventions.  When it is a set of mappings of the form gccdir=osdir,
     70 # the left side gives the GCC convention and the right gives the
     71 # equivalent OS defined location.  If the osdir part begins with a !,
     72 # the os directory names are used exclusively.  Use the mapping when
     73 # there is no one-to-one equivalence between GCC levels and the OS.
     74 
     75 # The optional eighth argument which intends to reduce the effort to write
     76 # so many MULTILIB_EXCEPTIONS rules. This option defines a series of option
     77 # combinations that we actually required.
     78 # For some cases, the generated option combinations are far more than what
     79 # we need, we have to write a lot of rules to screen out combinations we
     80 # don't need. If we missed some rules, the unexpected libraries will be built.
     81 # Now with this argument, one can simply give what combinations are needed.
     82 # It is pretty straigtforward.
     83 # This argument can be used together with MULTILIB_EXCEPTIONS and will take
     84 # effect after the MULTILIB_EXCEPTIONS.
     85 
     86 # The optional ninth argument is the multiarch name.
     87 
     88 # The optional tenth argument specifies how to reuse multilib for different
     89 # option sets.
     90 
     91 # The last option should be "yes" if multilibs are enabled.  If it is not
     92 # "yes", all GCC multilib dir names will be ".".
     93 
     94 # The output looks like
     95 #   #define MULTILIB_MATCHES "\
     96 #   SUBDIRECTORY OPTIONS;\
     97 #   ...
     98 #   "
     99 # The SUBDIRECTORY is the subdirectory to use.  The OPTIONS are
    100 # multiple options separated by spaces.  Each option may start with an
    101 # exclamation point.  gcc will consider each line in turn.  If none of
    102 # the options beginning with an exclamation point are present, and all
    103 # of the other options are present, that subdirectory will be used.
    104 # The order of the subdirectories is such that they can be created in
    105 # order; that is, a subdirectory is preceded by all its parents.
    106 
    107 # Here is an example (this is from the actual sparc64 case):
    108 #   genmultilib 'm64/m32 mno-app-regs|mcmodel=medany' '64 32 alt'
    109 #		'mcmodel?medany=mcmodel?medmid' 'm32/mno-app-regs* m32/mcmodel=*'
    110 #		'' 'm32/!m64/mno-app-regs m32/!m64/mcmodel=medany'
    111 #		'../lib64 ../lib32 alt' '' '' '' yes
    112 # This produces:
    113 #   ". !m64 !m32 !mno-app-regs !mcmodel=medany;",
    114 #   "64:../lib64 m64 !m32 !mno-app-regs !mcmodel=medany;",
    115 #   "32:../lib32 !m64 m32 !mno-app-regs !mcmodel=medany;",
    116 #   "alt !m64 !m32 mno-app-regs mcmodel=medany;",
    117 #   "alt !m64 !m32 mno-app-regs !mcmodel=medany;",
    118 #   "alt !m64 !m32 !mno-app-regs mcmodel=medany;",
    119 #   "64/alt:../lib64/alt m64 !m32 mno-app-regs mcmodel=medany;",
    120 #   "64/alt:../lib64/alt m64 !m32 mno-app-regs !mcmodel=medany;",
    121 #   "64/alt:../lib64/alt m64 !m32 !mno-app-regs mcmodel=medany;",
    122 #
    123 # The effect is that `gcc -mno-app-regs' (for example) will append "alt"
    124 # to the directory name when searching for libraries or startup files and
    125 # `gcc -m32 -mcmodel=medany' (for example) will append "32/alt". Also note
    126 # that exclusion above is moot, unless the compiler had a default of -m32,
    127 # which would mean that all of the "alt" directories (not the 64/alt ones)
    128 # would be ignored (not generated, nor used) since the exclusion also
    129 # matches the multilib_default args.
    130 
    131 # Copy the positional parameters into variables.
    132 options=$1
    133 dirnames=$2
    134 matches=$3
    135 exceptions=$4
    136 extra=$5
    137 exclusions=$6
    138 osdirnames=$7
    139 multilib_required=$8
    140 multiarch=$9
    141 multilib_reuse=${10}
    142 enable_multilib=${11}
    143 
    144 echo "static const char *const multilib_raw[] = {"
    145 
    146 mkdir tmpmultilib.$$ || exit 1
    147 # Use cd ./foo to avoid CDPATH output.
    148 cd ./tmpmultilib.$$ || exit 1
    149 
    150 # What we want to do is select all combinations of the sets in
    151 # options.  Each combination which includes a set of mutually
    152 # exclusive options must then be output multiple times, once for each
    153 # item in the set.  Selecting combinations is a recursive process.
    154 # Since not all versions of sh support functions, we achieve recursion
    155 # by creating a temporary shell script which invokes itself.
    156 rm -f tmpmultilib
    157 cat >tmpmultilib <<EOF
    158 #!${CONFIG_SHELL:-/bin/sh}
    159 EOF
    160 cat >>tmpmultilib <<\EOF
    161 # This recursive script basically outputs all combinations of its
    162 # input arguments, handling mutually exclusive sets of options by
    163 # repetition.  When the script is called, ${initial} is the list of
    164 # options which should appear before all combinations this will
    165 # output.  The output looks like a list of subdirectory names with
    166 # leading and trailing slashes.
    167 if [ "$#" != "0" ]; then
    168   first=$1
    169   shift
    170   case "$first" in
    171   *\|*)
    172     all=${initial}`echo $first | sed -e 's_|_/_'g`
    173     first=`echo $first | sed -e 's_|_ _'g`
    174     echo ${all}/
    175     initial="${initial}${all}/" ./tmpmultilib $@
    176     ./tmpmultilib $first $@ | grep -v "^${all}"
    177     ;;
    178   *)
    179     for opt in `echo $first | sed -e 's|/| |'g`; do
    180       echo ${initial}${opt}/
    181     done
    182     ./tmpmultilib $@
    183     for opt in `echo $first | sed -e 's|/| |'g`; do
    184       initial="${initial}${opt}/" ./tmpmultilib $@
    185     done
    186   esac
    187 fi
    188 EOF
    189 chmod +x tmpmultilib
    190 
    191 combination_space=`initial=/ ./tmpmultilib ${options}`
    192 combinations="$combination_space"
    193 
    194 # If there exceptions, weed them out now
    195 if [ -n "${exceptions}" ]; then
    196   cat >tmpmultilib2 <<EOF
    197 #!${CONFIG_SHELL:-/bin/sh}
    198 EOF
    199   cat >>tmpmultilib2 <<\EOF
    200 # This recursive script weeds out any combination of multilib
    201 # switches that should not be generated.  The output looks like
    202 # a list of subdirectory names with leading and trailing slashes.
    203 
    204   for opt in $@; do
    205     case "$opt" in
    206 EOF
    207 
    208   for except in ${exceptions}; do
    209     echo "      /${except}/) : ;;" >> tmpmultilib2
    210   done
    211 
    212 cat >>tmpmultilib2 <<\EOF
    213       *) echo ${opt};;
    214     esac
    215   done
    216 EOF
    217   chmod +x tmpmultilib2
    218   combinations=`./tmpmultilib2 ${combinations}`
    219 fi
    220 
    221 # If the MULTILIB_REQUIRED list are provided,
    222 # filter out combinations not in this list.
    223 if [ -n "${multilib_required}" ]; then
    224   cat >tmpmultilib2 <<\EOF
    225 #!/bin/sh
    226 # This recursive script weeds out any combination of multilib
    227 # switches that not in the expected list.
    228 
    229   for opt in $@; do
    230     case "$opt" in
    231 EOF
    232 
    233   for expect in ${multilib_required}; do
    234     echo "      /${expect}/) echo \${opt};;" >> tmpmultilib2
    235   done
    236 
    237 cat >>tmpmultilib2 <<\EOF
    238       *) ;;
    239     esac
    240   done
    241 EOF
    242 
    243    chmod +x tmpmultilib2
    244    combinations=`./tmpmultilib2 ${combinations}`
    245 
    246 fi
    247 
    248 # Construct a sed pattern which will convert option names to directory
    249 # names.
    250 todirnames=
    251 if [ -n "${dirnames}" ]; then
    252   set x ${dirnames}
    253   shift
    254   for set in ${options}; do
    255     for opts in `echo ${set} | sed -e 's|/| |'g`; do
    256       patt="/"
    257       for opt in `echo ${opts} | sed -e 's_|_ _'g`; do
    258         if [ "$1" != "${opt}" ]; then
    259           todirnames="${todirnames} -e s|/${opt}/|/${1}/|g"
    260 	  patt="${patt}${1}/"
    261 	  if [ "${patt}" != "/${1}/" ]; then
    262 	    todirnames="${todirnames} -e s|${patt}|/${1}/|g"
    263           fi
    264         fi
    265       done
    266       shift
    267     done
    268   done
    269 fi
    270 
    271 # Construct a sed pattern which will convert option names to OS directory
    272 # names.
    273 toosdirnames=
    274 defaultosdirname=
    275 defaultosdirname2=
    276 if [ -n "${multiarch}" ]; then
    277   defaultosdirname=::${multiarch}
    278 fi
    279 if [ -n "${osdirnames}" ]; then
    280   set x ${osdirnames}
    281   shift
    282   while [ $# != 0 ] ; do
    283     case "$1" in
    284       .=*)
    285         defaultosdirname=`echo $1 | sed 's|^.=|:|'`
    286 	if [ -n "${multiarch}" ]; then
    287 	  defaultosdirname=${defaultosdirname}:${multiarch}
    288 	fi
    289 	case "$defaultosdirname" in
    290 	  ::*) ;;
    291 	  *)
    292 	    defaultosdirname2=${defaultosdirname}
    293 	    defaultosdirname=
    294 	    ;;
    295 	esac
    296 	shift
    297 	;;
    298       *=*)
    299 	patt=`echo $1 | sed -e 's|=|/$=/|'`
    300         toosdirnames="${toosdirnames} -e s=^/${patt}/="
    301 	shift
    302         ;;
    303       *)
    304         break
    305 	;;
    306     esac
    307   done
    308   
    309   if [ $# != 0 ]; then
    310     for set in ${options}; do
    311       for opts in `echo ${set} | sed -e 's|/| |'g`; do
    312         patt="/"
    313         for opt in `echo ${opts} | sed -e 's_|_ _'g`; do
    314           if [ "$1" != "${opt}" ]; then
    315             toosdirnames="${toosdirnames} -e s|/${opt}/|/${1}/|g"
    316 	    patt="${patt}${1}/"
    317 	    if [ "${patt}" != "/${1}/" ]; then
    318 	      toosdirnames="${toosdirnames} -e s|${patt}|/${1}/|g"
    319             fi
    320           fi
    321         done
    322         shift
    323       done
    324     done
    325   fi
    326 fi
    327 
    328 # We need another recursive shell script to correctly handle positive
    329 # matches.  If we are invoked as
    330 #   genmultilib "opt1 opt2" "" "opt1=nopt1 opt2=nopt2"
    331 # we must output
    332 #   opt1/opt2 opt1 opt2
    333 #   opt1/opt2 nopt1 opt2
    334 #   opt1/opt2 opt1 nopt2
    335 #   opt1/opt2 nopt1 nopt2
    336 # In other words, we must output all combinations of matches.
    337 rm -f tmpmultilib2
    338 cat >tmpmultilib2 <<EOF
    339 #!${CONFIG_SHELL:-/bin/sh}
    340 EOF
    341 cat >>tmpmultilib2 <<\EOF
    342 # The positional parameters are a list of matches to consider.
    343 # ${dirout} is the directory name and ${optout} is the current list of
    344 # options.
    345 if [ "$#" = "0" ]; then
    346   echo "\"${dirout} ${optout};\","
    347 else
    348   first=$1
    349   shift
    350   dirout="${dirout}" optout="${optout}" ./tmpmultilib2 $@
    351   l=`echo ${first} | sed -e 's/=.*$//' -e 's/?/=/g'`
    352   r=`echo ${first} | sed -e 's/^.*=//' -e 's/?/=/g'`
    353   if expr " ${optout} " : ".* ${l} .*" > /dev/null; then
    354     newopt=`echo " ${optout} " | sed -e "s/ ${l} / ${r} /" -e 's/^ //' -e 's/ $//'`
    355     dirout="${dirout}" optout="${newopt}" ./tmpmultilib2 $@
    356   fi
    357 fi
    358 EOF
    359 chmod +x tmpmultilib2
    360 
    361 # Start with the current directory, which includes only negations.
    362 optout=
    363 for set in ${options}; do
    364   for opt in `echo ${set} | sed -e 's_[/|]_ _g'`; do
    365     optout="${optout} !${opt}"
    366   done
    367 done
    368 optout=`echo ${optout} | sed -e 's/^ //'`
    369 echo "\".${defaultosdirname} ${optout};\","
    370 [ -n "${defaultosdirname2}" ] && echo "\".${defaultosdirname2} ${optout};\","
    371 
    372 # This part of code convert an option combination to
    373 # its corresponding directory names.
    374 # The directory names will be deduced from MULTILIB_DIRNAMES,
    375 # MULTILIB_OSDIRNAMES or the option combination itself.
    376 rm -rf tmpmultilib3
    377 cat >tmpmultilib3 <<\EOF
    378 #!/bin/sh
    379 
    380 dirout=
    381 combo=$1
    382 todirnames=$2
    383 toosdirnames=$3
    384 enable_multilib=$4
    385 
    386 if [ -n "${todirnames}" ]; then
    387   dirout=`echo ${combo} | sed ${todirnames}`
    388 else
    389   dirout=`echo ${combo} | sed -e 's/=/-/g'`
    390 fi
    391 # Remove the leading and trailing slashes.
    392 dirout=`echo ${dirout} | sed -e 's|^/||' -e 's|/*:/*|:|' -e 's|/$||g'`
    393 
    394 # Use the OS directory names rather than the option names.
    395 if [ -n "${toosdirnames}" ]; then
    396   osdirout=`echo ${combo} | sed ${toosdirnames}`
    397   # Remove the leading and trailing slashes.
    398   osdirout=`echo ${osdirout} | sed -e 's|^/||' -e 's|/*:/*|:|' -e 's|/$||g'`
    399   if [ "x${enable_multilib}" != xyes ]; then
    400     dirout=".:${osdirout}"
    401     disable_multilib=yes
    402   else
    403     case "${osdirout}" in
    404       !*)
    405 	dirout=`echo ${osdirout} | sed 's/^!//'`
    406 	;;
    407        *)
    408 	dirout="${dirout}:${osdirout}"
    409 	;;
    410     esac
    411   fi
    412 else
    413   if [ "x${enable_multilib}" != xyes ]; then
    414     # genmultilib with --disable-multilib should be
    415     # called with '' '' '' '' '' '' '' no
    416     # if MULTILIB_OSDIRNAMES is empty.
    417     exit 1
    418   fi
    419 fi
    420 echo "${dirout}"
    421 EOF
    422 chmod +x tmpmultilib3
    423 
    424 # Script to look through the options and output each option that is present,
    425 # and negate each option that is not present.
    426 rm -rf tmpmultilib4
    427 cat > tmpmultilib4 <<\EOF
    428 #!/bin/sh
    429 
    430 optout=
    431 combo=$1
    432 options=$2
    433 
    434 for set in ${options}; do
    435   setopts=`echo ${set} | sed -e 's_[/|]_ _g'`
    436   for opt in ${setopts}; do
    437     if expr "${combo} " : ".*/${opt}/.*" > /dev/null; then
    438       optout="${optout} ${opt}"
    439     else
    440       optout="${optout} !${opt}"
    441     fi
    442   done
    443 done
    444 optout=`echo ${optout} | sed -e 's/^ //'`
    445 echo "${optout}"
    446 EOF
    447 chmod +x tmpmultilib4
    448 
    449 # Work over the list of combinations.  We have to translate each one
    450 # to use the directory names rather than the option names, we have to
    451 # include the information in matches, and we have to generate the
    452 # correct list of options and negations.
    453 for combo in ${combinations}; do
    454   # Use the directory names rather than the option names.
    455   dirout=`./tmpmultilib3 "${combo}" "${todirnames}" "${toosdirnames}" "${enable_multilib}"`
    456 
    457   # Look through the options.  We must output each option that is
    458   # present, and negate each option that is not present.
    459   optout=`./tmpmultilib4 "${combo}" "${options}"`
    460 
    461   # Output the line with all appropriate matches.
    462   dirout="${dirout}" optout="${optout}" ./tmpmultilib2
    463 done
    464 
    465 # Terminate the list of string.
    466 echo "NULL"
    467 echo "};"
    468 
    469 # Output rules used for multilib reuse.
    470 echo ""
    471 echo "static const char *const multilib_reuse_raw[] = {"
    472 for rrule in ${multilib_reuse}; do
    473   # The left part of the rule are the options we used to build multilib.
    474   # The right part of the rule are the options that can reuse this multilib.
    475   combo=`echo ${rrule} | sed -e 's/=.*$//' -e 's/\./=/g'`
    476   copts=`echo ${rrule} | sed -e 's/^.*=//' -e 's/\./=/g'`
    477   # The variable ${combinations} are the option combinations we will build
    478   # multilib from.  If the combination in the left part of reuse rule isn't
    479   # in this variable, it means no multilib will be built for current reuse
    480   # rule.  Thus the reuse purpose specified by current rule is meaningless.
    481   if expr "${combinations} " : ".*/${combo}/.*" > /dev/null; then
    482     if expr "${combination_space} " : ".*/${copts}/.*" > /dev/null; then
    483       combo="/${combo}/"
    484       dirout=`./tmpmultilib3 "${combo}" "${todirnames}" "${toosdirnames}" "${enable_multilib}"`
    485       copts="/${copts}/"
    486       optout=`./tmpmultilib4 "${copts}" "${options}"`
    487       # Output the line with all appropriate matches.
    488       dirout="${dirout}" optout="${optout}" ./tmpmultilib2
    489     else
    490       echo "The rule ${rrule} contains an option absent from MULTILIB_OPTIONS." >&2
    491       exit 1
    492     fi
    493   else
    494     echo "The rule ${rrule} is trying to reuse nonexistent multilib." >&2
    495     exit 1
    496   fi
    497 done
    498 
    499 # Terminate the list of string.
    500 echo "NULL"
    501 echo "};"
    502 
    503 # Output all of the matches now as option and that is the same as that, with
    504 # a semicolon trailer.  Include all of the normal options as well.
    505 # Note, the format of the matches is reversed compared
    506 # to what we want, so switch them around.
    507 echo ""
    508 echo "static const char *const multilib_matches_raw[] = {"
    509 for match in ${matches}; do
    510   l=`echo ${match} | sed -e 's/=.*$//' -e 's/?/=/g'`
    511   r=`echo ${match} | sed -e 's/^.*=//' -e 's/?/=/g'`
    512   echo "\"${r} ${l};\","
    513 done
    514 for set in ${options}; do
    515   for opt in `echo ${set} | sed -e 's_[/|]_ _'g`; do
    516     echo "\"${opt} ${opt};\","
    517   done
    518 done
    519 echo "NULL"
    520 echo "};"
    521 
    522 # Output the default options now
    523 echo ""
    524 echo "static const char *multilib_extra = \"${extra}\";"
    525 
    526 # Output the exclusion rules now
    527 echo ""
    528 echo "static const char *const multilib_exclusions_raw[] = {"
    529 for rule in ${exclusions}; do
    530   s=`echo ${rule} | sed -e 's,/, ,g'`
    531   echo "\"${s};\","
    532 done
    533 echo "NULL"
    534 echo "};"
    535 
    536 # Output the options now
    537 moptions=`echo ${options} | sed -e 's,[ 	][ 	]*, ,g'`
    538 echo ""
    539 echo "static const char *multilib_options = \"${moptions}\";"
    540 
    541 # Finally output the disable flag if specified
    542 if [ "x${disable_multilib}" = xyes ]; then
    543   echo ""
    544   echo "#define DISABLE_MULTILIB  1"
    545 fi
    546 
    547 cd ..
    548 rm -r tmpmultilib.$$
    549 
    550 exit 0
    551