Lines Matching +full:cxx +full:- +full:test +full:- +full:suite
5 .. _configure-options:
12 ./configure --help
17 ---------------
19 .. cmdoption:: --enable-loadable-sqlite-extensions
29 .. cmdoption:: --disable-ipv6
34 .. cmdoption:: --enable-big-digits=[15|30]
39 30 bits if ``void*`` size is 64-bit or larger, 15 bits otherwise.
45 .. cmdoption:: --with-cxx-main
46 .. cmdoption:: --with-cxx-main=COMPILER
49 compiler: ``$CXX``, or *COMPILER* if specified.
51 .. cmdoption:: --with-suffix=SUFFIX
58 .. cmdoption:: --with-tzpath=<list of absolute paths separated by pathsep>
61 See the :ref:`Compile-time configuration
70 .. cmdoption:: --without-decimal-contextvar
72 Build the ``_decimal`` extension module using a thread-local context rather
73 than a coroutine-local context (default), see the :mod:`decimal` module.
79 .. cmdoption:: --with-dbmliborder=db1:db2:...
89 .. cmdoption:: --without-c-locale-coercion
91 Disable C locale coercion to a UTF-8 based locale (enabled by default).
97 .. cmdoption:: --with-platlibdir=DIRNAME
101 Fedora and SuSE use ``lib64`` on 64-bit platforms.
107 .. cmdoption:: --with-wheel-pkg-dir=PATH
114 ``/usr/share/python-wheels/`` directory and don't install the
121 ---------------
123 .. cmdoption:: --disable-test-modules
125 Don't build nor install test modules, like the :mod:`test` package or the
130 .. cmdoption:: --with-ensurepip=[upgrade|install|no]
134 * ``upgrade`` (default): run ``python -m ensurepip --altinstall --upgrade``
136 * ``install``: run ``python -m ensurepip --altinstall`` command;
143 -------------------
145 Configuring Python using ``--enable-optimizations --with-lto`` (PGO + LTO) is
148 .. cmdoption:: --enable-optimizations
153 The C compiler Clang requires ``llvm-profdata`` program for PGO. On
156 Disable also semantic interposition in libpython if ``--enable-shared`` and
157 GCC is used: add ``-fno-semantic-interposition`` to the compiler and linker
163 Use ``-fno-semantic-interposition`` on GCC.
170 Default: ``-m test --pgo --timeout=$(TESTTIMEOUT)``.
174 .. cmdoption:: --with-lto
178 The C compiler Clang requires ``llvm-ar`` for LTO (``ar`` on macOS), as well
179 as an LTO-aware linker (``ld.gold`` or ``lld``).
183 .. cmdoption:: --with-computed-gotos
188 .. cmdoption:: --without-pymalloc
195 .. cmdoption:: --without-doc-strings
204 .. cmdoption:: --enable-profiling
206 Enable C-level code profiling with ``gprof`` (disabled by default).
209 .. _debug-build:
212 ------------------
214 A debug build is Python built with the :option:`--with-pydebug` configure
223 * Add :option:`-X showrefcount <-X>` command line option.
225 * Add support for the ``__ltrace__`` variable: enable low-level tracing in the
227 * Install :ref:`debug hooks on memory allocators <default-memory-allocators>`
232 the ``NDEBUG`` macro (see also the :option:`--with-assertions` configure
246 :option:`--with-trace-refs` configure option.
251 :option:`--with-trace-refs` option), which introduces the only ABI
256 -------------
258 .. cmdoption:: --with-pydebug
260 :ref:`Build Python in debug mode <debug-build>`: define the ``Py_DEBUG``
263 .. cmdoption:: --with-trace-refs
278 .. cmdoption:: --with-assertions
286 See also the :option:`--with-pydebug` option (:ref:`debug build
287 <debug-build>`) which also enables assertions.
291 .. cmdoption:: --with-valgrind
295 .. cmdoption:: --with-dtrace
304 .. cmdoption:: --with-address-sanitizer
310 .. cmdoption:: --with-memory-sanitizer
316 .. cmdoption:: --with-undefined-behavior-sanitizer
325 --------------
327 .. cmdoption:: --enable-shared
331 .. cmdoption:: --without-static-libpython
340 -----------------
342 .. cmdoption:: --with-libs='lib1 ...'
346 .. cmdoption:: --with-system-expat
351 .. cmdoption:: --with-system-ffi
354 library, see the :mod:`ctypes` module (default is system-dependent).
356 .. cmdoption:: --with-system-libmpdec
363 .. cmdoption:: --with-readline=editline
371 .. cmdoption:: --without-readline
379 .. cmdoption:: --with-tcltk-includes='-I...'
383 .. cmdoption:: --with-tcltk-libs='-L...'
387 .. cmdoption:: --with-libm=STRING
389 Override ``libm`` math library to *STRING* (default is system-dependent).
391 .. cmdoption:: --with-libc=STRING
393 Override ``libc`` C library to *STRING* (default is system-dependent).
395 .. cmdoption:: --with-openssl=DIR
401 .. cmdoption:: --with-openssl-rpath=[no|auto|DIR]
406 * ``auto``: auto-detect rpath from :option:`--with-openssl` and
407 ``pkg-config``;
414 ----------------
416 .. cmdoption:: --with-hash-algorithm=[fnv|siphash24]
425 .. cmdoption:: --with-builtin-hashlib-hashes=md5,sha1,sha256,sha512,sha3,blake2
427 Built-in hash modules:
438 .. cmdoption:: --with-ssl-default-suites=[python|openssl|STRING]
456 -------------
460 .. cmdoption:: --enable-universalsdk
461 .. cmdoption:: --enable-universalsdk=SDKDIR
466 .. cmdoption:: --enable-framework
467 .. cmdoption:: --enable-framework=INSTALLDIR
472 .. cmdoption:: --with-universal-archs=ARCH
475 only valid when :option:`--enable-universalsdk` is set.
480 * ``32-bit``;
481 * ``64-bit``;
482 * ``3-way``;
484 * ``intel-32``;
485 * ``intel-64``;
488 .. cmdoption:: --with-framework-name=FRAMEWORK
491 :option:`--enable-framework` is set (default: ``Python``).
498 ------------------------------
508 ----------------
518 ---------------------
523 * ``make profile-opt``: build Python using Profile Guided Optimization (PGO).
524 You can use the configure :option:`--enable-optimizations` option to make
527 * ``make buildbottest``: Build Python and run the Python test suite, the same
528 way than buildbots test Python. Set ``TESTTIMEOUT`` variable (in seconds)
529 to change the test timeout (1200 by default: 20 minutes).
531 * ``make regen-all``: Regenerate (almost) all generated files;
532 ``make regen-stdlib-module-names`` and ``autoconf`` must be run separately
539 ------------
541 Some C extensions are built as built-in modules, like the ``sys`` module.
543 Built-in modules have no ``__file__`` attribute::
547 <module 'sys' (built-in)>
555 Example on Linux x86-64::
559 …<module '_asyncio' from '/usr/lib64/python3.9/lib-dynload/_asyncio.cpython-39-x86_64-linux-gnu.so'>
561 '/usr/lib64/python3.9/lib-dynload/_asyncio.cpython-39-x86_64-linux-gnu.so'
564 At the beginning of the files, C extensions are built as built-in modules.
589 ------------------
599 (Objective) C/C++ preprocessor flags, e.g. ``-I<include dir>`` if you have
614 Default: ``$(BASECPPFLAGS) -I. -I$(srcdir)/Include $(CONFIGURE_CPPFLAGS) $(CPPFLAGS)``.
619 --------------
625 Example: ``gcc -pthread``.
632 Variable set by the :option:`--with-cxx-main` option of the configure
637 .. envvar:: CXX
641 Used if the :option:`--with-cxx-main` option is used.
643 Example: ``g++ -pthread``.
685 Strict or non-strict aliasing flags used to compile ``Python/dtoa.c``.
693 For example, ``-fPIC`` is used on Linux and on BSD.
699 Default: ``$(CCSHARED)`` when :option:`--enable-shared` is used, or an empty
708 Default: ``$(CONFIGURE_CFLAGS_NODIST) $(CFLAGS_NODIST) -I$(srcdir)/Include/internal``.
722 Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE``.
728 Compiler flags to build a standard library extension module as a built-in
731 Default: ``$(PY_STDMODULE_CFLAGS) -DPy_BUILD_CORE_BUILTIN``.
743 ------------
757 pre-set values.
776 Linker flags, e.g. ``-L<lib dir>`` if you have libraries in a nonstandard
788 Example: ``-lrt``.