build.sh

   1 #!/bin/sh
   2 # ===========================================================================
   3 #
   4 # NAME
   5 #   build.sh - extract, configure, build and install the X Window System
   6 #
   7 # SYNOPSIS
   8 #   build.sh [options] [prefix]
   9 #   build.sh [-L]
  10 #
  11 # DESCRIPTION
  12 #   The script ultimate goal is to build all of the X Window and some of its
  13 #   dependencies from source.
  14 #
  15 #   X.Org Modular Tree Developer's Guide
  16 #
  17 #   Please consult the guide at http://www.x.org/wiki/ModularDevelopersGuide
  18 #   It provides detailed instructions on the build tools to install, where to
  19 #   find the script and how to invoke it.
  20 #
  21 #   The X Window System Source Code
  22 #
  23 #   The source code is hosted by freedesktop.org and is composed of over 200
  24 #   modules under the git source code management system. X.Org releases are
  25 #   available at http://www.x.org/releases/ in the form of software packages.
  26 #
  27 #   Basic Operation
  28 #
  29 #   The script goes through its list of modules to build. If the source code is
  30 #   not on disk, it attempts to obtain it from git if the --clone option is
  31 #   specified. If not, it looks for a package archive file on disk. If it is
  32 #   still not found, the module is skipped.
  33 #
  34 #   The script then runs the appropriate configure script, either autogen.sh
  35 #   for git modules or the autoconf generated configure script for package
  36 #   archives.
  37 #
  38 # FEATURES
  39 #   Over time, functionality have been added to help building a large
  40 #   number modules. Progress report, handling build breaks, supporting the
  41 #   GNU Build System features, final build report, and so on.
  42 #
  43 #   Building from a Custom Modules List
  44 #
  45 #   Starting from the list generated using the -L option, remove unwanted
  46 #   modules. You may also add your own module or add specific configure
  47 #   options for some modules to meet your configuration needs. Using the
  48 #   --modfile option, your list replaces the built-in list of the script.
  49 #
  50 #   Resuming Build After a Break
  51 #
  52 #   The script can resume building at the last point of failure. This saves a
  53 #   lot of build time as the modules already built are skipped. The --autoresume
  54 #   option can be used with --modfile such that only the modules you care about
  55 #   are built and revisited until successful completion.
  56 #
  57 #   Specifying Custom Build Commands
  58 #
  59 #   By default, the script invokes the make program with the target "all" and
  60 #   "install". Some options like -c, -D, or -d alter the targets the make
  61 #   program builds, but you can specify your own command instead. Using the
  62 #   --cmd option, provide a different make or git command.
  63 #
  64 #   Specifying Configuration Options to Specific Modules
  65 #
  66 #   In the modulesfile used by the --modfile option, add any configuration
  67 #   options you want to pass to the modules as it gets configures by autoconf.
  68 #   Write the configure options next to the module name in the file.
  69 #   It could be something like --enable-strict-compilation for example.
  70 #
  71 # OPTIONS
  72 #   -a          Do NOT run auto config tools (autogen.sh, configure)
  73 #   -b          Use .build.unknown build directory
  74 #   -c          Run make clean in addition to "all install"
  75 #   -D          Run make dist in addition to "all install"
  76 #   -d          Run make distcheck in addition "all install"
  77 #   -g          Compile and link with debug information
  78 #   -L          Just list modules to build
  79 #   -h, --help  Display this help and exit successfully
  80 #   -n          Do not quit after error; just print error message
  81 #   -o module/component
  82 #               Build just this module/component
  83 #   -p          Update source code before building (git pull --rebase)
  84 #   -s sudo   The command name providing superuser privilege
  85 #   --autoresume resumefile
  86 #               Append module being built to, and autoresume from, resumefile
  87 #   --check     Run make check in addition "all install"
  88 #   --clone     Clone non-existing repositories (uses \$GITROOT if set)
  89 #   --cmd command
  90 #               Execute arbitrary git, gmake, or make command
  91 #   --confflags options
  92 #               Pass options to autgen.sh/configure of all modules
  93 #   --modfile modulesfile
  94 #               Only process the module/components specified in modulesfile
  95 #               Any text after, and on the same line as, the module/component
  96 #               is assumed to be configuration options for the configuration
  97 #               of each module/component specifically
  98 #   --retry-v1  Remake 'all' on failure with Automake silent rules disabled
  99 #
 100 # PREFIX
 101 #   An absolute filename where GNU "make" will install binaries, libraries and
 102 #   other installable files. The value is passed to Autoconf through the
 103 #   --prefix option.
 104 #
 105 # FILES
 106 #   resumefile
 107 #   When using --autoresume, the script reads and skips modules tagged with
 108 #   "PASS" and resume building at the module tagged with "FAIL". The resumefile
 109 #   file is not intended to be user edited.
 110 #
 111 #   modulesfile
 112 #   When using --modfile, the script replaces its internal modules list with
 113 #   the list contained in the file. This allows you to build only the modules
 114 #   you care about and to add third party modules or modules you create.
 115 #   It is helpful to initialized the file using the -L option.#
 116 #
 117 # ENVIRONMENT
 118 #   Environment variables specific to build.sh:
 119 #
 120 #   PREFIX      Install architecture-independent files in PREFIX [/usr/local]
 121 #               Each module/components is invoked with --prefix
 122 #   EPREFIX     Install architecture-dependent files in EPREFIX [PREFIX]
 123 #               Each module/components is invoked with --exec-prefix
 124 #   BINDIR      Install user executables [EPREFIX/bin]
 125 #               Each module/components is invoked with --bindir
 126 #   DATAROOTDIR Install read-only arch-independent data root [PREFIX/share]
 127 #               Each module/components is invoked with --datarootdir
 128 #   DATADIR     Install read-only architecture-independent data [DATAROOTDIR]
 129 #               Each module/components is invoked with --datadir
 130 #   LIBDIR      Install object code libraries [EPREFIX/lib]
 131 #               Each module/components is invoked with --libdir
 132 #   LOCALSTATEDIR
 133 #               Modifiable single-machine data [PREFIX/var]
 134 #               Each module/components is invoked with --localstatedir
 135 #   QUIET       Do not print messages saying which checks are being made
 136 #               Each module/components is invoked with --quite
 137 #   GITROOT     Source code repository path [git://anongit.freedesktop.org/git]
 138 #               Optional when using --clone to update source code before building
 139 #   CONFFLAGS   Configure options to pass to all Autoconf configure scripts
 140 #               Refer to 'configure --help' from any module/components
 141 #
 142 #  Environment variables defined by the GNU Build System:
 143 #
 144 #  ACLOCAL     The aclocal cmd name [aclocal -I ${DESTDIR}/${DATADIR}/aclocal]
 145 #  DESTDIR     Path to the staging area where installed objects are relocated
 146 #  MAKE        The name of the make command [make]
 147 #  MAKEFLAGS   Options to pass to all $(MAKE) invocations
 148 #  CC          C compiler command
 149 #  CFLAGS      C compiler flags
 150 #  LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
 151 #              nonstandard directory <lib dir>
 152 #  CPPFLAGS    C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
 153 #              you have headers in a nonstandard directory <include dir>
 154 #  CPP         C preprocessor
 155 #
 156 #  Environment variables defined by the shell:
 157 #  PATH        List of directories that the shell searches for commands
 158 #              $DESTDIR/$BINDIR is prepended
 159 #
 160 #  Environment variables defined by the dynamic linker:
 161 #  LD_LIBRARY_PATH
 162 #              List directories that the linker searches for shared objects
 163 #              $DESTDIR/$LIBDIR is prepended
 164 #
 165 #  Environment variables defined by the pkg-config system:
 166 #
 167 #  PKG_CONFIG_PATH
 168 #              List directories that pkg-config searches for libraries
 169 #              $DESTDIR/$DATADIR/pkgconfig and
 170 #              $DESTDIR/$LIBDIR/pkgconfig are prepended
 171 #
 172 # PORTABILITY
 173 #  This script is intended to run on any platform supported by X.Org.
 174 #  The script must be able to run in a Bourne shell.
 175 #
 176 # ===========================================================================
 177
 178 envoptions() {
 179 cat << EOF
 180 Environment variables specific to build.sh:
 181   PREFIX      Install architecture-independent files in PREFIX [/usr/local]
 182               Each module/components is invoked with --prefix
 183   EPREFIX     Install architecture-dependent files in EPREFIX [PREFIX]
 184               Each module/components is invoked with --exec-prefix
 185   BINDIR      Install user executables [EPREFIX/bin]
 186               Each module/components is invoked with --bindir
 187   DATAROOTDIR Install read-only arch-independent data root [PREFIX/share]
 188               Each module/components is invoked with --datarootdir
 189   DATADIR     Install read-only architecture-independent data [DATAROOTDIR]
 190               Each module/components is invoked with --datadir
 191   LIBDIR      Install object code libraries [EPREFIX/lib]
 192               Each module/components is invoked with --libdir
 193   LOCALSTATEDIR
 194               Modifiable single-machine data [PREFIX/var]
 195               Each module/components is invoked with --localstatedir
 196   QUIET       Do not print messages saying which checks are being made
 197               Each module/components is invoked with --quite
 198   GITROOT     Source code repository path [git://anongit.freedesktop.org/git]
 199               Optional when using --clone to update source code before building
 200   CONFFLAGS   Configure options to pass to all Autoconf configure scripts
 201               Refer to 'configure --help' from any module/components
 202
 203 Environment variables defined by the GNU Build System:
 204   ACLOCAL     The aclocal cmd name [aclocal -I \${DESTDIR}/\${DATADIR}/aclocal]
 205   DESTDIR     Path to the staging area where installed objects are relocated
 206   MAKE        The name of the make command [make]
 207   MAKEFLAGS   Options to pass to all \$(MAKE) invocations
 208   CC          C compiler command
 209   CFLAGS      C compiler flags
 210   LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
 211               nonstandard directory <lib dir>
 212   CPPFLAGS    C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
 213               you have headers in a nonstandard directory <include dir>
 214   CPP         C preprocessor
 215
 216 Environment variables defined by the shell:
 217   PATH        List of directories that the shell searches for commands
 218               \$DESTDIR/\$BINDIR is prepended
 219
 220 Environment variables defined by the dynamic linker:
 221   LD_LIBRARY_PATH
 222               List directories that the linker searches for shared objects
 223               \$DESTDIR/\$LIBDIR is prepended
 224
 225 Environment variables defined by the pkg-config system:
 226   PKG_CONFIG_PATH
 227               List directories that pkg-config searches for libraries
 228               \$DESTDIR/\$DATADIR/pkgconfig and
 229               \$DESTDIR/\$LIBDIR/pkgconfig are prepended
 230 EOF
 231 }
 232
 233 setup_buildenv() {
 234
 235     # Remember if the user had supplied a value through env var or cmd line
 236     # A value from cmd line takes precedence of the shell environment
 237     PREFIX_USER=${PREFIX:+yes}
 238     EPREFIX_USER=${EPREFIX:+yes}
 239     BINDIR_USER=${BINDIR:+yes}
 240     DATAROOTDIR_USER=${DATAROOTDIR:+yes}
 241     DATADIR_USER=${DATADIR:+yes}
 242     LIBDIR_USER=${LIBDIR:+yes}
 243     LOCALSTATEDIR_USER=${LOCALSTATEDIR:+yes}
 244
 245     # Assign a default value if no value was supplied by the user
 246     PREFIX=${PREFIX:-/usr/local}
 247     EPREFIX=${EPREFIX:-$PREFIX}
 248     BINDIR=${BINDIR:-$EPREFIX/bin}
 249     DATAROOTDIR=${DATAROOTDIR:-$PREFIX/share}
 250     DATADIR=${DATADIR:-$DATAROOTDIR}
 251     LIBDIR=${LIBDIR:-$EPREFIX/lib}
 252     LOCALSTATEDIR=${LOCALSTATEDIR:-$PREFIX/var}
 253
 254     # Support previous usage of LIBDIR which was a subdir relative to PREFIX
 255     # We use EPREFIX as this is what PREFIX really meant at the time
 256     if [ X"$LIBDIR" != X ]; then
 257         if [ X"`expr $LIBDIR : "\(.\)"`" != X/ ]; then
 258             echo ""
 259             echo "Warning: this usage of \$LIBDIR is deprecated. Use a full path name."
 260             echo "The supplied value \"$LIBDIR\" has been replaced with $EPREFIX/$LIBDIR."
 261             echo ""
 262                 LIBDIR=$EPREFIX/$LIBDIR
 263         fi
 264     fi
 265
 266     # All directories variables must be full path names
 267     check_full_path $PREFIX PREFIX
 268     check_full_path $EPREFIX EPREFIX
 269     check_full_path $BINDIR BINDIR
 270     check_full_path $DATAROOTDIR DATAROOTDIR
 271     check_full_path $DATADIR DATADIR
 272     check_full_path $LIBDIR LIBDIR
 273     check_full_path $LOCALSTATEDIR LOCALSTATEDIR
 274
 275     # This will catch the case where user forgets to set PREFIX
 276     # and does not have write permission in the /usr/local default location
 277     check_writable_dir ${DESTDIR}${PREFIX} PREFIX
 278
 279     # Must create local aclocal dir or aclocal fails
 280     ACLOCAL_LOCALDIR="${DESTDIR}${DATADIR}/aclocal"
 281     $SUDO mkdir -p ${ACLOCAL_LOCALDIR}
 282
 283     # The following is required to make aclocal find our .m4 macros
 284     ACLOCAL=${ACLOCAL:="aclocal"}
 285     ACLOCAL="${ACLOCAL} -I ${ACLOCAL_LOCALDIR}"
 286     export ACLOCAL
 287
 288     # The following is required to make pkg-config find our .pc metadata files
 289     PKG_CONFIG_PATH=${DESTDIR}${DATADIR}/pkgconfig:${DESTDIR}${LIBDIR}/pkgconfig${PKG_CONFIG_PATH+:$PKG_CONFIG_PATH}
 290     export PKG_CONFIG_PATH
 291
 292     # Set the library path so that locally built libs will be found by apps
 293     LD_LIBRARY_PATH=${DESTDIR}${LIBDIR}${LD_LIBRARY_PATH+:$LD_LIBRARY_PATH}
 294     export LD_LIBRARY_PATH
 295
 296     # Set the path so that locally built apps will be found and used
 297     PATH=${DESTDIR}${BINDIR}${PATH+:$PATH}
 298     export PATH
 299
 300     # Choose which make program to use
 301     MAKE=${MAKE:="make"}
 302
 303     # Create the log file directory
 304     $SUDO mkdir -p ${DESTDIR}${LOCALSTATEDIR}/log
 305 }
 306
 307 # explain where a failure occurred
 308 # if you find this message in the build output it can help tell you where the failure occurred
 309 # arguments:
 310 #   $1 - which command failed
 311 #   $2 - module
 312 #   $3 - component
 313 # returns:
 314 #   (irrelevant)
 315 failed() {
 316     cmd=$1
 317     module=$2
 318     component=$3
 319     echo "build.sh: \"$cmd\" failed on $module${component:+/}$component"
 320     failed_components="$failed_components $module${component:+/}$component"
 321 }
 322
 323 # print a pretty title to separate the processing of each module
 324 # arguments:
 325 #   $1 - module
 326 #   $2 - component
 327 #   $3 - configuration options
 328 # returns:
 329 #   (irrelevant)
 330 module_title() {
 331     module=$1
 332     component=$2
 333     confopts="$3"
 334     # preconds
 335     if [ X"$module" = X ]; then
 336         return
 337     fi
 338
 339     echo ""
 340     echo "======================================================================"
 341     echo "==  Processing:  \"$module${component:+/}$component\""
 342     echo "==        configuration options:  $CONFFLAGS $confopts"
 343 }
 344
 345 # Search for tarballs in either cwd or under a module directory
 346 # The tarball is always extracted in either one of these locations:
 347 #   - modules with components: under the module subdir (e.g lib/libX11-1.4.0)
 348 #   - modules without components: under cwd (e.g xserver-1.14.0)
 349 # The tarballs are expected to be under one of the locations described above
 350 # The location of the tarball does not dictate where it is extracted
 351 # arguments:
 352 #   $1 - module
 353 #   $2 - component
 354 # returns:
 355 #   0 - good (either no tarballs or successful extract)
 356 #   1 - bad
 357 checkfortars() {
 358     module=$1
 359     component=$2
 360
 361     # The package stem is the part of the tar file name that identifies
 362     # the git module archived source. Ex: xclock, pixman, libX11
 363     # For modules without components, the module name is used by default.
 364     pkg_stem=${component:-$module}
 365
 366     # Handle special cases where the module or component directory
 367     # does not match the package name and/or the package root dir
 368     case $module in
 369         "data")
 370             case $component in
 371                 "cursors") pkg_stem="xcursor-themes" ;;
 372                 "bitmaps") pkg_stem="xbitmaps" ;;
 373             esac
 374             ;;
 375         "font")
 376             if [ X"$component" != X"encodings" ]; then
 377                 pkg_stem="font-$component"
 378             fi
 379             ;;
 380         "lib")
 381             case $component in
 382                 "libXRes") pkg_stem="libXres" ;;
 383                 "libxtrans") pkg_stem="xtrans" ;;
 384             esac
 385             ;;
 386         "proto")
 387             case $component in
 388                 "x11proto") pkg_stem="xproto" ;;
 389             esac
 390             ;;
 391         "util")
 392             case $component in
 393                 "cf") pkg_stem="xorg-cf-files" ;;
 394                 "macros") pkg_stem="util-macros" ;;
 395             esac
 396             ;;
 397         "xcb")
 398             case $component in
 399                 "proto")
 400                     pkg_stem="xcb-proto"
 401                     ;;
 402                 "pthread-stubs")
 403                     pkg_stem="libpthread-stubs"
 404                     ;;
 405                 "libxcb")
 406                     pkg_stem="libxcb"
 407                     ;;
 408                 util*)
 409                     pkg_stem="xcb-$component"
 410                     ;;
 411             esac
 412             ;;
 413         "mesa")
 414             case $component in
 415                 "drm")
 416                     pkg_stem="libdrm"
 417                     ;;
 418                 "mesa")
 419                     pkg_stem="MesaLib"
 420                     ;;
 421             esac
 422             ;;
 423         "xserver")
 424             pkg_stem="xorg-server"
 425             ;;
 426     esac
 427
 428     # Search for tarballs in both the module and the src top directory
 429     for ii in $module .; do
 430         for jj in bz2 gz xz; do
 431
 432             # Select from the list the last tarball with a specific pkg_stem
 433             pkg_tarfile=`ls -1rt $ii/$pkg_stem-[0-9]*.tar.$jj 2> /dev/null | tail -n 1`
 434
 435             # Extract the tarball under the module directory
 436             # For modules without components, extract in top level dir
 437             if [ X"$pkg_tarfile" != X ]; then
 438
 439                 # Get the package version and archived toplevel directory
 440                 pkg_version=`echo $pkg_tarfile | sed 's,.*'$pkg_stem'-\(.*\)\.tar\.'$jj',\1,'`
 441                 pkg_root_dir="$pkg_stem-$pkg_version"
 442                 pkg_root_dir=`echo $pkg_root_dir | sed 's,MesaLib,Mesa,'`
 443
 444                 # Find where to extract the tar file
 445                 old_srcdir=$SRCDIR
 446                 if [ X"$component" = X ]; then
 447                     # For modules with no components (i.e xserver)
 448                     pkg_extract_dir="."
 449                     SRCDIR=$pkg_root_dir
 450                 else
 451                     # For modules with components (i.e xcb/proto or lib/libXi)
 452                     pkg_extract_dir=$module
 453                     SRCDIR=$module/$pkg_root_dir
 454                 fi
 455
 456                 if [ ! -d $SRCDIR ]; then
 457                     mkdir -p $module
 458                     case $jj in
 459                         "bz2")
 460                             pkg_tar_opts=xjf
 461                             ;;
 462                         "gz")
 463                             pkg_tar_opts=xzf
 464                             ;;
 465                         "xz")
 466                             pkg_tar_opts=xJf
 467                             ;;
 468                     esac
 469                     tar $pkg_tar_opts $pkg_tarfile -C $pkg_extract_dir
 470                     if [ $? -ne 0 ]; then
 471                         SRCDIR=${old_srcdir}
 472                         echo "Unable to extract $pkg_tarfile for $module module"
 473                         failed tar $module $component
 474                         return 1
 475                     fi
 476                 fi
 477                 return 0
 478             fi
 479         done
 480     done
 481
 482     return 0
 483 }
 484
 485 # perform a clone of a git repository
 486 # this function provides the mapping between module/component names
 487 # and their location in the fd.o repository
 488 # arguments:
 489 #   $1 - module
 490 #   $2 - component (optional)
 491 # returns:
 492 #   0 - good
 493 #   1 - bad
 494 clone() {
 495     module=$1
 496     component=$2
 497     # preconds
 498     if [ X"$module" = X ]; then
 499         echo "clone() required first argument is missing"
 500         return 1
 501     fi
 502
 503     case $module in
 504     "pixman")
 505         BASEDIR=""
 506         ;;
 507     "xcb")
 508         BASEDIR=""
 509         ;;
 510     "mesa")
 511         BASEDIR=""
 512         ;;
 513     "xkeyboard-config")
 514         BASEDIR=""
 515         ;;
 516     "libevdev")
 517         BASEDIR=""
 518         ;;
 519     *)
 520         BASEDIR="xorg/"
 521         ;;
 522     esac
 523
 524     DIR="$module${component:+/}$component"
 525     GITROOT=${GITROOT:="git://anongit.freedesktop.org/git"}
 526
 527     if [ ! -d "$DIR" ]; then
 528         git clone "$GITROOT/$BASEDIR$DIR" "$DIR"
 529         if [ $? -ne 0 ]; then
 530             echo "Failed to clone $module${component:+/}$component. Ignoring."
 531             clonefailed_components="$clonefailed_components $module${component:+/}$component"
 532             return 1
 533         fi
 534         old_pwd=`pwd`
 535         cd $DIR
 536         if [ $? -ne 0 ]; then
 537             echo "Failed to cd to $module${component:+/}$component. Ignoring."
 538             clonefailed_components="$clonefailed_components $module${component:+/}$component"
 539             return 1
 540         return 1
 541         fi
 542         git submodule init
 543         if [ $? -ne 0 ]; then
 544             echo "Failed to initialize $module${component:+/}$component submodule. Ignoring."
 545             clonefailed_components="$clonefailed_components $module${component:+/}$component"
 546             return 1
 547         fi
 548         git submodule update
 549         if [ $? -ne 0 ]; then
 550             echo "Failed to update $module${component:+/}$component submodule. Ignoring."
 551             clonefailed_components="$clonefailed_components $module${component:+/}$component"
 552             return 1
 553         fi
 554         cd ${old_pwd}
 555     else
 556         echo "git cannot clone into an existing directory $module${component:+/}$component"
 557         return 1
 558     fi
 559
 560     return 0
 561 }
 562
 563 # perform processing of each module/component
 564 # arguments:
 565 #   $1 - module
 566 #   $2 - component
 567 #   $3 - configure options
 568 # returns:
 569 #   0 - good
 570 #   1 - bad
 571 process() {
 572     needs_config=0
 573
 574     module=$1
 575     component=$2
 576     confopts="$3"
 577     # preconds
 578     if [ X"$module" = X ]; then
 579         echo "process() required first argument is missing"
 580         return 1
 581     fi
 582
 583     module_title $module "$component" "$confopts"
 584
 585     SRCDIR=""
 586     CONFCMD=""
 587     if [ -f $module${component:+/}$component/autogen.sh ]; then
 588         SRCDIR="$module${component:+/}$component"
 589         CONFCMD="autogen.sh"
 590     elif [ X"$CLONE" != X ]; then
 591         clone $module $component
 592         if [ $? -eq 0 ]; then
 593             SRCDIR="$module${component:+/}$component"
 594             CONFCMD="autogen.sh"
 595         fi
 596         needs_config=1
 597     else
 598         checkfortars $module $component
 599         if [ $? -eq 0 ]; then
 600             if [ X"$SRCDIR" = X ]; then
 601                 echo "$module${component:+/}$component does not exist, skipping."
 602                 nonexistent_components="$nonexistent_components $module${component:+/}$component"
 603                 return 0
 604             fi
 605             CONFCMD="configure"
 606         else
 607             return 1
 608         fi
 609     fi
 610
 611     old_pwd=`pwd`
 612     cd $SRCDIR
 613     if [ $? -ne 0 ]; then
 614         failed cd1 $module $component
 615         return 1
 616     fi
 617
 618     if [ X"$GITCMD" != X ]; then
 619         $GITCMD
 620         rtn=$?
 621         cd $old_pwd
 622
 623         if [ $rtn -ne 0 ]; then
 624             failed "$GITCMD" $module $component
 625             return 1
 626         fi
 627         return 0
 628     fi
 629
 630     if [ X"$PULL" != X ]; then
 631         git pull --rebase
 632         if [ $? -ne 0 ]; then
 633             failed "git pull" $module $component
 634             cd $old_pwd
 635             return 1
 636         fi
 637         # The parent module knows which commit the submodule should be at
 638         git submodule update
 639         if [ $? -ne 0 ]; then
 640             failed "git submodule update" $module $component
 641             return 1
 642         fi
 643     fi
 644
 645     # Build outside source directory
 646     if [ X"$DIR_ARCH" != X ] ; then
 647         mkdir -p "$DIR_ARCH"
 648         if [ $? -ne 0 ]; then
 649             failed mkdir $module $component
 650             cd $old_pwd
 651             return 1
 652         fi
 653         cd "$DIR_ARCH"
 654         if [ $? -ne 0 ]; then
 655             failed cd2 $module $component
 656             cd ${old_pwd}
 657             return 1
 658         fi
 659     fi
 660
 661     # Use "sh autogen.sh" since some scripts are not executable in CVS
 662     if [ $needs_config -eq 1 ] || [ X"$NOAUTOGEN" = X ]; then
 663         sh ${DIR_CONFIG}/${CONFCMD} \
 664             ${PREFIX_USER:+--prefix="$PREFIX"} \
 665             ${EPREFIX_USER:+--exec-prefix="$EPREFIX"} \
 666             ${BINDIR_USER:+--bindir="$BINDIR"} \
 667             ${DATAROOTDIR_USER:+--datarootdir="$DATAROOTDIR"} \
 668             ${DATADIR_USER:+--datadir="$DATADIR"} \
 669             ${LIBDIR_USER:+--libdir="$LIBDIR"} \
 670             ${LOCALSTATEDIR_USER:+--localstatedir="$LOCALSTATEDIR"} \
 671             ${QUIET:+--quiet} \
 672             ${CONFFLAGS} $confopts \
 673             ${CC:+CC="$CC"} \
 674             ${CPP:+CPP="$CPP"} \
 675             ${CPPFLAGS:+CPPFLAGS="$CPPFLAGS"} \
 676             ${CFLAGS:+CFLAGS="$CFLAGS"} \
 677             ${LDFLAGS:+LDFLAGS="$LDFLAGS"}
 678         if [ $? -ne 0 ]; then
 679             failed ${CONFCMD} $module $component
 680             cd $old_pwd
 681             return 1
 682         fi
 683     fi
 684
 685     # A custom 'make' target list was supplied through --cmd option
 686     if [ X"$MAKECMD" != X ]; then
 687         ${MAKE} $MAKEFLAGS $MAKECMD
 688         rtn=$?
 689         cd $old_pwd
 690
 691         if [ $rtn -ne 0 ]; then
 692             failed "$MAKE $MAKEFLAGS $MAKECMD" $module $component
 693             return 1
 694         fi
 695         return 0
 696     fi
 697
 698     ${MAKE} $MAKEFLAGS
 699     if [ $? -ne 0 ]; then
 700         # Rerun with Automake silent rules disabled to see failing gcc statement
 701         if [ X"$RETRY_VERBOSE" != X ]; then
 702             echo ""
 703             echo "build.sh: Rebuilding $component with Automake silent rules disabled"
 704             ${MAKE} $MAKEFLAGS V=1
 705         fi
 706         failed "$MAKE $MAKEFLAGS" $module $component
 707         cd $old_pwd
 708         return 1
 709     fi
 710
 711     if [ X"$CHECK" != X ]; then
 712         ${MAKE} $MAKEFLAGS check
 713         if [ $? -ne 0 ]; then
 714             failed "$MAKE $MAKEFLAGS check" $module $component
 715             cd $old_pwd
 716             return 1
 717         fi
 718     fi
 719
 720     if [ X"$CLEAN" != X ]; then
 721         ${MAKE} $MAKEFLAGS clean
 722         if [ $? -ne 0 ]; then
 723             failed "$MAKE $MAKEFLAGS clean" $module $component
 724             cd $old_pwd
 725             return 1
 726         fi
 727     fi
 728
 729     if [ X"$DIST" != X ]; then
 730         ${MAKE} $MAKEFLAGS dist
 731         if [ $? -ne 0 ]; then
 732             failed "$MAKE $MAKEFLAGS dist" $module $component
 733             cd $old_pwd
 734             return 1
 735         fi
 736     fi
 737
 738     if [ X"$DISTCHECK" != X ]; then
 739         ${MAKE} $MAKEFLAGS distcheck
 740         if [ $? -ne 0 ]; then
 741             failed "$MAKE $MAKEFLAGS distcheck" $module $component
 742             cd $old_pwd
 743             return 1
 744         fi
 745     fi
 746
 747     $SUDO env LD_LIBRARY_PATH=$LD_LIBRARY_PATH ${MAKE} $MAKEFLAGS install
 748     if [ $? -ne 0 ]; then
 749         failed "$SUDO env LD_LIBRARY_PATH=$LD_LIBRARY_PATH $MAKE $MAKEFLAGS install" $module $component
 750         cd $old_pwd
 751         return 1
 752     fi
 753
 754     cd ${old_pwd}
 755
 756     return 0
 757 }
 758
 759 # process each module/component and handle:
 760 # LISTONLY, RESUME, NOQUIT, and BUILD_ONE
 761 # arguments:
 762 #   $1 - module
 763 #   $2 - component
 764 #   $3 - configure options
 765 # returns:
 766 #   0 - good
 767 #   1 - bad
 768 build() {
 769     module=$1
 770     component=$2
 771     confopts="$3"
 772     if [ X"$LISTONLY" != X ]; then
 773         echo "$module${component:+/}$component"
 774         return 0
 775     fi
 776
 777     if [ X"$RESUME" != X ]; then
 778         if [ X"$RESUME" = X"$module${component:+/}$component" ]; then
 779             unset RESUME
 780             # Resume build at this module
 781         else
 782             echo "Skipping $module${component:+/}$component..."
 783             return 0
 784         fi
 785     fi
 786
 787     process $module "$component" "$confopts"
 788     process_rtn=$?
 789     if [ X"$BUILT_MODULES_FILE" != X ]; then
 790         if [ $process_rtn -ne 0 ]; then
 791             echo "FAIL: $module${component:+/}$component" >> $BUILT_MODULES_FILE
 792         else
 793             echo "PASS: $module${component:+/}$component" >> $BUILT_MODULES_FILE
 794         fi
 795     fi
 796
 797     if [ $process_rtn -ne 0 ]; then
 798         echo "build.sh: error processing:  \"$module${component:+/}$component\""
 799         if [ X"$NOQUIT" = X ]; then
 800             exit 1
 801         fi
 802         return $process_rtn
 803     fi
 804
 805     if [ X"$BUILD_ONE" != X ]; then
 806         echo "Single-component build complete"
 807         exit 0
 808     fi
 809 }
 810
 811
 812 # just process the sub-projects supplied in the given file ($MODFILE)
 813 # in the order in which they are found in the list
 814 # (prerequisites and ordering are the responsibility of the user)
 815 # globals used:
 816 #   $MODFILE - readable file containing list of modules to process
 817 #              and their optional configuration options
 818 # arguments:
 819 #   (none)
 820 # returns:
 821 #   0 - good
 822 #   1 - bad
 823 process_module_file() {
 824     # preconds
 825     if [ X"$MODFILE" = X ]; then
 826         echo "internal process_module_file() error, \$MODFILE is empty"
 827         return 1
 828     fi
 829     if [ ! -r "$MODFILE" ]; then
 830         echo "module file '$MODFILE' is not readable or does not exist"
 831         return 1
 832     fi
 833
 834     # read from input file, skipping blank and comment lines
 835     while read line; do
 836         # skip blank lines
 837         if [ X"$line" = X ]; then
 838             continue
 839         fi
 840
 841         # skip comment lines
 842         echo "$line" | grep "^#" > /dev/null
 843         if [ $? -eq 0 ]; then
 844             continue
 845         fi
 846
 847         # parse each line to extract module, component and options name
 848         field1=`echo $line | cut -d' ' -f1`
 849         module=`echo $field1 | cut -d'/' -f1`
 850         component=`echo $field1 | cut -d'/' -s -f2`
 851         confopts=`echo $line | cut -d' ' -s -f2-`
 852
 853         build $module "$component" "$confopts"
 854
 855     done <"$MODFILE"
 856
 857     return 0
 858 }
 859
 860 usage() {
 861     basename="`expr "//$0" : '.*/\([^/]*\)'`"
 862     echo "Usage: $basename [options] [prefix]"
 863     echo "Options:"
 864     echo "  -a          Do NOT run auto config tools (autogen.sh, configure)"
 865     echo "  -b          Use .build.unknown build directory"
 866     echo "  -c          Run make clean in addition to \"all install\""
 867     echo "  -D          Run make dist in addition to \"all install\""
 868     echo "  -d          Run make distcheck in addition \"all install\""
 869     echo "  -g          Compile and link with debug information"
 870     echo "  -h, --help  Display this help and exit successfully"
 871     echo "  -n          Do not quit after error; just print error message"
 872     echo "  -o module/component"
 873     echo "              Build just this module/component"
 874     echo "  -p          Update source code before building (git pull --rebase)"
 875     echo "  -s sudo     The command name providing superuser privilege"
 876     echo "  --autoresume resumefile"
 877     echo "              Append module being built to, and autoresume from, <file>"
 878     echo "  --check     Run make check in addition \"all install\""
 879     echo "  --clone     Clone non-existing repositories (uses \$GITROOT if set)"
 880     echo "  --cmd command"
 881     echo "              Execute arbitrary git, gmake, or make command"
 882     echo "  --confflags options"
 883     echo "              Pass options to autgen.sh/configure of all modules"
 884     echo "  --modfile modulefile"
 885     echo "              Only process the module/components specified in modulefile"
 886     echo "              Any text after, and on the same line as, the module/component"
 887     echo "              is assumed to be configuration options for the configuration"
 888     echo "              of each module/component specifically"
 889     echo "  --retry-v1  Remake 'all' on failure with Automake silent rules disabled"
 890     echo ""
 891     echo "Usage: $basename -L"
 892     echo "  -L          Just list modules to build"
 893     echo ""
 894     envoptions
 895 }
 896
 897 # Ensure the named variable value contains a full path name
 898 # arguments:
 899 #   $1 - the variable value (the path to examine)
 900 #   $2 - the name of the variable
 901 # returns:
 902 #   returns nothing or exit on error with message
 903 check_full_path () {
 904     path=$1
 905     varname=$2
 906     if [ X"`expr $path : "\(.\)"`" != X/ ]; then
 907         echo "The path \"$path\" supplied by \"$varname\" must be a full path name"
 908         echo ""
 909         usage
 910         exit 1
 911     fi
 912 }
 913
 914 # Ensure the named variable value contains a writable directory
 915 # arguments:
 916 #   $1 - the variable value (the path to examine)
 917 #   $2 - the name of the variable
 918 # returns:
 919 #   returns nothing or exit on error with message
 920 check_writable_dir () {
 921     path=$1
 922     varname=$2
 923     if [ X"$SUDO" = X ]; then
 924         if [ ! -d "$path" ] || [ ! -w "$path" ]; then
 925             echo "The path \"$path\" supplied by \"$varname\" must be a writable directory"
 926             echo ""
 927             usage
 928             exit 1
 929         fi
 930     fi
 931 }
 932
 933 # perform sanity checks on cmdline args which require arguments
 934 # arguments:
 935 #   $1 - the option being examined
 936 #   $2 - the argument to the option
 937 # returns:
 938 #   if it returns, everything is good
 939 #   otherwise it exit's
 940 required_arg() {
 941     option=$1
 942     arg=$2
 943     # preconds
 944     if [ X"$option" = X ]; then
 945         echo "internal required_arg() error, missing first argument"
 946         exit 1
 947     fi
 948
 949     # check for an argument
 950     if [ X"$arg" = X ]; then
 951         echo "the '$option' option is missing its required argument"
 952         echo ""
 953         usage
 954         exit 1
 955     fi
 956
 957     # does the argument look like an option?
 958     echo $arg | grep "^-" > /dev/null
 959     if [ $? -eq 0 ]; then
 960         echo "the argument '$arg' of option '$option' looks like an option itself"
 961         echo ""
 962         usage
 963         exit 1
 964     fi
 965 }
 966
 967 #==============================================================================
 968 #                               Build All Modules
 969 # Globals:
 970 #   HOST_OS HOST_CPU
 971 # Arguments:
 972 #   None
 973 # Returns:
 974 #   None
 975 #==============================================================================
 976 build_all_modules() {
 977
 978     build util macros
 979     build font util
 980     build doc xorg-sgml-doctools
 981     build doc xorg-docs
 982     case $HOST_OS in
 983         Darwin)  build proto applewmproto;;
 984         CYGWIN*) build proto windowswmproto;;
 985     esac
 986     build proto bigreqsproto
 987     build proto compositeproto
 988     build proto damageproto
 989     build proto dmxproto
 990     build proto dri2proto
 991     build proto dri3proto
 992     build proto fixesproto
 993     build proto fontsproto
 994     build proto glproto
 995     build proto inputproto
 996     build proto kbproto
 997     build proto presentproto
 998     build proto randrproto
 999     build proto recordproto
