Qtopia Home · Home · Reference · User Guide · Internals

configure Options

The authorative source of the available configure options (and defaults) is the script itself. Here is the output of configure -help as it was when the documentation was built.

Note that some configure options will change the default value of other options. You can run configure -some -options -help to see the effect of this.

For suitable values to pass to -extra-qt-config see configure Options (Qt).

For suitable values to pass to -extra-qtopiacore-config see configure Options (Qtopia Core).

configure -help

    Usage:  configure [options]

    The defaults (*) are usually acceptable. A plus (+) denotes a default
    value that needs to be evaluated. If the evaluation succeeds, the
    feature is included. Here is a short explanation of each option:

        -help ..................  Print help and usage information.
        -verbose ...............  Print out extra information while configuring.

        -silent ................  Hide compiler commandlines.
      * -no-silent .............  Show compiler commandlines.

      * -release ...............  Create a release build.
        -debug .................  Create a debug build.

        -separate-debug-info ...  Separate debug info into a .debug file.
      * -no-separate-debug-info   Do not separate debug info into a .debug file.

      * -clean .................  Clean the build tree.
        -no-clean ..............  Do not clean the build tree.

        -profile ...............  Create a build with profiling.
      * -no-profile ............  Create a build without profiling.

        -reduce-exports arg ....  Reduce symbol exports in Qt/Qtopia Core/Qtopia
                                  (requires GCC 4).
                                  Available: auto, yes, no
                                  Default: auto

        -little-endian .........  Force target build to use little endian (LSB
                                  first).
        -big-endian ............  Force target build to use big endian (MSB first).

        -I dir .................  Add an explicit include path.
        -L dir .................  Add Add an explicit library path.
        -l lib .................  Add Add an explicit library.
        -R dir .................  Add an explicit dynamic library runtime search
                                  path.
        -D def .................  Add an explicit define to the build. Use -D
                                  FOO=bar to give it a value.

            The -I, -L, -l, -R and -D flags apply when building Qtopia and Qtopia
            Core. If you need to pass these flags to Qt you should use
            -extra-qt-config 'flags'.

      + -rpath .................  Set an automatic RPATH (so LD_LIBRARY_PATH is not
                                  required to run Qtopia). Note that this requires
                                  QMAKE_RPATH to be set in your selected mkspec.
        -no-rpath ..............  Do not set an automatic RPATH.

      * -posix-locks ...........  Use POSIX file locking.
        -flock-locks ...........  Use flock() for file locking.

      + -strict-warnings .......  Use strict compiler warning flags.
        -no-strict-warnings ....  Do not use strict compiler warning flags.

        -error .................  Treat warnings as errors when compiling Qtopia
                                  (except for code in src/3rdparty).
      * -no-error ..............  Do not treat warnings as errors.

        -device device .........  Build using a device profile.
                                  Available: c3200, example, ficgta01, gcc411,
                                  greenphone, i686fb, min_voip, n800, nokia770,
                                  omap730, zaurusclamshell, zylonite_eabi

            Using -device may cause many defaults to change.

        -edition edn ...........  Build Qtopia <edn> Edition.
                                  Available: platform, phone
                                  Default: phone
        -qtopiasyncagent .......  Build Qtopia Sync Agent.

        -platform host .........  The host platform that you are compiling on. If
                                  not specified, configure will attempt to
                                  autodetect the host.
        -xplatform target ......  The target platform that you are compiling for. If
                                  not specified, configure will attempt to
                                  autodetect the target based on the host.
      + -arch architecture .....  The CPU family you are building for.
                                  Available: alpha, arm, boundschecker, generic,
                                  i386, ia64, macosx, mips, parisc, powerpc, s390,
                                  sparc, windows, x86_64
        -defaultbuttons arg ....  Use <arg> (if you pass a complete path) or
                                  $QTOPIA_DEPOT_PATH/etc/defaultbuttons-<arg>.conf
                                  (if you do not pass a complete path).
        -sdk dir ...............  Set the SDK location to <dir>. Note that you
                                  cannot run 'make sdk' with -sdk
                                  /home/test1/tmp/qtopia/qtopia-phone-4.3.3.
                                  Default: /home/test1/tmp/qtopia/qtopia-phone-4.3.3
        -image dir .............  Set the Qtopia install location to <dir>.
                                  Default: /home/test1/tmp/qtopia/qtopia-phone-4.3.3
                                  /image
        -prefix dir ............  Set the runtime location of Qtopia to <dir>.
                                  Default: /home/test1/tmp/qtopia/qtopia-phone-4.3.3
                                  /image
        -dimage dir ............  Set the Qtopia Sync Agent install location to
                                  <dir>.
                                  Default: /home/test1/tmp/qtopia/qtopia-phone-4.3.3
                                  /dimage
        -dprefix dir ...........  Set the runtime location of Qtopia Sync Agent to
                                  <dir>.

      * -qvfb ..................  Enable QVfb support.
        -no-qvfb ...............  Disable QVfb support.

        -launch-method method ..  Launch applications using the selected method.
                                  Please see the documentation for a description of
                                  each launch method.
                                  Available: normal, quicklaunch
                                  Default: quicklaunch
      + -setproc-method method .  Select the method used by quicklauncher to change
                                  the process title.
                                  Available: prctl, argv0, none
                                  Default: argv0

            The prctl method uses the prctl() system call. This is available to
            Linux 2.6.9 and later.

            The argv0 method overwrites argv[0]. This is the traditional approach
            used by Qtopia. It makes assumptions about the layout in memory or argv
            and char **environ.

            The none method is provided for systems that cannot use prctl() and
            break on the argv0 method.

        -force-quicklaunch .....  Force apps using QTOPIA_MAIN to be quicklaunched.
                                  This results in larger binaries but faster
                                  launching.
      * -no-force-quicklaunch ..  Do not force apps using QTOPIA_MAIN to be
                                  quicklaunched.

        -singleexec ............  Qtopia is compiled into a single binary that
                                  contains all the libraries, plug-ins and
                                  applications. This implies -no-sxe.
      * -shared ................  Qtopia is compiled as a collection of libraries,
                                  plug-ins and applications.

        -languages lang,lang ...  Resources (translations, dictionary files, icons)
                                  are updated/installed for the specified languages.
                                  Available: en_US
                                  Default: en_US
        -iconsize size .........  Non-scalable icons are installed at the requested
                                  size. Can be a single number (for square icons) or
                                  WxH. Images will be scaled from one of the
                                  available sizes.
                                  Available: 14, 16, 22
                                  Default: 22
        -svg-format ext ........  Specify the format to convert SVG files to at
                                  install time. Converting to the pic (QPicture)
                                  format allows for faster image loading.
                                  Available: svg, pic
                                  Default: pic
        -image-extension-order    An image may exist with multiple extensions but
         ext,ext                  only 1 of these will be installed. This list
                                  determines the priority of extensions. An image
                                  with multiple extensions, none of which appear in
                                  this list will have the first (as determined by
                                  perl's glob("$file.*");) extension chosen.
                                  Available: png, gif, xpm
                                  Default: png,gif,xpm

            You cannot force extensions other than .svg to have the highest
            priority with -image-extension-order.

        -displaysize WxH[-WxH] .  Resources (images) suitable for the requested size
                                  are installed. Size can be a single width and
                                  height or a minimum and maximum width and height.
                                  Default: 160-240

      * -auto-i18n-fonts .......  Allow automatic installation of i18n fonts based
                                  on the configured language.
        -no-auto-i18n-fonts ....  Do not automatically install i18n fonts.

        -font fontspec .........  Install font <fontspec> (defined as
                                  "family:sizes:styles" OR a truetype font file (eg.
                                  qtopiadejavu.ttf). Pass -font multiple times to
                                  install multiple fonts.
                                  Default: "dejavu_sans_condensed:*:*"

            family is the name of the font.

            sizes is a list or range. For example, '80,100,120', '80-120', '*'.
            Note that .qpf2 files are named with pixel height so 8-12 is more
            likely.

            styles is a list of weights. For example: '50,50i,80', '*'.

            Unless you have changed the Qtopia Core configuration, fonts must be
            truetype, .qpf or .qpf2 files.format and are searched for in
            /home/test1/tmp/qtopia/qtopia-phone-4.3.3/qtopiacore/qt/dist/embedded/l
            ib/fonts and /home/test1/tmp/qtopia/qtopia-phone-4.3.3/dist/fonts. One
            .qpf/.qpf2 file is installed for each combination of family, size,
            style and rotation. Note that fonts may not be available in all styles
            and sizes.

        -make makecmd ..........  Use <makecmd> when building.
                                  Default: make
        -build dir .............  Add directory <dir> to the Qtopia build system.
                                  For example, -build /path/to/myapp will add
                                  /path/to/myapp to the build system.

      + -ssl ...................  Enable the use of OpenSSL. This lets qtmail
                                  connect over SSL and use SMTP authentication. It
                                  also allows communication with Google services.
        -no-ssl ................  Disable the use of OpenSSL.

        -ssl-ciphers              Use additional ciphers when building OpenSSL.
         cipher,cipher            WARNING: These ciphers are patented and should
                                  only be enabled if a suitable licensing agreement
                                  is in place.
                                  Available: dsa, idea, mdc2, rc5

      * -sxe ...................  Enable the Safe Execution Environment so that
                                  native third party applications can run safely.
        -no-sxe ................  Disable the Safe Execution Environment.

        -sxe-discovery .........  Turn on support for SXE discovery mode so that new
                                  policy rules can be tested. To utilise SXE
                                  discovery mode you must set the SXE_DISCOVERY_MODE
                                  environment variable to 1. WARNING: This option
                                  creates a security hole and should only be used
                                  when creating new policy rules.
      * -no-sxe-discovery ......  Turn off support for SXE discovery mode.

        -sxe-soft-kill .........  Turn on support for SXE soft kill so that
                                  processes can be sent a signal other than 9 when
                                  being killed. To utilise SXE soft kill you must
                                  set the SXE_SOFT_KILL environment variable to the
                                  number of the signal to send. To see the available
                                  signals run kill -l. WARNING: This option creates
                                  a security hole and should only be used when
                                  debugging SXE violations.
      * -no-sxe-soft-kill ......  Turn off support for SXE soft kill.

      + -bluetooth .............  Enable Bluetooth.
        -no-bluetooth ..........  Disable Bluetooth.

      * -infrared ..............  Enable Infrared.
        -no-infrared ...........  Disable Infrared.

      + -dbus ..................  Enable DBUS support.
        -no-dbus ...............  Disable DBUS support.

      + -drm ...................  Enable support for DRM (Using the Beep Science DRM
                                  Agent v2.4).
        -no-drm ................  Disable support for DRM.

      + -sound-system ss .......  Select the sound system to use. You might need to
                                  force OSS if your toolchain has ALSA but your
                                  kernel does not.
                                  Available: alsa, oss
                                  Default: alsa

      + -v4l2 ..................  Enable support for V4L2 (Video for Linux version
                                  2).
        -no-v4l2 ...............  Disable support for V4L2. Video for Linux version
                                  1 will be used instead. You might need to force
                                  this if your toolchain has V4L2 but your kernel
                                  does not.

      * -telephony .............  Enable Telephony components (UI, Modem, VoIP).
        -no-telephony ..........  Disable Telephony components.

      * -modem .................  Enable Modem communication (requires Telephony).
        -no-modem ..............  Disable Modem communication.

        -phonevendors             Build and install phonevendor plugins (reqires
         plugin,plugin            Modem).
                                  Available: ericsson, wavecom
        -multiplexers             Build and install multiplexer plugins (reqires
         plugin,plugin            Modem).
                                  Available: wavecom

        -voip ..................  Enable VoIP (Voice over IP) communication. Note
                                  that the reference SIP agent will not build in
                                  singleexec mode. (requires Telephony)
      * -no-voip ...............  Disable VoIP communication.

            Modem and VoIP communication are not exclusive or mandatory. You can
            enable one, both or none. You must enable telephony to enable Modem or
            VoIP.

        -vpn ...................  Enable VPN (Virtual Private Network) support.
      * -no-vpn ................  Disable VPN.

        -qtopiamedia ...........  Enable the Qtopia Media API.
      * -no-qtopiamedia ........  Disable the Qtopia Media API.

      + -mediaengines             Select the audio/video engines to use with the
         engine,engine            Qtopia Media API.The order of the engines is
                                  significant
                                  Available: cruxus, gstreamer
                                  Default: cruxus

      * -libamr ................  Enable libamr.
        -no-libamr .............  Disable libamr.

        -test ..................  Enable the test framework which provides automated
                                  GUI testing functionality. WARNING: This option
                                  creates a security hole and should only be used
                                  when automated testing is going to be used.
      * -no-test ...............  Disable the test framework.

      * -enable-samples ........  Enable server widget samples.
        -no-samples ............  Disable server widget samples.

        -build-examples ........  Build the example code.
      * -no-examples ...........  Do not build the example code.

      * -gif ...................  Enable GIF support.
        -no-gif ................  Disable GIF support.

        -glib ..................  Enable Glib support in Qtopia Core (uses glib-2.0
                                  from pkg-config).
      * -no-glib ...............  Disable Glib support in Qtopia Core.

      * -qtopia-sqlite .........  Use sqlite3 from Qtopia.
        -system-sqlite .........  Use sqlite3 from the system.

        -extra-qtopiacore-config  Add something to the Qtopia Core configure
         "-option arg"            commandline.
        -extra-qt-config "-option Add something to the Qt configure commandline.
         arg"

See also Overviews.


Copyright © 2008 Nokia Qtopia Build System Documentation