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