Qtopia Home · Home · Reference · User Guide · Internals

configure Options (Qt)

These options can be passed by using -extra-qt-config. For other switches that Qtopia supports see configure Options. Note that quoting can get a bit tricky with -extra-qt-config so be careful. The -extra-qt-config switch can be passed multiple times which can simplify quoting issues in many cases.

For example, the following two are equivalent.

    configure -extra-qt-config "-arg -arg word -arg 'words and stuff'"
    configure -extra-qt-config -arg\
              -extra-qt-config -arg=word\
              -extra-qt-config "-arg 'words and stuff'"

qtopiacore/qt/configure -help

    This is the Qt/X11 Qtopia Edition.

    Usage:  configure [-prefix <dir>] [-prefix-install] [-bindir <dir>] [-libdir <dir>]
            [-docdir <dir>] [-headerdir <dir>] [-plugindir <dir> ] [-datadir <dir>]
            [-translationdir <dir>] [-sysconfdir <dir>] [-examplesdir <dir>]
            [-demosdir <dir>] [-buildkey <key>] [-release] [-debug]
            [-debug-and-release] [-shared] [-static] [-no-fast] [-fast] [-no-largefile]
            [-largefile] [-no-exceptions] [-exceptions] [-no-accessibility]
            [-accessibility] [-no-stl] [-stl] [-no-sql-<driver>] [-sql-<driver>]
            [-plugin-sql-<driver>] [-system-sqlite] [-no-qt3support] [-qt3support]
            [-platform] [-D <string>] [-I <string>] [-L <string>] [-help] [-no-zlib]
            [-qt-zlib] [-system-zlib] [-no-gif] [-qt-gif] [-no-libtiff] [-system-libtiff]
            [-no-libpng] [-qt-libpng] [-system-libpng] [-no-libmng] [-qt-libmng]
            [-system-libmng] [-no-libjpeg] [-qt-libjpeg] [-system-libjpeg] [-make <part>]
            [-no-make <part>] [-R <string>]  [-l <string>] [-no-rpath]  [-rpath] [-continue]
            [-verbose] [-v] [-silent] [-no-nis] [-nis] [-no-cups] [-cups] [-no-iconv]
            [-iconv] [-no-pch] [-pch] [-no-qdbus] [-qdbus] [-no-separate-debug-info]
            [-no-mmx] [-no-3dnow] [-no-sse] [-no-sse2]
            [-separate-debug-info] [-armfpa] [-no-optimized-qmake] [-optimized-qmake]

            [additional platform specific options (see below)]

    Installation options:

     These are optional, but you may specify install directories.

        -prefix <dir> ...... This will install everything relative to <dir>
                             (default /usr/local/Trolltech/Qt-4.3.5)

      * -prefix-install .... Force a sandboxed "local" installation of
                             Qt. This will install into
                             /usr/local/Trolltech/Qt-4.3.5, if this option is
                             disabled then some platforms will attempt a
                             "system" install by placing default values to
                             be placed in a system location other than
                             PREFIX.

     You may use these to separate different parts of the install:

        -bindir <dir> ......... Executables will be installed to <dir>
                                (default PREFIX/bin)
        -libdir <dir> ......... Libraries will be installed to <dir>
                                (default PREFIX/lib)
        -docdir <dir> ......... Documentation will be installed to <dir>
                                (default PREFIX/doc)
        -headerdir <dir> ...... Headers will be installed to <dir>
                                (default PREFIX/include)
        -plugindir <dir> ...... Plugins will be installed to <dir>
                                (default PREFIX/plugins)
        -datadir <dir> ........ Data used by Qt programs will be installed to <dir>
                                (default PREFIX)
        -translationdir <dir>.. Translations of Qt programs will be installed to <dir>
                                (default PREFIX/translations)
        -sysconfdir <dir> ..... Settings used by Qt programs will be looked for in <dir>
                                (default PREFIX/etc/settings)
        -examplesdir <dir> .... Examples will be installed to <dir>
                                (default PREFIX/examples)
        -demosdir <dir> ....... Demos will be installed to <dir>
                                (default PREFIX/demos)

     You may use these options to turn on strict plugin loading.

        -buildkey <key> .... Build the Qt library and plugins using the specified
                             <key>.  When the library loads plugins, it will only
                             load those that have a matching key.

    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:

     *  -release ........... Compile and link Qt with debugging turned off.
        -debug ............. Compile and link Qt with debugging turned on.
        -debug-and-release . Compile and link two versions of Qt, with and without
                             debugging turned on. [Mac only]

     *  -shared ............ Create and use shared Qt libraries.
        -static ............ Create and use static Qt libraries.

     *  -no-fast ........... Configure Qt normally by generating Makefiles for all
                             project files.
        -fast .............. Configure Qt quickly by generating Makefiles only for
                             library and subdirectory targets.  All other Makefiles
                             are created as wrappers, which will in turn run qmake.

        -no-largefile....... Disables large file support.
     +  -largefile.......... Enables Qt to access files larger than 4 GB.

        -no-exceptions ..... Disable exceptions on compilers that support it.
     *  -exceptions ........ Enable exceptions on compilers that support it.

        -no-accessibility .. Do not compile Accessibility support.
     *  -accessibility ..... Compile Accessibility support.

        -no-stl ............ Do not compile STL support.
     *  -stl ............... Compile STL support.

        -no-sql-<driver> ... Disable SQL <driver> entirely.
        -qt-sql-<driver> ... Enable a SQL <driver> in the QtSql library, by default
                             none are turned on.
        -plugin-sql-<driver> Enable SQL <driver> as a plugin to be linked to
                             at run time.

                             Possible values for <driver>:
                             [  db2 ibase mysql oci odbc psql sqlite sqlite2 tds ]

        -system-sqlite ..... Use sqlite from the operating system.

        -no-qt3support ..... Disables the Qt 3 support functionality.
     *  -qt3support ........ Enables the Qt 3 support functionality.

        -platform target ... The operating system and compiler you are building
                             on (linux-g++).

                             See the README file for a list of supported
                             operating systems and compilers.

        -no-mmx ............ Do not compile with use of MMX instructions.
        -no-3dnow .......... Do not compile with use of 3DNOW instructions.
        -no-sse ............ Do not compile with use of SSE instructions.
        -no-sse2 ........... Do not compile with use of SSE2 instructions.

        -D <string> ........ Add an explicit define to the preprocessor.
        -I <string> ........ Add an explicit include path.
        -L <string> ........ Add an explicit library path.

        -help, -h .......... Display this information.

    Third Party Libraries:

        -no-zlib ........... Do not compile in ZLIB support. Implies -no-libpng.
        -qt-zlib ........... Use the zlib bundled with Qt.
     +  -system-zlib ....... Use zlib from the operating system.
                             See http://www.gzip.org/zlib

        -no-gif ............ Do not compile the plugin for GIF reading support.
     *  -qt-gif ............ Compile the plugin for GIF reading support.
                             See also src/plugins/imageformats/gif/qgifhandler.h

        -no-libtiff ........ Do not compile the plugin for TIFF support.
        -qt-libtiff ........ Use the libtiff bundled with Qt.
     +  -system-libtiff .... Use libtiff from the operating system.
                             See http://www.libtiff.org

        -no-libpng ......... Do not compile in PNG support.
        -qt-libpng ......... Use the libpng bundled with Qt.
     +  -system-libpng ..... Use libpng from the operating system.
                             See http://www.libpng.org/pub/png

        -no-libmng ......... Do not compile the plugin for MNG support.
        -qt-libmng ......... Use the libmng bundled with Qt.
     +  -system-libmng ..... Use libmng from the operating system.
                             See http://www.libmng.com

        -no-libjpeg ........ Do not compile the plugin for JPEG support.
        -qt-libjpeg ........ Use the libjpeg bundled with Qt.
     +  -system-libjpeg .... Use libjpeg from the operating system.
                             See http://www.ijg.org

        -no-openssl ........ Do not compile support for OpenSSL.
     +  -openssl ........... Use OpenSSL from the operating system.

    Additional options:

        -make <part> ....... Add part to the list of parts to be built at make time.
                             (libs tools examples demos)
        -nomake <part> ..... Exclude part from the list of parts to be built.

        -R <string> ........ Add an explicit runtime library path to the Qt
                             libraries.
        -l <string> ........ Add an explicit library.

        -no-rpath .......... Do not use the library install path as a runtime
                             library path.
     +  -rpath ............. Link Qt libraries and executables using the library
                             install path as a runtime library path. Equivalent
                             to -R install_libpath

        -continue........... Continue as far as possible if an error occurs.

        -verbose, -v ....... Print verbose information about each step of the
                             configure process.

        -silent ............ Reduce the build output so that warnings and errors
                             can be seen more easily.

     *  -no-optimized-qmake ... Do not build qmake optimized.
        -optimized-qmake ...... Build qmake optimized.

        -no-nis ............ Do not compile NIS support.
     *  -nis ............... Compile NIS support.

        -no-cups............ Do not compile CUPS support.
     *  -cups .............. Compile CUPS support.

        -no-iconv........... Do not compile support for iconv(3).
     *  -iconv.............. Compile support for iconv(3).

        -no-pch ............ Do not use precompiled header support.
     *  -pch ............... Use precompiled header support.

        -no-qdbus........... Do not compile the QtDBus module.
     +  -qdbus.............. Compile the QtDBus module.

        -reduce-relocations ... Reduce relocations in the libraries through extra linker
                                optimizations (Qt/X11 / Qtopia/Core only;
                                experimental; needs GNU ld >= 2.18)

    Qt/X11 only:

     *  -no-nas-sound ...... Do not compile in NAS sound support.
        -system-nas-sound .. Use NAS libaudio from the operating system.
                             See http://radscan.com/nas.html

        -no-opengl.......... Do not support OpenGL.
     +  -opengl............. Enable OpenGL support.

        -no-sm ............. Do not support X Session Management.
     *  -sm ................ Support X Session Management, links in -lSM -lICE.

        -no-xshape ......... Do not compile XShape support.
     *  -xshape ............ Compile XShape support.
                             Requires X11/extensions/shape.h.

        -no-xinerama ....... Do not compile Xinerama (multihead) support.
     *  -xinerama .......... Compile Xinerama support.
                             Requires X11/extensions/Xinerama.h and libXinerama.

        -no-xcursor ........ Do not compile Xcursor support.
     *  -xcursor ........... Compile Xcursor support.
                             Requires X11/Xcursor/Xcursor.h and libXcursor.

        -no-xfixes ......... Do not compile Xfixes support.
     *  -xfixes ............ Compile Xfixes support.
                             Requires X11/extensions/Xfixes.h and libXfixes.

        -no-xrandr ......... Do not compile Xrandr (resize and rotate) support.
     *  -xrandr ............ Compile Xrandr support.
                             Requires X11/extensions/Xrandr.h and libXrandr.

        -no-xrender ........ Do not compile Xrender support.
     *  -xrender ........... Compile Xrender support.
                             Requires X11/extensions/Xrender.h and libXrender

        -no-fontconfig ..... Do not compile FontConfig (anti-aliased font) support.
     *  -fontconfig ........ Compile FontConfig support.
                             Requires fontconfig/fontconfig.h, libfontconfig,
                             freetype.h and libfreetype.

        -no-tablet ......... Do not compile Tablet support.
     *  -tablet ............ Compile Tablet support.
                             Requires IRIX with wacom.h and libXi or
                             XFree86 with X11/extensions/XInput.h and libXi.

        -no-xkb ............ Do not compile XKB (X KeyBoard extension) support.
     *  -xkb ............... Compile XKB support.

        -no-separate-debug-info Do not store debug information in a separate file
     *  -separate-debug-info    Strip debug information into a separate .debug file

        -no-glib............ Do not compile Glib support.
     +  -glib............... Compile Glib support.

See also Overviews.


Copyright © 2008 Nokia Qtopia Build System Documentation