Qt Extended Home · Build System Home · Reference · User Guide · Internals codeless banner

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 (Qt Embedded).

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.

            Note that this applies to building of Qt only. QBuild always hides
            commandlines but shows then whenever the process creates output or
            returns non-zero.

      * -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/Qt Embedded/Qt
                                  Extended (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 Qt Extended and Qt
            Embedded projects. You need to use -host-I, -host-L, -host-l, -host-R
            and -host-D flags if you want the effects for Qt and host projects.

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

      + -rpath .................  Set an automatic RPATH (so LD_LIBRARY_PATH is not
                                  required to run Qt Extended). 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.

      + -semtimedop ............  Use semtimedop.
        -no-semtimedop .........  Use semop instead.

      + -malloc-hook ...........  Use glibc's __malloc_hook for memory allocation
                                  debugging.
        -no-malloc-hook ........  Disable features which depend on __malloc_hook.

        -exceptions ............  Enable Exceptions.
      * -no-exceptions .........  Disable Exceptions.

        -rtti ..................  Enable RTTI (implies -exceptions).
      * -no-rtti ...............  Disable RTTI.

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

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

      * -ld-optimize-speed .....  Optimize the link algorithm for speed.
        -ld-optimize-memory ....  Optimize the link algorithm for memory use. This
                                  is handy on memory-constrained systems.

      + -pkg-config ............  Use pkg-config to resolve dependencies when
                                  cross-compiling. This requires that
                                  PKG_CONFIG_PATH and PKG_CONFIG_PREFIX are set and
                                  only allows packages to be used that allow $prefix
                                  to be overridden.
        -no-pkg-config .........  Do not use pkg-config when cross-compiling. Any
                                  required compiler flags to satisfy dependencies
                                  must be provided manually.

        -force-pkg-config ......  Force the use of pkg-config. This may be reqired
                                  for devices that cannot set PKG_CONFIG_PATH and
                                  PKG_CONFIG_PREFIX. You must manually ensure that
                                  pkg-config will return correct results.

            Builds for QVFb (including builds using the reference device) will
            always use pkg-config if it is available as they are not
            cross-compiling.

        -device device .........  Build for a device.
                                  Available: greenphone, n810, neo, reference
                                  Default: reference

            The reference device can only run under QVFb. You must create a device
            profile or use an existing profile if you wish to run your build on a
            device.

        -qvfb ..................  Build a device configuration for running under
                                  QVFb.

            The reference Building for any device except reference (the default
            device) will create a build that does not run under QVFb. By passing
            -device foo -qvfb you can build using the configuration from a device
            in a build for QVFb. Note that this requires support from the device.

        -allow-fail option .....  Allow an option to fail. Note that this uses
                                  option names, which do not match switch names. See
                                  devices/reference/configure-qvfb for the options
                                  that are useful to use with this switch.

            Note that passing an option overrides any previously-declared
            -allow-fail for that option.

        -ui-type ui ............  Build Qt Extended with the specified UI.
                                  Available: mobile, home

        -add-module module
        -remove-module module
        -modules module,module .  Select the modules to build.
                                  Available: bluetooth, cell, connectivity,
                                  devtools, drm, essentials, games, infrared,
                                  inputmethods, ipcomms, location, media, messaging,
                                  pim, pkgmanagement, qtuitest, telephony, ui

            Note that some features previously enabled with configure switches are
            now controlled by modules. The following list describes these features.

                location  : Enable the Qt Extended Whereabouts API.
                bluetooth : Enable Bluetooth.
                infrared  : Enable Infrared.
                drm       : Enable support for DRM (Using the Beep Science DRM
            Agent v2.4).
                telephony : Enable Telephony components (UI, Modem, VoIP).
                cell      : Enable Modem communication.
                ipcomms   : Enable VoIP (Voice over IP) communication. Note that
            the reference SIP agent will not build in singleexec mode.
                media     : Enable the Qt Extended Media API.
                qtuitest  : 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.

        -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, avr32, bfin, generic, i386,
                                  ia64, macosx, mips, parisc, powerpc, s390, sparc,
                                  windows, x86_64
        -sdk dir ...............  Set the SDK location to <dir>.
                                  Default: /home/test1/tmp/mksrcpackage_30514/qt-ext
                                  ended-4.4.3/qbuild/doc/user_guide/src/gen/configur
                                  e/sdk
        -image dir .............  Set the Qt Extended install location to <dir>.
                                  Default: /home/test1/tmp/mksrcpackage_30514/qt-ext
                                  ended-4.4.3/qbuild/doc/user_guide/src/gen/configur
                                  e/image
        -prefix dir ............  Set the runtime location of Qt Extended to <dir>.
                                  Default: /home/test1/tmp/mksrcpackage_30514/qt-ext
                                  ended-4.4.3/qbuild/doc/user_guide/src/gen/configur
                                  e/image

        -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 Qt Extended. 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.

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

        -add-language lang
        -remove-language lang
        -languages lang,lang ...  Select the languages to use. 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.
                                  Default: 22x22
        -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    Select the priority of extensions for images that
         ext,ext                  exist in multiple formats.
                                  Available: png, gif, xpm
                                  Default: png,gif,xpm

            Only one version of an image 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. Note that you cannot force
            extensions other than .svg to have the highest priority with this
            option.

        -add-displaysize ui:size
        -displaysizes             Set the display sizes to match against the current
         ui:size,ui:size          UI.

            This flag only affects some images (mostly theme backgrounds) that are
            scaled to the size of the display.

            The value home:800x480,480x800 means that the home UI has a display
            size of 800x480 and any other UI has  a display size of 480x800.

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

        -add-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 Qt Embedded configuration, fonts must be
            truetype, .qpf or .qpf2 files.format and are searched for in
            /home/test1/tmp/mksrcpackage_30514/qt-extended-4.4.3/qtopiacore/qt/lib/
            fonts and
            /home/test1/tmp/mksrcpackage_30514/qt-extended-4.4.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.

        -mount dir:mountpoint ..  Mount <dir> at <mountpoint> on the solution
                                  filesystem.

            There are 3 ways to specify <dir>. It can be absolute, the directory is
            used. The path can begin with DEVICE/, in which case the path is
            relative to the device directory (eg. DEVICE/include =>
            <source>/devices/reference/include). A relative path is relative to the
            source directory. (eg. devices/foo/src => <source>/devices/foo/src).
            Any mounted directories will have the lowest priority when searching
            for files.

        -dynamic-rotation ......  Enable support for dynamic rotation in Qt
                                  Extended.
        -no-dynamic-rotation ...  Do not enable support for dynamic rotation.

        -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.

        -sxe ...................  Enable the Safe Execution Environment.
        -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.

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

        -dbusipc ...............  Enable DBUS for IPC.
        -no-dbusipc ............  Disable DBUS for IPC.

      + -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.

        -add-phonevendor plugin
        -remove-phonevendor
         plugin
        -phonevendors             Build and install phonevendor plugins (reqires
         plugin,plugin            Modem).
                                  Available: ericsson, wavecom
                                  Default: ericsson,wavecom

        -add-multiplexer plugin
        -remove-multiplexer
         plugin
        -multiplexers             Build and install multiplexer plugins (reqires
         plugin,plugin            Modem).
                                  Available: wavecom
                                  Default: wavecom

            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.

        -add-mediaengine engine
        -remove-mediaengine
         engine
        -mediaengines             Select the audio/video engines to use with the Qt
         engine,engine            Extended Media API.The order of the engines is
                                  significant
                                  Available: cruxus, gstreamer, helix

        -phonon ................  Enable Phonon support in Qt Extended.
        -no-phonon .............  Disable Phonon support.

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

        -build-examples ........  Build the example projects (for verification only,
                                  does not install them).
      * -no-examples ...........  Do not build the example projects.

        -pictureflow ...........  Enable the PictureFlow 3rdparty addin.
        -no-pictureflow ........  Disable the PictureFlow 3rdparty addin.

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

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

      * -qtopia-sqlite .........  Use sqlite3 from Qt Extended.
        -system-sqlite .........  Use sqlite3 from the system.

        -script ................  Enable QtScript support in Qt Embedded.
      * -no-script .............  Disabled QtScript support in Qt Embedded.

        -extra-qt-embedded-config Add something to the Qt Embedded configure
         "-option arg"            commandline.
        -extra-qt-config "-option Add something to the Qt configure commandline.
         arg"

      + -system-qt .............  Use Qt from the system.
        -build-qt ..............  Build Qt.

        -force-build-qt ........  Force a build of Qt (for bootstrap purposes),
                                  ignoring any pre-existing version.

See also Overviews.


Copyright © 2009 Nokia
Qt Extended - Build System Documentation