1000     build proto renderproto
1001     build proto resourceproto
1002     build proto scrnsaverproto
1003     build proto videoproto
1004     build proto x11proto
1005     build proto xcmiscproto
1006     build proto xextproto
1007     build proto xf86bigfontproto
1008     build proto xf86dgaproto
1009     build proto xf86driproto
1010     build proto xf86vidmodeproto
1011     build proto xineramaproto
1012     build xcb proto
1013     # Required by mesa and depends on xproto
1014     build util makedepend
1015     build lib libxtrans
1016     build lib libXau
1017     build lib libXdmcp
1018     build xcb pthread-stubs
1019     build xcb libxcb
1020     build xcb util
1021     build xcb util-image
1022     build xcb util-keysyms
1023     build xcb util-renderutil
1024     build xcb util-wm
1025     build lib libX11
1026     build lib libXext
1027     case $HOST_OS in
1028         Darwin)  build lib libAppleWM;;
1029         CYGWIN*) build lib libWindowsWM;;
1030     esac
1031     build lib libdmx
1032     build lib libfontenc
1033     build lib libFS
1034     build lib libICE
1035     build lib libSM
1036     build lib libXt
1037     build lib libXmu
1038     build lib libXpm
1039     build lib libXaw
1040     build lib libXaw3d
1041     build lib libXfixes
1042     build lib libXcomposite
1043     build lib libXrender
1044     build lib libXdamage
1045     build lib libXcursor
1046     build lib libXfont
1047     build lib libXft
1048     build lib libXi
1049     build lib libXinerama
1050     build lib libxkbfile
1051     build lib libXrandr
1052     build lib libXRes
1053     build lib libXScrnSaver
1054     case $HOST_OS in
1055         Linux)
1056             build lib libxshmfence
1057             ;;
1058     esac
1059     build lib libXtst
1060     build lib libXv
1061     build lib libXvMC
1062     build lib libXxf86dga
1063     build lib libXxf86vm
1064     build lib libpciaccess
1065     build pixman ""
1066     build mesa drm
1067     build mesa mesa
1068     build data bitmaps
1069     build app appres
1070     build app bdftopcf
1071     build app beforelight
1072     build app bitmap
1073     build app editres
1074     build app fonttosfnt
1075     build app fslsfonts
1076     build app fstobdf
1077     build app iceauth
1078     build app ico
1079     build app listres
1080     build app luit
1081     build app mkcomposecache
1082     build app mkfontdir
1083     build app mkfontscale
1084     build app oclock
1085     build app rgb
1086     build app rendercheck
1087     build app rstart
1088     build app scripts
1089     build app sessreg
1090     build app setxkbmap
1091     build app showfont
1092     build app smproxy
1093     build app twm
1094     build app viewres
1095     build app x11perf
1096     build app xauth
1097     build app xbacklight
1098     build app xbiff
1099     build app xcalc
1100     build app xclipboard
1101     build app xclock
1102     build app xcmsdb
1103     build app xconsole
1104     build app xcursorgen
1105     build app xdbedizzy
1106     build app xditview
1107     build app xdm
1108     build app xdpyinfo
1109     build app xdriinfo
1110     build app xedit
1111     build app xev
1112     build app xeyes
1113     build app xf86dga
1114     build app xfd
1115     build app xfontsel
1116     build app xfs
1117     build app xfsinfo
1118     build app xgamma
1119     build app xgc
1120     build app xhost
1121     build app xinit
1122     build app xinput
1123     build app xkbcomp
1124     build app xkbevd
1125     build app xkbprint
1126     build app xkbutils
1127     build app xkill
1128     build app xload
1129     build app xlogo
1130     build app xlsatoms
1131     build app xlsclients
1132     build app xlsfonts
1133     build app xmag
1134     build app xman
1135     build app xmessage
1136     build app xmh
1137     build app xmodmap
1138     build app xmore
1139     build app xpr
1140     build app xprop
1141     build app xrandr
1142     build app xrdb
1143     build app xrefresh
1144     build app xscope
1145     build app xset
1146     build app xsetmode
1147     build app xsetroot
1148     build app xsm
1149     build app xstdcmap
1150     build app xvidtune
1151     build app xvinfo
1152     build app xwd
1153     build app xwininfo
1154     build app xwud
1155     build xserver ""
1156     case $HOST_OS in
1157         Linux) build libevdev "";;
1158     esac
1159     case $HOST_OS in
1160         Linux)
1161             build driver xf86-input-evdev
1162             build driver xf86-input-joystick
1163             ;;
1164         FreeBSD | NetBSD | OpenBSD | Dragonfly | GNU/kFreeBSD)
1165             build driver xf86-input-joystick
1166             ;;
1167     esac
1168     case $HOST_CPU in
1169         i*86 | amd64 | x86_64 | i86pc)
1170             build driver xf86-input-vmmouse
1171             ;;
1172     esac
1173     case $HOST_OS in
1174         Darwin)
1175             ;;
1176         *)
1177             build driver glamor
1178             build driver xf86-input-keyboard
1179             build driver xf86-input-mouse
1180             build driver xf86-input-synaptics
1181             build driver xf86-input-void
1182             case $HOST_OS in
1183                 FreeBSD)
1184                     case $HOST_CPU in
1185                         sparc64)
1186                             build driver xf86-video-sunffb
1187                             ;;
1188                     esac
1189                     ;;
1190                 NetBSD | OpenBSD)
1191                     build driver xf86-video-wsfb
1192                     build driver xf86-video-sunffb
1193                     ;;
1194                 Linux)
1195                     build driver xf86-video-sisusb
1196                     build driver xf86-video-sunffb
1197                     build driver xf86-video-v4l
1198                     build driver xf86-video-xgixp
1199                     case $HOST_CPU in
1200                         i*86)
1201                             # AMD Geode CPU. Driver contains 32 bit assembler code
1202                             build driver xf86-video-geode
1203                             ;;
1204                     esac
1205                     ;;
1206             esac
1207             case $HOST_CPU in
1208                 sparc | sparc64)
1209                     build driver xf86-video-suncg14
1210                     build driver xf86-video-suncg3
1211                     build driver xf86-video-suncg6
1212                     build driver xf86-video-sunleo
1213                     build driver xf86-video-suntcx
1214                     ;;
1215                 i*86 | amd64 | x86_64 | i86pc)
1216                     build driver xf86-video-i740
1217                     build driver xf86-video-intel
1218                     ;;
1219             esac
1220             build driver xf86-video-apm
1221             build driver xf86-video-ark
1222             build driver xf86-video-ast
1223             build driver xf86-video-ati
1224             build driver xf86-video-chips
1225             build driver xf86-video-cirrus
1226             build driver xf86-video-dummy
1227             build driver xf86-video-fbdev
1228             build driver xf86-video-glint
1229             build driver xf86-video-i128
1230             build driver xf86-video-mach64
1231             build driver xf86-video-mga
1232             build driver xf86-video-modesetting
1233             build driver xf86-video-neomagic
1234             build driver xf86-video-nested
1235             build driver xf86-video-nv
1236             build driver xf86-video-rendition
1237             build driver xf86-video-r128
1238             build driver xf86-video-s3
1239             build driver xf86-video-s3virge
1240             build driver xf86-video-savage
1241             build driver xf86-video-siliconmotion
1242             build driver xf86-video-sis
1243             build driver xf86-video-tdfx
1244             build driver xf86-video-tga
1245             build driver xf86-video-trident
1246             build driver xf86-video-tseng
1247             build driver xf86-video-vesa
1248             build driver xf86-video-vmware
1249             build driver xf86-video-voodoo
1250             ;;
1251     esac
1252     build data cursors
1253     build font encodings
1254     build font adobe-100dpi
1255     build font adobe-75dpi
1256     build font adobe-utopia-100dpi
1257     build font adobe-utopia-75dpi
1258     build font adobe-utopia-type1
1259     build font arabic-misc
1260     build font bh-100dpi
1261     build font bh-75dpi
1262     build font bh-lucidatypewriter-100dpi
1263     build font bh-lucidatypewriter-75dpi
1264     build font bh-ttf
1265     build font bh-type1
1266     build font bitstream-100dpi
1267     build font bitstream-75dpi
1268     build font bitstream-type1
1269     build font cronyx-cyrillic
1270     build font cursor-misc
1271     build font daewoo-misc
1272     build font dec-misc
1273     build font ibm-type1
1274     build font isas-misc
1275     build font jis-misc
1276     build font micro-misc
1277     build font misc-cyrillic
1278     build font misc-ethiopic
1279     build font misc-meltho
1280     build font misc-misc
1281     build font mutt-misc
1282     build font schumacher-misc
1283     build font screen-cyrillic
1284     build font sony-misc
1285     build font sun-misc
1286     build font winitzki-cyrillic
1287     build font xfree86-type1
1288     build font alias
1289     build util cf
1290     build util imake
1291     build util gccmakedep
1292     build util lndir
1293     build xkeyboard-config ""
1294     return 0
1295 }
1296
1297
1298 #------------------------------------------------------------------------------
1299 #                       Script main line
1300 #------------------------------------------------------------------------------
1301
1302 # Initialize variables controlling end of run reports
1303 failed_components=""
1304 nonexistent_components=""
1305 clonefailed_components=""
1306
1307 # Set variables supporting multiple binaries for a single source tree
1308 HAVE_ARCH="`uname -i`"
1309 DIR_ARCH=""
1310 DIR_CONFIG="."
1311
1312 # Set variables for conditionally building some components
1313 HOST_OS=`uname -s`
1314 export HOST_OS
1315 HOST_CPU=`uname -m`
1316 export HOST_CPU
1317
1318 # Process command line args
1319 while [ $# != 0 ]
1320 do
1321     case $1 in
1322     -a)
1323         NOAUTOGEN=1
1324         ;;
1325     -b)
1326         DIR_ARCH=".build.$HAVE_ARCH"
1327         DIR_CONFIG=".."
1328         ;;
1329     -c)
1330         CLEAN=1
1331         ;;
1332     -D)
1333         DIST=1
1334         ;;
1335     -d)
1336         DISTCHECK=1
1337         ;;
1338     -g)
1339         CFLAGS="${CFLAGS} -g3 -O0"
1340         ;;
1341     -h|--help)
1342         usage
1343         exit 0
1344         ;;
1345     -L)
1346         LISTONLY=1
1347         ;;
1348     -n)
1349         NOQUIT=1
1350         ;;
1351     -o)
1352         if [ -n "$BUILT_MODULES_FILE" ]; then
1353             echo "The '-o' and '--autoresume' options are mutually exclusive."
1354             usage
1355             exit 1
1356         fi
1357         required_arg $1 $2
1358         shift
1359         RESUME=`echo $1 | sed "s,/$,,"`
1360         BUILD_ONE=1
1361         ;;
1362     -p)
1363         PULL=1
1364         ;;
1365     -s)
1366         required_arg $1 $2
1367         shift
1368         SUDO=$1
1369         ;;
1370     --autoresume)
1371         if [ -n "$BUILD_ONE" ]; then
1372             echo "The '-o' and '--autoresume' options are mutually exclusive."
1373             usage
1374             exit 1
1375         fi
1376         required_arg $1 $2
1377         shift
1378         BUILT_MODULES_FILE=$1
1379         ;;
1380     --check)
1381         CHECK=1
1382         ;;
1383     --clone)
1384         CLONE=1
1385         ;;
1386     --cmd)
1387         required_arg $1 $2
1388         shift
1389         cmd1=`echo $1 | cut -d' ' -f1`
1390         cmd2=`echo $1 | cut -d' ' -f2`
1391
1392         # verify the command exists
1393         which $cmd1 > /dev/null 2>&1
1394         if [ $? -ne 0 ]; then
1395             echo "The specified command '$cmd1' does not appear to exist"
1396             echo ""
1397             usage
1398             exit 1
1399         fi
1400
1401         case X"$cmd1" in
1402             X"git")
1403                 GITCMD=$1
1404                 ;;
1405             X"make" | X"gmake")
1406                 MAKECMD=$cmd2
1407                 ;;
1408             *)
1409                 echo "The script can only process 'make', 'gmake', or 'git' commands"
1410                 echo "It can't process '$cmd1' commands"
1411                 echo ""
1412                 usage
1413                 exit 1
1414                 ;;
1415         esac
1416         ;;
1417     --confflags)
1418         shift
1419         CONFFLAGS=$1
1420         ;;
1421     --modfile)
1422         required_arg $1 $2
1423         shift
1424         if [ ! -r "$1" ]; then
1425             echo "can't find/read file '$1'"
1426             exit 1
1427         fi
1428         MODFILE=$1
1429         ;;
1430     --retry-v1)
1431         RETRY_VERBOSE=1
1432         ;;
1433     *)
1434         if [ X"$too_many" = Xyes ]; then
1435             echo "unrecognized and/or too many command-line arguments"
1436             echo "  PREFIX:               $PREFIX"
1437             echo "  Extra arguments:      $1"
1438             echo ""
1439             usage
1440             exit 1
1441         fi
1442
1443         # check that 'prefix' doesn't look like an option
1444         echo $1 | grep "^-" > /dev/null
1445         if [ $? -eq 0 ]; then
1446             echo "'prefix' appears to be an option"
1447             echo ""
1448             usage
1449             exit 1
1450         fi
1451
1452         PREFIX=$1
1453         too_many=yes
1454         ;;
1455     esac
1456
1457     shift
1458 done
1459
1460 # All user input has been obtained, set-up the user shell variables
1461 if [ X"$LISTONLY" = X ]; then
1462     setup_buildenv
1463     echo "Building to run $HOST_OS / $HOST_CPU ($HOST)"
1464     date
1465 fi
1466
1467 # if   there is a BUILT_MODULES_FILE
1468 # then start off by checking for and trying to build any modules which failed
1469 #      and aren't the last line
1470 if [ X"$BUILT_MODULES_FILE" != X -a -r "$BUILT_MODULES_FILE" ]; then
1471     built_lines=`cat $BUILT_MODULES_FILE | wc -l | sed 's:^ *::'`
1472     built_lines_m1=`expr $built_lines - 1`
1473     orig_BUILT_MODULES_FILE=$BUILT_MODULES_FILE
1474     unset BUILT_MODULES_FILE
1475     curline=1
1476     while read line; do
1477         built_status=`echo $line | cut -c-6`
1478         if [ X"$built_status" = X"FAIL: " ]; then
1479             line=`echo $line | cut -c7-`
1480             field1=`echo $line | cut -d' ' -f1`
1481             module=`echo $field1 | cut -d'/' -f1`
1482             component=`echo $field1 | cut -d'/' -s -f2`
1483             confopts=`echo $line | cut -d' ' -s -f2-`
1484
1485             build_ret=""
1486
1487             # quick check for the module in $MODFILE (if present)
1488             if [ X"$MODFILE" = X ]; then
1489                 build $module "$component" "$confopts"
1490                 if [ $? -eq 0 ]; then
1491                     build_ret="PASS"
1492                 fi
1493             else
1494                 cat $MODFILE | grep "$module${component:+/}$component" > /dev/null
1495                 if [ $? -eq 0 ]; then
1496                     build $module "$component" "$confopts"
1497                     if [ $? -eq 0 ]; then
1498                         build_ret="PASS"
1499                     fi
1500                 fi
1501             fi
1502
1503             if [ X"$build_ret" = X"PASS" ]; then
1504                 built_temp=`mktemp`
1505                 if [ $? -ne 0 ]; then
1506                     echo "can't create tmp file, $orig_BUILT_MODULES_FILE not modified"
1507                 else
1508                     head -n `expr $curline - 1` $orig_BUILT_MODULES_FILE > $built_temp
1509                     echo "PASS: $module${component:+/}$component" >> $built_temp
1510                     tail -n `expr $built_lines - $curline` $orig_BUILT_MODULES_FILE >> $built_temp
1511                     mv $built_temp $orig_BUILT_MODULES_FILE
1512                 fi
1513             fi
1514         fi
1515         if [ $curline -eq $built_lines_m1 ]; then
1516             break
1517         fi
1518         curline=`expr $curline + 1`
1519     done <"$orig_BUILT_MODULES_FILE"
1520
1521     BUILT_MODULES_FILE=$orig_BUILT_MODULES_FILE
1522     RESUME=`tail -n 1 $BUILT_MODULES_FILE | cut -c7-`
1523
1524     # remove last line of $BUILT_MODULES_FILE
1525     # to avoid a duplicate entry
1526     built_temp=`mktemp`
1527     if [ $? -ne 0 ]; then
1528         echo "can't create tmp file, last built item will be duplicated"
1529     else
1530         head -n $built_lines_m1 $BUILT_MODULES_FILE > $built_temp
1531         mv $built_temp $BUILT_MODULES_FILE
1532     fi
1533 fi
1534
1535 if [ X"$MODFILE" = X ]; then
1536     build_all_modules
1537 else
1538     process_module_file
1539 fi
1540
1541 if [ X"$LISTONLY" != X ]; then
1542     exit 0
1543 fi
1544
1545 # Print the end date/time to compare with the start date/time
1546 date
1547
1548 # Report about components that failed for one reason or another
1549 if [ X"$nonexistent_components" != X ]; then
1550     echo ""
1551     echo "***** Skipped components (not available) *****"
1552         echo "Could neither find a git repository (at the <module/component> paths)"
1553         echo "or a tarball (at the <module/> paths or ./) for:"
1554         echo "    <module/component>"
1555     for mod in $nonexistent_components; do
1556         echo "    $mod"
1557     done
1558     echo "You may want to provide the --clone option to build.sh"
1559     echo "to automatically git-clone the missing components"
1560     echo ""
1561 fi
1562
1563 if [ X"$failed_components" != X ]; then
1564     echo ""
1565     echo "***** Failed components *****"
1566     for mod in $failed_components; do
1567         echo "    $mod"
1568     done
1569     echo ""
1570 fi
1571
1572 if [ X"$CLONE" != X ] && [ X"$clonefailed_components" != X ];  then
1573     echo ""
1574     echo "***** Components failed to clone *****"
1575     for mod in $clonefailed_components; do
1576         echo "    $mod"
1577     done
1578     echo ""
1579 fi
1580