Warning, /graphics/digikam/project/bundles/3rdparty/ext_qt6/config_help-6.6.txt is written in an unsupported language. File is not indexed.
0001 Usage: configure [options] [-- cmake-options]
0002
0003 This is a convenience script for configuring Qt with CMake.
0004 Options after the double dash are directly passed to CMake.
0005
0006 Top-level installation directories:
0007 -prefix <dir> ...... The deployment directory, as seen on the target device.
0008 [/usr/local/Qt-$QT_VERSION; qtbase build directory if
0009 -developer-build]
0010 -no-prefix ......... The deployment directory is set to the qtbase build
0011 directory. Can be used instead of -developer-build
0012 to not have to install, as well as avoid
0013 -developer-build's default of -warnings-are-errors.
0014 -extprefix <dir> ... The installation directory, as seen on the host machine.
0015 [SYSROOT/PREFIX]
0016
0017 Fine tuning of installation directory layout. Note that all directories
0018 except -sysconfdir should be located under -prefix:
0019
0020 -bindir <dir> ......... Executables [PREFIX/bin]
0021 -headerdir <dir> ...... Header files [PREFIX/include]
0022 -libdir <dir> ......... Libraries [PREFIX/lib]
0023 -archdatadir <dir> .... Arch-dependent data [PREFIX]
0024 -plugindir <dir> ...... Plugins [ARCHDATADIR/plugins]
0025 -libexecdir <dir> ..... Helper programs [ARCHDATADIR/bin on Windows,
0026 ARCHDATADIR/libexec otherwise]
0027 -qmldir <dir> ......... QML imports [ARCHDATADIR/qml]
0028 -datadir <dir> ........ Arch-independent data [PREFIX]
0029 -docdir <dir> ......... Documentation [DATADIR/doc]
0030 -translationdir <dir> . Translations [DATADIR/translations]
0031 -sysconfdir <dir> ..... Settings used by Qt programs [PREFIX/etc/xdg]
0032 -examplesdir <dir> .... Examples [PREFIX/examples]
0033 -testsdir <dir> ....... Tests [PREFIX/tests]
0034 -hostdatadir <dir> .... Data used by qmake [PREFIX]
0035
0036 Conventions for the remaining options: When an option's description is
0037 followed by a list of values in brackets, the interpretation is as follows:
0038 'yes' represents the bare option; all other values are possible prefixes to
0039 the option, e.g., -no-gui. Alternatively, the value can be assigned, e.g.,
0040 --gui=yes. Values are listed in the order they are tried if not specified;
0041 'auto' is a shorthand for 'yes/no'. Solitary 'yes' and 'no' represent binary
0042 options without auto-detection.
0043
0044 Configure meta:
0045
0046 -help, -h ............ Display this help screen
0047 -redo ................ Re-configure with previously used options. In addition,
0048 redo removes CMakeCache.txt file and CMakeFiles/ directory
0049 and recreates them from scratch.
0050 Additional options may be passed, but will not be
0051 saved for later use by -redo.
0052
0053 -feature-<feature> ... Enable <feature>
0054 -no-feature-<feature> Disable <feature> [none]
0055 -list-features ....... List available features. Note that some features
0056 have dedicated command line options as well.
0057
0058 Build options:
0059
0060 -cmake-generator <name> ... Explicitly specify the build system generator for
0061 CMake instead of auto-detecting one.
0062 -cmake-use-default-generator ... Turn off auto-detection of the CMake build
0063 system generator.
0064 -cmake-file-api ...... Let CMake store build metadata for loading the build
0065 into an IDE. [no; yes if -developer-build]
0066 -no-guess-compiler ... Do not guess the compiler from the target mkspec.
0067 -release ............. Build Qt with optimizations and without debug
0068 symbols [yes]
0069 Note that -developer-build implies -debug unless
0070 -release is also explicitly specified
0071 -debug ............... Build Qt without optimizations and with debug symbols
0072 [no]
0073 -debug-and-release ... Build two versions of Qt in one build tree [no]
0074 -optimize-debug ...... Enable debug-friendly optimizations in debug builds
0075 [auto] (Not supported with MSVC or Clang toolchains)
0076 -optimize-size ....... Optimize release builds for size instead of speed [no]
0077 -force-debug-info .... Create symbol files for release builds [no]
0078 -separate-debug-info . Split off debug information to separate files [no]
0079 -gdb-index ........... Index the debug info to speed up GDB
0080 [no; auto if -developer-build with debug info]
0081 -gc-binaries ......... Place each function or data item into its own section
0082 and enable linker garbage collection of unused
0083 sections. [auto for static builds, otherwise no]
0084 -force-asserts ....... Enable Q_ASSERT even in release builds [no]
0085 -developer-build ..... Compile and link Qt for developing Qt itself
0086 (exports for auto-tests, extra checks, implies
0087 -no-prefix, etc.) [no]
0088
0089 -shared .............. Build shared Qt libraries [yes] (no for UIKit)
0090 -static .............. Build static Qt libraries [no] (yes for UIKit)
0091 -framework ........... Build Qt framework bundles [yes] (Apple only)
0092
0093 -platform <target> ... Select mkspec for the qmake companion files
0094 -device <name> ....... Select devices/mkspec for the qmake companion files
0095 -device-option <key=value> ... Add option for the device mkspec
0096
0097 -appstore-compliant .. Disable code that is not allowed in platform app stores.
0098 This is on by default for platforms which require distribution
0099 through an app store by default, in particular Android,
0100 iOS, tvOS, and watchOS. [auto]
0101
0102 -qt-host-path <path> . Specify path to a Qt host build for cross-compiling.
0103 -qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'.
0104 -qtlibinfix <infix> .. Rename all libQt6*.so to libQt6*<infix>.so.
0105
0106 -testcocoon .......... Instrument with the TestCocoon code coverage tool [no]
0107 -gcov ................ Instrument with the GCov code coverage tool [no]
0108
0109 -trace [backend] ..... Enable instrumentation with tracepoints.
0110 Currently supported backends are 'etw' (Windows) and
0111 'lttng' (Linux), or 'yes' for auto-detection. [no]
0112
0113 -sanitize {address|thread|memory|fuzzer-no-link|undefined}
0114 Instrument with the specified compiler sanitizer.
0115 Note that some sanitizers cannot be combined;
0116 for example, -sanitize address cannot be combined with
0117 -sanitize thread.
0118
0119 -mips_dsp/-mips_dspr2 Use MIPS DSP/rev2 instructions [auto]
0120
0121 -qreal <type> ........ typedef qreal to the specified type. [double]
0122 Note: this affects binary compatibility.
0123
0124 -R <string> .......... Add an explicit runtime library path to the Qt
0125 libraries. Supports paths relative to LIBDIR.
0126 -rpath ............... Link Qt libraries and executables using the library
0127 install path as a runtime library path. Similar to
0128 -R LIBDIR. On Apple platforms, disabling this implies
0129 using absolute install names (based in LIBDIR) for
0130 dynamic libraries and frameworks. [auto]
0131
0132 -reduce-exports ...... Reduce amount of exported symbols [auto]
0133 -reduce-relocations .. Reduce amount of relocations [auto] (Unix only)
0134
0135 -plugin-manifests .... Embed manifests into plugins [no] (Windows only)
0136 -static-runtime ...... With -static, use static runtime [no] (Windows only)
0137
0138 -pch ................. Use precompiled headers [auto]
0139 -ltcg ................ Use Link Time Code Generation [no]
0140 -intelcet ............ Use Intel Control-flow Enforcement Technology [no]
0141 -linker [bfd,gold,lld,mold]
0142 Force use of the GNU ld, GNU gold, LLVM/LLD or mold
0143 linker instead of default one (GCC and clang only)
0144 -ccache .............. Use the ccache compiler cache [no] (Unix only)
0145 -unity-build ......... Enable Unity (Jumbo) build
0146 -unity-build-batch-size <int>
0147 Maximum number of source files used by the unity build
0148 to create unity source files [8]
0149
0150 -warnings-are-errors . Treat warnings as errors [no; yes if -developer-build]
0151
0152 -disable-deprecated-up-to <version>
0153 Set the QT_DISABLE_DEPRECATED_UP_TO value to <version>.
0154 QT_DISABLE_DEPRECATED_UP_TO is used to remove
0155 deprecated methods from both API and ABI.
0156 <version> is a hex value, for example 0x060500 can be
0157 used to remove all code deprecated in Qt 6.5.0 or
0158 earlier releases.
0159 By default <version> is set to 0x040000 and 0x050000 on
0160 Windows, and non-Windows respectively.
0161
0162 Build environment:
0163
0164 -pkg-config .......... Use pkg-config [auto] (Unix only)
0165
0166 -vcpkg ............... Use vcpkg [yes]
0167
0168 -D <string> .......... Pass additional preprocessor define
0169 -I <string> .......... Pass additional include path
0170 -L <string> .......... Pass additional library path
0171 -F <string> .......... Pass additional framework path (Apple only)
0172
0173 -sdk <sdk> ........... Build Qt using Apple provided SDK <sdk>. The argument
0174 should be one of the available SDKs as listed by
0175 'xcodebuild -showsdks'.
0176
0177 -android-sdk path .... Set Android SDK root path [$ANDROID_SDK_ROOT]
0178 -android-ndk path .... Set Android NDK root path [$ANDROID_NDK_ROOT]
0179 -android-ndk-platform Set Android platform
0180 -android-abis ....... Only one ABI can be specified, default is: armeabi-v7a
0181 -android-javac-target Set the javac build target version [8]
0182 -android-javac-source Set the javac build source version [8]
0183 -android-style-assets Automatically extract style assets from the device at
0184 run time. This option makes the Android style behave
0185 correctly, but also makes the Android platform plugin
0186 incompatible with the LGPL2.1. [yes]
0187
0188 Component selection:
0189
0190 -submodules <repo>[,<repo>] ... Build the listed repositories and those they
0191 depend on rather than all checked-out repositories.
0192 The list should be separated with commas, e.g.
0193 -submodules qtsvg,qtnetworkauth
0194 [default is to build all checked out repositories]
0195 -skip <repo>[,<repo>] Exclude one or more entire repositories from the
0196 build. The list should be separated with commas.
0197 e.g. -skip qtimageformats,qtsvg
0198 -make <part> ......... Add <part> to the list of parts to be built.
0199 Specifying this option clears the default list first.
0200 (allowed values: libs, tools, examples, tests,
0201 benchmarks, manual-tests, minimal-static-tests)
0202 [default: libs and examples, also tools if not
0203 cross-building, also tests if -developer-build]
0204 -nomake <part> ....... Exclude <part> from the list of parts to be built.
0205 -install-examples-sources Installs examples source code into the Qt prefix
0206 Only possible when -make examples is also passed
0207 [no]
0208 -gui ................. Build the Qt GUI module and dependencies [yes]
0209 -widgets ............. Build the Qt Widgets module and dependencies [yes]
0210 -no-dbus ............. Do not build the Qt D-Bus module
0211 [default on Android and Windows]
0212 -dbus-linked ......... Build Qt D-Bus and link to libdbus-1 [auto]
0213 -dbus-runtime ........ Build Qt D-Bus and dynamically load libdbus-1 [no]
0214 -accessibility ....... Enable accessibility support [yes]
0215 Note: Disabling accessibility is not recommended.
0216
0217 Qt comes with bundled copies of some 3rd party libraries. These are used
0218 by default if auto-detection of the respective system library fails.
0219
0220 Core options:
0221
0222 -doubleconversion .... Select used double conversion library [system/qt/no]
0223 No implies use of sscanf_l and snprintf_l (imprecise).
0224 -glib ................ Enable Glib support [no; auto on Unix]
0225 -eventfd ............. Enable eventfd support
0226 -inotify ............. Enable inotify support
0227 -icu ................. Enable ICU support [auto]
0228 -pcre ................ Select used libpcre2 [system/qt/no]
0229 -zlib ................ Select used zlib [system/qt]
0230
0231 Logging backends:
0232 -journald .......... Enable journald support [no] (Unix only)
0233 -syslog ............ Enable syslog support [no] (Unix only)
0234 -slog2 ............. Enable slog2 support [auto] (QNX only)
0235
0236 Network options:
0237
0238 -ssl ................. Enable either SSL support method [auto]
0239 -no-openssl .......... Do not use OpenSSL [default on Apple]
0240 -openssl-linked ...... Use OpenSSL and link to libssl [no]
0241 -openssl-runtime ..... Use OpenSSL and dynamically load libssl [auto]
0242 -schannel ............ Use Secure Channel [auto] (Windows only)
0243 -securetransport ..... Use SecureTransport [auto] (Apple only)
0244
0245 -sctp ................ Enable SCTP support [no]
0246
0247 -libproxy ............ Enable use of libproxy [no]
0248 -system-proxies ...... Use system network proxies by default [yes]
0249
0250 Gui, printing, widget options:
0251
0252 -cups ................ Enable CUPS support [auto] (Unix only)
0253
0254 -fontconfig .......... Enable Fontconfig support [auto] (Unix only)
0255 -freetype ............ Select used FreeType [system/qt/no]
0256 -harfbuzz ............ Select used HarfBuzz-NG [system/qt/no]
0257 (Not auto-detected on Apple and Windows)
0258
0259 -gtk ................. Enable GTK platform theme support [auto]
0260
0261 -no-opengl ........... Disable OpenGL support
0262 -opengl <api> ........ Enable OpenGL support. Supported APIs:
0263 es2, desktop (default on Unix),
0264 dynamic (Windows only, default on Windows)
0265 -opengles3 ........... Enable OpenGL ES 3.x support instead of ES 2.x [auto]
0266 -egl ................. Enable EGL support [auto]
0267
0268 -qpa <name> .......... Select default QPA backend(s) (e.g., xcb, cocoa, windows)
0269 A prioritized list separated by semi-colons.
0270 -xcb-xlib............. Enable Xcb-Xlib support [auto]
0271
0272 Platform backends:
0273 -direct2d .......... Enable Direct2D support [auto] (Windows only)
0274 -directfb .......... Enable DirectFB support [no] (Unix only)
0275 -eglfs ............. Enable EGLFS support [auto; no on Android and Windows]
0276 -gbm ............... Enable backends for GBM [auto] (Linux only)
0277 -kms ............... Enable backends for KMS [auto] (Linux only)
0278 -linuxfb ........... Enable Linux Framebuffer support [auto] (Linux only)
0279 -xcb ............... Enable X11 support [auto] (Linux only)
0280
0281 Input backends:
0282 -libudev............ Enable udev support [auto]
0283 -evdev ............. Enable evdev support [auto]
0284 -libinput .......... Enable libinput support [auto]
0285 -mtdev ............. Enable mtdev support [auto]
0286 -tslib ............. Enable tslib support [auto]
0287 -bundled-xcb-xinput Use bundled XInput2 support [auto]
0288 -xkbcommon ......... Enable key mapping support [auto]
0289
0290 Image formats:
0291 -gif ............... Enable reading support for GIF [auto]
0292 -ico ............... Enable support for ICO [yes]
0293 -libpng ............ Select used libpng [system/qt/no]
0294 -libjpeg ........... Select used libjpeg [system/qt/no]
0295
0296 Database options:
0297
0298 -sql-<driver> ........ Enable SQL <driver> plugin. Supported drivers:
0299 db2 ibase mysql oci odbc psql sqlite mimer
0300 [all auto]
0301 -sqlite .............. Select used sqlite [system/qt]