configure

   1 #!/bin/bash
   2 ##
   3 ##  configure
   4 ##
   5 ##  This script is the front-end to the build system. It provides a similar
   6 ##  interface to standard configure scripts with some extra bits for dealing
   7 ##  with toolchains that differ from the standard POSIX interface and
   8 ##  for extracting subsets of the source tree. In theory, reusable parts
   9 ##  of this script were intended to live in build/make/configure.sh,
  10 ##  but in practice, the line is pretty blurry.
  11 ##
  12 ##  This build system is based in part on the FFmpeg configure script.
  13 ##
  14
  15 #source_path="`dirname \"$0\"`"
  16 source_path=${0%/*}
  17 . "${source_path}/build/make/configure.sh"
  18
  19 show_help(){
  20     show_help_pre
  21     cat << EOF
  22 Advanced options:
  23   ${toggle_libs}                  don't build libraries
  24   ${toggle_examples}              don't build examples
  25   --libc=PATH                     path to alternate libc
  26   --as={yasm|nasm|auto}           use specified assembler [auto, yasm preferred]
  27   ${toggle_fast_unaligned}        don't use unaligned accesses, even when
  28                                   supported by hardware [auto]
  29   ${toggle_codec_srcs}            in/exclude codec library source code
  30   ${toggle_debug_libs}            in/exclude debug version of libraries
  31   ${toggle_md5}                   support for output of checksum data
  32   ${toggle_static_msvcrt}         use static MSVCRT (VS builds only)
  33   ${toggle_vp8}                   VP8 codec support
  34   ${toggle_psnr}                  output of PSNR data, if supported (encoders)
  35   ${toggle_mem_tracker}           track memory usage
  36   ${toggle_postproc}              postprocessing
  37   ${toggle_multithread}           multithreaded encoding and decoding.
  38   ${toggle_spatial_resampling}    spatial sampling (scaling) support
  39   ${toggle_realtime_only}         enable this option while building for real-time encoding
  40   ${toggle_runtime_cpu_detect}    runtime cpu detection
  41   ${toggle_shared}                shared library support
  42   ${toggle_small}                 favor smaller size over speed
  43   ${toggle_arm_asm_detok}         assembly version of the detokenizer (ARM platforms only)
  44   ${toggle_postproc_visualizer}   macro block / block level visualizers
  45
  46 Codecs:
  47   Codecs can be selectively enabled or disabled individually, or by family:
  48       --disable-<codec>
  49   is equivalent to:
  50       --disable-<codec>-encoder
  51       --disable-<codec>-decoder
  52
  53   Codecs available in this distribution:
  54 EOF
  55 #restore editor state '
  56
  57     local family;
  58     local last_family;
  59     local c;
  60     local str;
  61     for c in ${CODECS}; do
  62         family=${c%_*}
  63         if [ "${family}" != "${last_family}" ]; then
  64             [ -z "${str}" ] || echo "${str}"
  65             str="$(printf '    %10s:' ${family})"
  66         fi
  67         str="${str} $(printf '%10s' ${c#*_})"
  68         last_family=${family}
  69     done
  70     echo "${str}"
  71     show_help_post
  72 }
  73
  74 ##
  75 ## BEGIN APPLICATION SPECIFIC CONFIGURATION
  76 ##
  77
  78 # all_platforms is a list of all supported target platforms. Maintain
  79 # alphabetically by architecture, generic-gnu last.
  80 all_platforms="${all_platforms} armv5te-linux-rvct"
  81 all_platforms="${all_platforms} armv5te-linux-gcc"
  82 all_platforms="${all_platforms} armv5te-none-rvct"
  83 all_platforms="${all_platforms} armv5te-symbian-gcc"
  84 all_platforms="${all_platforms} armv5te-wince-vs8"
  85 all_platforms="${all_platforms} armv6-darwin-gcc"
  86 all_platforms="${all_platforms} armv6-linux-rvct"
  87 all_platforms="${all_platforms} armv6-linux-gcc"
  88 all_platforms="${all_platforms} armv6-none-rvct"
  89 all_platforms="${all_platforms} armv6-symbian-gcc"
  90 all_platforms="${all_platforms} armv6-wince-vs8"
  91 all_platforms="${all_platforms} iwmmxt-linux-rvct"
  92 all_platforms="${all_platforms} iwmmxt-linux-gcc"
  93 all_platforms="${all_platforms} iwmmxt-wince-vs8"
  94 all_platforms="${all_platforms} iwmmxt2-linux-rvct"
  95 all_platforms="${all_platforms} iwmmxt2-linux-gcc"
  96 all_platforms="${all_platforms} iwmmxt2-wince-vs8"
  97 all_platforms="${all_platforms} armv7-darwin-gcc"    #neon Cortex-A8
  98 all_platforms="${all_platforms} armv7-linux-rvct"    #neon Cortex-A8
  99 all_platforms="${all_platforms} armv7-linux-gcc"     #neon Cortex-A8
 100 all_platforms="${all_platforms} armv7-none-rvct"     #neon Cortex-A8
 101 all_platforms="${all_platforms} mips32-linux-gcc"
 102 all_platforms="${all_platforms} ppc32-darwin8-gcc"
 103 all_platforms="${all_platforms} ppc32-darwin9-gcc"
 104 all_platforms="${all_platforms} ppc32-linux-gcc"
 105 all_platforms="${all_platforms} ppc64-darwin8-gcc"
 106 all_platforms="${all_platforms} ppc64-darwin9-gcc"
 107 all_platforms="${all_platforms} ppc64-linux-gcc"
 108 all_platforms="${all_platforms} sparc-solaris-gcc"
 109 all_platforms="${all_platforms} x86-darwin8-gcc"
 110 all_platforms="${all_platforms} x86-darwin8-icc"
 111 all_platforms="${all_platforms} x86-darwin9-gcc"
 112 all_platforms="${all_platforms} x86-darwin9-icc"
 113 all_platforms="${all_platforms} x86-linux-gcc"
 114 all_platforms="${all_platforms} x86-linux-icc"
 115 all_platforms="${all_platforms} x86-solaris-gcc"
 116 all_platforms="${all_platforms} x86-win32-gcc"
 117 all_platforms="${all_platforms} x86-win32-vs7"
 118 all_platforms="${all_platforms} x86-win32-vs8"
 119 all_platforms="${all_platforms} x86-win32-vs9"
 120 all_platforms="${all_platforms} x86_64-darwin9-gcc"
 121 all_platforms="${all_platforms} x86_64-darwin10-gcc"
 122 all_platforms="${all_platforms} x86_64-linux-gcc"
 123 all_platforms="${all_platforms} x86_64-linux-icc"
 124 all_platforms="${all_platforms} x86_64-solaris-gcc"
 125 all_platforms="${all_platforms} x86_64-win64-vs8"
 126 all_platforms="${all_platforms} x86_64-win64-vs9"
 127 all_platforms="${all_platforms} universal-darwin8-gcc"
 128 all_platforms="${all_platforms} universal-darwin9-gcc"
 129 all_platforms="${all_platforms} generic-gnu"
 130
 131 # all_targets is a list of all targets that can be configured
 132 # note that these should be in dependency order for now.
 133 all_targets="libs examples docs"
 134
 135 # all targets available are enabled, by default.
 136 for t in ${all_targets}; do
 137     [ -f ${source_path}/${t}.mk ] && enable ${t}
 138 done
 139
 140 # check installed doxygen version
 141 doxy_version=$(doxygen --version 2>/dev/null)
 142 doxy_major=${doxy_version%%.*}
 143 if [ ${doxy_major:-0} -ge 1 ]; then
 144     doxy_version=${doxy_version#*.}
 145     doxy_minor=${doxy_version%%.*}
 146     doxy_patch=${doxy_version##*.}
 147
 148     [ $doxy_major -gt 1 ] && enable doxygen
 149     [ $doxy_minor -gt 5 ] && enable doxygen
 150     [ $doxy_minor -eq 5 ] && [ $doxy_patch -ge 3 ] && enable doxygen
 151 fi
 152
 153 # install everything except the sources, by default. sources will have
 154 # to be enabled when doing dist builds, since that's no longer a common
 155 # case.
 156 enabled doxygen && php -v >/dev/null 2>&1 && enable install_docs
 157 enable install_bins
 158 enable install_libs
 159
 160 enable optimizations
 161 enable fast_unaligned #allow unaligned accesses, if supported by hw
 162 enable md5
 163 enable spatial_resampling
 164 enable multithread
 165 enable os_support
 166
 167 [ -d ${source_path}/../include ] && enable alt_tree_layout
 168 for d in vp8; do
 169     [ -d ${source_path}/${d} ] && disable alt_tree_layout;
 170 done
 171
 172 if ! enabled alt_tree_layout; then
 173 # development environment
 174 [ -d ${source_path}/vp8 ] && CODECS="${CODECS} vp8_encoder vp8_decoder"
 175 else
 176 # customer environment
 177 [ -f ${source_path}/../include/vpx/vp8cx.h ] && CODECS="${CODECS} vp8_encoder"
 178 [ -f ${source_path}/../include/vpx/vp8dx.h ] && CODECS="${CODECS} vp8_decoder"
 179
 180 [ -f ${source_path}/../lib/*/*mt.lib ] && soft_enable static_msvcrt
 181 fi
 182
 183 CODECS="$(echo ${CODECS} | tr ' ' '\n')"
 184 CODEC_FAMILIES="$(for c in ${CODECS}; do echo ${c%_*}; done | sort | uniq)"
 185
 186 ARCH_LIST="
 187     arm
 188     mips
 189     x86
 190     x86_64
 191     ppc32
 192     ppc64
 193 "
 194 ARCH_EXT_LIST="
 195     armv5te
 196     armv6
 197     armv7
 198     iwmmxt
 199     iwmmxt2
 200
 201     mips32
 202
 203     mmx
 204     sse
 205     sse2
 206     sse3
 207     ssse3
 208     sse4_1
 209
 210     altivec
 211 "
 212 HAVE_LIST="
 213     ${ARCH_EXT_LIST}
 214     vpx_ports
 215     stdint_h
 216     alt_tree_layout
 217     pthread_h
 218     sys_mman_h
 219 "
 220 CONFIG_LIST="
 221     external_build
 222     install_docs
 223     install_bins
 224     install_libs
 225     install_srcs
 226     debug
 227     gprof
 228     gcov
 229     rvct
 230     gcc
 231     msvs
 232     pic
 233     big_endian
 234
 235     codec_srcs
 236     debug_libs
 237     fast_unaligned
 238     mem_manager
 239     mem_tracker
 240     mem_checks
 241     md5
 242
 243     dequant_tokens
 244     dc_recon
 245     runtime_cpu_detect
 246     postproc
 247     multithread
 248     psnr
 249     ${CODECS}
 250     ${CODEC_FAMILIES}
 251     encoders
 252     decoders
 253     static_msvcrt
 254     spatial_resampling
 255     realtime_only
 256     shared
 257     small
 258     arm_asm_detok
 259     postproc_visualizer
 260     os_support
 261 "
 262 CMDLINE_SELECT="
 263     extra_warnings
 264     werror
 265     install_docs
 266     install_bins
 267     install_libs
 268     install_srcs
 269     debug
 270     gprof
 271     gcov
 272     pic
 273     optimizations
 274     ccache
 275     runtime_cpu_detect
 276
 277     libs
 278     examples
 279     libc
 280     as
 281     fast_unaligned
 282     codec_srcs
 283     debug_libs
 284     md5
 285
 286     dequant_tokens
 287     dc_recon
 288     postproc
 289     multithread
 290     psnr
 291     ${CODECS}
 292     ${CODEC_FAMILIES}
 293     static_msvcrt
 294     mem_tracker
 295     spatial_resampling
 296     realtime_only
 297     shared
 298     small
 299     arm_asm_detok
 300     postproc_visualizer
 301 "
 302
 303 process_cmdline() {
 304     for opt do
 305         optval="${opt#*=}"
 306         case "$opt" in
 307         --disable-codecs) for c in ${CODECS}; do disable $c; done ;;
 308         *) process_common_cmdline "$opt"
 309         ;;
 310         esac
 311     done
 312 }
 313
 314 post_process_cmdline() {
 315     local c
 316
 317     # If the codec family is disabled, disable all components of that family.
 318     # If the codec family is enabled, enable all components of that family.
 319     log_echo "Configuring selected codecs"
 320     for c in ${CODECS}; do
 321         disabled ${c%%_*} && disable ${c}
 322         enabled ${c%%_*} && enable ${c}
 323     done
 324
 325     # Enable all detected codecs, if they haven't been disabled
 326     for c in ${CODECS}; do soft_enable $c; done
 327
 328     # Enable the codec family if any component of that family is enabled
 329     for c in ${CODECS}; do
 330         enabled $c && enable ${c%_*}
 331     done
 332
 333     # Set the {en,de}coders variable if any algorithm in that class is enabled
 334     for c in ${CODECS}; do
 335         enabled ${c} && enable ${c##*_}s
 336     done
 337 }
 338
 339
 340 process_targets() {
 341     enabled child || write_common_config_banner
 342     enabled universal || write_common_target_config_h  ${BUILD_PFX}vpx_config.h
 343
 344     # TODO: add host tools target (obj_int_extract, etc)
 345
 346     # For fat binaries, call configure recursively to configure for each
 347     # binary architecture to be included.
 348     if enabled universal; then
 349         # Call configure (ourselves) for each subarchitecture
 350         for arch in $fat_bin_archs; do
 351             BUILD_PFX=${arch}/ toolchain=${arch} $self --child $cmdline_args || exit $?
 352         done
 353     fi
 354
 355     # The write_common_config (config.mk) logic is deferred until after the
 356     # recursive calls to configure complete, becuase we want our universal
 357     # targets to be executed last.
 358     write_common_config_targets
 359     enabled universal && echo "FAT_ARCHS=${fat_bin_archs}" >> config.mk
 360
 361     # Calculate the default distribution name, based on the enabled features
 362     local cf
 363     local DIST_DIR=vpx
 364     for cf in $CODEC_FAMILIES; do
 365         if enabled ${cf}_encoder && enabled ${cf}_decoder; then
 366             DIST_DIR="${DIST_DIR}-${cf}"
 367         elif enabled ${cf}_encoder; then
 368             DIST_DIR="${DIST_DIR}-${cf}cx"
 369         elif enabled ${cf}_decoder; then
 370             DIST_DIR="${DIST_DIR}-${cf}dx"
 371         fi
 372     done
 373     enabled debug_libs && DIST_DIR="${DIST_DIR}-debug"
 374     enabled codec_srcs && DIST_DIR="${DIST_DIR}-src"
 375     ! enabled postproc && DIST_DIR="${DIST_DIR}-nopost"
 376     ! enabled multithread && DIST_DIR="${DIST_DIR}-nomt"
 377     ! enabled install_docs && DIST_DIR="${DIST_DIR}-nodocs"
 378     DIST_DIR="${DIST_DIR}-${tgt_isa}-${tgt_os}"
 379     case "${tgt_os}" in
 380     win*) enabled static_msvcrt && DIST_DIR="${DIST_DIR}mt" || DIST_DIR="${DIST_DIR}md"
 381           DIST_DIR="${DIST_DIR}-${tgt_cc}"
 382           ;;
 383     esac
 384     if [ -f "${source_path}/build/make/version.sh" ]; then
 385         local ver=`"$source_path/build/make/version.sh" --bare $source_path`
 386         DIST_DIR="${DIST_DIR}-${ver}"
 387         ver=${ver%%-*}
 388         VERSION_PATCH=${ver##*.}
 389         ver=${ver%.*}
 390         VERSION_MINOR=${ver##*.}
 391         ver=${ver#v}
 392         VERSION_MAJOR=${ver%.*}
 393     fi
 394     enabled child || cat <<EOF >> config.mk
 395 ifeq (\$(MAKECMDGOALS),dist)
 396 DIST_DIR?=${DIST_DIR}
 397 else
 398 DIST_DIR?=\$(DESTDIR)${prefix}
 399 endif
 400 LIBSUBDIR=${libdir##${prefix}/}
 401
 402 VERSION_MAJOR=${VERSION_MAJOR}
 403 VERSION_MINOR=${VERSION_MINOR}
 404 VERSION_PATCH=${VERSION_PATCH}
 405
 406 CONFIGURE_ARGS=${CONFIGURE_ARGS}
 407 EOF
 408     enabled child || echo "CONFIGURE_ARGS?=${CONFIGURE_ARGS}" >> config.mk
 409
 410     #
 411     # Write makefiles for all enabled targets
 412     #
 413     for tgt in libs examples docs solution; do
 414         local tgt_fn="$tgt-$toolchain.mk"
 415
 416         if enabled $tgt; then
 417             echo "Creating makefiles for ${toolchain} ${tgt}"
 418             write_common_target_config_mk $tgt_fn ${BUILD_PFX}vpx_config.h
 419             #write_${tgt}_config
 420         fi
 421     done
 422
 423 }
 424
 425 process_detect() {
 426     if enabled shared; then
 427         # Can only build shared libs on a subset of platforms. Doing this check
 428         # here rather than at option parse time because the target auto-detect
 429         # magic happens after the command line has been parsed.
 430         enabled linux || die "--enable-shared only supported on ELF for now"
 431     fi
 432     if [ -z "$CC" ]; then
 433         echo "Bypassing toolchain for environment detection."
 434         enable external_build
 435         check_header() {
 436             log fake_check_header "$@"
 437             header=$1
 438             shift
 439             var=`echo $header | sed 's/[^A-Za-z0-9_]/_/g'`
 440             disable $var
 441             case $header in
 442                 stdio.h)
 443                     true;
 444                 ;;
 445                 *)
 446                     local result=false
 447                     for d in "$@"; do
 448                         [ -f "${d##-I}/$header" ] && result=true && break
 449                     done
 450                     ${result:-true}
 451             esac && enable $var
 452         }
 453         check_ld() {
 454             true
 455         }
 456     fi
 457     check_header stdio.h || die "Unable to invoke compiler: ${CC} ${CFLAGS}"
 458     check_ld <<EOF || die "Toolchain is unable to link executables"
 459 int main(void) {return 0;}
 460 EOF
 461     # check system headers
 462     check_header stdint.h
 463     check_header pthread.h
 464     check_header sys/mman.h
 465
 466     check_header vpx/vpx_integer.h -I${source_path} && enable vpx_ports
 467 }
 468
 469 process_toolchain() {
 470     process_common_toolchain
 471
 472     # Handle universal binaries for this architecture
 473     case $toolchain in
 474         universal-darwin*)
 475             local darwin_ver=${tgt_os##darwin}
 476             fat_bin_archs="$fat_bin_archs ppc32-${tgt_os}-gcc"
 477
 478             # Intel
 479             fat_bin_archs="$fat_bin_archs x86-${tgt_os}-${tgt_cc}"
 480             if [ $darwin_ver -gt 8 ]; then
 481                 fat_bin_archs="$fat_bin_archs x86_64-${tgt_os}-${tgt_cc}"
 482             fi
 483             ;;
 484     esac
 485
 486
 487     # Enable some useful compiler flags
 488     if enabled gcc; then
 489         enabled werror && check_add_cflags -Werror
 490         check_add_cflags -Wall
 491         check_add_cflags -Wdeclaration-after-statement
 492         check_add_cflags -Wdisabled-optimization
 493         check_add_cflags -Wpointer-arith
 494         check_add_cflags -Wtype-limits
 495         check_add_cflags -Wcast-qual
 496         enabled extra_warnings || check_add_cflags -Wno-unused-function
 497     fi
 498
 499     if enabled icc; then
 500         enabled werror && check_add_cflags -Werror
 501         check_add_cflags -Wall
 502         check_add_cflags -Wpointer-arith
 503
 504         # ICC has a number of floating point optimizations that we disable
 505         # in favor of deterministic output WRT to other compilers
 506         add_cflags -fp-model precise
 507     fi
 508
 509     # Enable extra, harmless warnings. These might provide additional insight
 510     # to what the compiler is doing and why, but in general, but they shouldn't
 511     # be treated as fatal, even if we're treating warnings as errors.
 512     GCC_EXTRA_WARNINGS="
 513         -Wdisabled-optimization
 514         -Winline
 515     "
 516     enabled gcc && EXTRA_WARNINGS="${GCC_EXTRA_WARNINGS}"
 517     RVCT_EXTRA_WARNINGS="
 518         --remarks
 519     "
 520     enabled rvct && EXTRA_WARNINGS="${RVCT_EXTRA_WARNINGS}"
 521     if enabled extra_warnings; then
 522         for w in ${EXTRA_WARNINGS}; do
 523             check_add_cflags ${w}
 524             enabled gcc && enabled werror && check_add_cflags -Wno-error=${w}
 525         done
 526     fi
 527
 528     # ccache only really works on gcc toolchains
 529     enabled gcc || soft_disable ccache
 530     if enabled mips; then
 531         enable dequant_tokens
 532         enable dc_recon
 533     fi
 534
 535     # Enable the postbuild target if building for visual studio.
 536     case "$tgt_cc" in
 537         vs*) enable msvs
 538              enable solution
 539              vs_version=${tgt_cc##vs}
 540              all_targets="${all_targets} solution"
 541         ;;
 542     esac
 543
 544     # Other toolchain specific defaults
 545     case $toolchain in x86*|ppc*|universal*) soft_enable postproc;; esac
 546
 547     if enabled postproc_visualizer; then
 548         enabled postproc || die "postproc_visualizer requires postproc to be enabled"
 549     fi
 550 }
 551
 552
 553 ##
 554 ## END APPLICATION SPECIFIC CONFIGURATION
 555 ##
 556 CONFIGURE_ARGS="$@"
 557 process "$@"
 558 cat <<EOF > ${BUILD_PFX}vpx_config.c
 559 static const char* const cfg = "$CONFIGURE_ARGS";
 560 const char *vpx_codec_build_config(void) {return cfg;}
 561 EOF