summaryrefslogtreecommitdiffstats
path: root/Help/envvar
Commit message (Collapse)AuthorAgeFilesLines
* Drop Visual Studio 9 2008 generatorBrad King2024-05-081-1/+1
| | | | This generator has been deprecated since CMake 3.27. Remove it.
* Help: Document ObjC/ObjC++ flag variablesAlexander Borsuk2024-04-182-0/+28
| | | | Signed-off-by: Alexander Borsuk <me@alex.bio>
* ExternalProject: Honor CMAKE_TLS_VERIFY environment variableBrad King2024-03-301-0/+4
| | | | Issue: #23608
* file(DOWNLOAD|UPLOAD): Add CMAKE_TLS_VERIFY environment variableBrad King2024-03-301-0/+11
| | | | Issue: #23608
* Merge topic 'ctest-j-default'Brad King2024-03-111-0/+11
|\ | | | | | | | | | | | | | | | | | | | | | | | | 5de1e21659 ctest: Allow passing -j without value to choose a contextual default bbcbcff7d9 cmCTestMultiProcessHandler: Modernize member initialization 7457b474a1 Tests: Remove unnecessary parallel suppression from CTestCoverageCollectGCOV ae69801d96 Tests: Convert CTestTestSkipReturnCode to RunCMake.ctest_test case 30dda49416 Tests: Convert CTestTestSerialOrder to RunCMake.ctest_test case Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: buildbot <buildbot@kitware.com> Acked-by: scivision <michael@scivision.dev> Merge-request: !9315
| * ctest: Allow passing -j without value to choose a contextual defaultBrad King2024-03-101-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | Under job server integration, added by commit 80fe56c481 (ctest: Add support for running under a make job server on POSIX systems, 2023-11-15, v3.29.0-rc1~324^2), use a very high default so that parallelism is effectively limited only by available job server tokens. Otherwise, choose a default limit based on the number of processors. Also allow passing `0` to specify unbounded parallelism. Fixes: #25739
* | ExternalProject: Add TLS version options for https connectionsBrad King2024-02-291-0/+4
| | | | | | | | | | | | | | Add a `TLS_VERSION` option and honor `CMAKE_TLS_VERSION` variables. Also map the version to Git options as we already do for `TLS_VERIFY`. Issue: #25701
* | file(DOWNLOAD|UPLOAD): Add CMAKE_TLS_VERSION environment variableBrad King2024-02-281-0/+12
|/ | | | Issue: #25701
* cmake: Allow CMAKE_INSTALL_PREFIX to be set by environment variableSilvio Traversaro2024-01-301-0/+11
| | | | Fixes: #25023
* Help: Document {CTEST,CMAKE_BUILD}_PARALLEL_LEVEL equivalent command-linescivision2024-01-182-2/+10
| | | | | Clarify that the `--parallel` option isn't needed when these env. variables are set to a finite integer.
* add_test: Optionally use a launcher for tests running in-project targetsRalf Habacker2023-12-131-0/+11
| | | | | | | Add a `CMAKE_TEST_LAUNCHER` variable and corresponding `TEST_LAUNCHER` target property. Issue: #23672
* HIP: Add CMAKE_HIP_HOST_COMPILER when compiler is NVCCBrad King2023-09-251-0/+19
| | | | Also add `HIPHOSTCXX` environment variable.
* CUDA: Generalize CMAKE_{CUDA => <LANG>}_HOST_COMPILER variable docsBrad King2023-09-251-2/+4
|
* CrossCompiling: Load CMAKE_CROSSCOMPILING_EMULATOR from environmentMatt McCormick2023-06-131-0/+11
| | | | | | | | | | | Read `CMAKE_CROSSCOMPILING_EMULATOR` from an environment variable of the same name if not specified with `-D` or an initial cache value. Along with existing environment variable settings such as `CMAKE_TOOLCHAIN_FILE`, cross compilation configuration can be more completely set via environment variables. Suggested-by: Henry Schreiner <henryschreineriii@gmail.com>
* Optionally exclude implicit link directories via environmentBrad King2023-05-251-0/+13
| | | | | | | | A misconfigured compiler may pass extraneous implicit link directories to its linker. If they are in `CMAKE_<LANG>_IMPLICIT_LINK_DIRECTORIES`, CMake may generate extra `-L` flags on mixed-language link lines that break linking. Add an environment variable that users can set to work around such misconfiguration of their compilers.
* Help: add documentation for some CMAKE_XXX_PATH env.varsAlex Neundorf2023-05-015-0/+68
| | | | | | | This patch adds basic documentation for the CMAKE_INCLUDE_PATH, CMAKE_LIBRARY_PATH, CMAKE_PROGRAM_PATH, CMAKE_APPBUNDLE_PATH and CMAKE_FRAMEWORK_PATH environment variables and links to the respective cmake variables and vice versa.
* Add CMAKE_MAXIMUM_RECURSION_DEPTH environment variableBrad King2023-03-131-0/+10
| | | | | | | Extend the recursion limit controls added by commit a6982cff0d (cmMakefile: Impose maximum recursion limit, 2018-12-14, v3.14.0-rc1~82^2) with an environment variable that is used if the CMake variable of the same name is not set.
* find_package: Use <PACKAGENAME>_ROOT variables as search prefixesBrad King2023-02-231-0/+14
| | | | | | | | | Extend commit eb35d8884b (find_package: Use PackageName_ROOT variables as search prefixes, 2018-03-15, v3.12.0-rc1~349^2) to also check upper-case `<PACKAGENAME>_ROOT` variables. Add policy `CMP0144` to enable the behavior in a compatible way. Fixes: #24403
* Help: Clarify that <PackageName>_ROOT variable names are case-preservedBrad King2023-02-081-4/+4
| | | | | The name comes from the case-preserved first argument to `find_package`.
* ctest(1): Add CTEST_NO_TESTS_ACTION env varfriendlyanon2023-01-131-0/+14
| | | | | This environment variable provides a default value for the --no-tests=<action> command line argument.
* ASM_MARMASM: Add support for Microsoft ARM assembler languageIlia K2022-11-092-2/+9
| | | | | | https://learn.microsoft.com/en-us/cpp/assembler/arm/arm-assembler-reference Fixes: #23999
* Help: Clarify how language-specific flag environment values are usedBrad King2022-10-1810-56/+57
| | | | | | | | | Previous the wording could be interpreted to mean that the environment variables like `CXXFLAGS` are used exclusively to initialize the corresponding cache entries like `CMAKE_CXX_FLAGS`. State clearly that the value will be used in combination with builtin defaults. Issue: #23956
* Help: Disambiguate cmake(1) program modes in Sphinx option referencesBrad King2022-10-051-1/+1
| | | | | | Define the entry point to each mode as an option for the `cmake` program, but reference the options for that mode as part of stand-in `cmake-<mode>` programs.
* cmCurl: Honor OpenSSL certificate environment variablesMaxim Cournoyer2022-09-162-0/+18
| | | | | | | Honor the OpenSSL environment variables used to specify the location of the TLS certificates, as specified in the `curl(1)` man page. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* Help: Replace a bunch of more ``--option`` to `:option:` roleAlex Turbov2022-08-042-4/+5
|
* Help: Replace mentions of ``-T`` and ``-A`` options with roleAlex Turbov2022-08-042-2/+2
|
* Help: Replace mentions of ``-G`` option with :option:`-G` roleAlex Turbov2022-08-041-3/+3
|
* Help: Update Sphinx versionadded directives for 3.24 releaseBrad King2022-06-081-0/+2
| | | | | | Run the script: Utilities/Sphinx/update_versions.py --since v3.23.0 --overwrite
* ADSP: Add dedicated platform moduleChris Wright2022-04-041-0/+8
|
* color: Add CMAKE_COLOR_DIAGNOSTICS environment variableSemyon Kolton2022-03-081-0/+9
|
* Help: Clarify roles of DESTDIR and CMAKE_INSTALL_PREFIXBrad King2022-02-041-10/+19
|
* Help: Correct CUDAHOSTCXX and CUDAARCHS as having higher precedenceRaul Tambre2022-01-152-5/+3
| | | | | | | | | | | | | | | | | | | | | For CUDAHOSTCXX the behaviour seems to have been like this since the introduction of it in commit 9cf5b98d ("CUDA: Prefer environment variables CUDACXX and CUDAHOSTCXX.", 2016-11-08) and is likely unintentional judging by the wording of the commit. The documentation mistake seems to be a copy-paste error from when all the environment variables were documented in commit e6b77c5f ("Help: Document CMake's environment variables", 2017-09-01). Describe this explicitly as it is unlike all other similar environment variables. For CUDAARCHS we got it wrong from the get-go in commit c4ae9384 ("CUDA: Initialize CMAKE_CUDA_ARCHITECTURES using $ENV{CUDAARCHS}", 2020-11-24). Correcting either to follow the more standard precedence behaviour will require a policy. Fixes #23081.
* Help: Clarify CMAKE_INSTALL_MODE documentationFelix Lelchuk2021-11-231-10/+70
| | | | Fixes: #22869 Co-Authored-By: Craig Scott <craig.scott@crascit.com>
* Help: Use definition list for allowed values of CMAKE_INSTALL_MODECraig Scott2021-11-231-8/+27
| | | | Clean up the wording as well for improved consistency and clarity.
* Alternative symlink-creating mode for file(INSTALL ...)Felix Lelchuk2021-08-021-0/+37
| | | | | | | | | | | An new environment variable 'CMAKE_INSTALL_MODE' is introduced, which can be used to ask CMake to create symbolic links instead of copying files during a file(INSTALL ...). The operation is at the file level only, directory trees are still created using actual directories, not links. Signed-off-by: Felix Lelchuk <felix.lelchuk@gmx.de>
* cmake: Allow CMAKE_CONFIGURATION_TYPES to be set by environment variableBrad King2021-06-301-0/+11
| | | | | | | | When no `CMAKE_CONFIGURATION_TYPES` is explicitly specified while creating a new build tree, check for an environment variable of the same name. Issue: #20983
* cmake: Allow CMAKE_BUILD_TYPE to be set by environment variableBrad King2021-06-301-0/+10
| | | | | | | When no `CMAKE_BUILD_TYPE` is explicitly specified while creating a new build tree, check for an environment variable of the same name. Issue: #20983
* HIP: Add language to CMakeRobert Maynard2021-06-072-0/+28
|
* cmake: Allow CMAKE_TOOLCHAIN_FILE to be set by environment variableBrad King2021-06-031-0/+12
| | | | | When no `CMAKE_TOOLCHAIN_FILE` is explicitly specified while creating a new build tree, check for an environment variable of the same name.
* Launchers: Support setting linker launchersBobby D Reynolds2021-05-281-0/+13
| | | | Fixes: #18316
* CUDA: Add CMAKE_CUDA_HOST_COMPILER support on Windows non-VS generatorsunknown2021-04-221-0/+4
|
* Merge topic 'apple-silicon-host-arch'Brad King2020-12-111-0/+13
|\ | | | | | | | | | | | | | | b7f0327dcd Tests: Cover macOS host architecture selection on Apple Silicon hosts 5f882f6ce5 macOS: Offer control over host architecture on Apple Silicon hosts Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5589
| * macOS: Offer control over host architecture on Apple Silicon hostsBrad King2020-12-101-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since commit b6c60f14b6 (macOS: Default to arm64 architecture on Apple Silicon hosts, 2020-09-28, v3.19.0-rc1~63^2) we use `sysctl` to detect that we are running on Apple Silicon in a way that pierces Rosetta. This always sets `CMAKE_HOST_SYSTEM_PROCESSOR` to be `arm64` on such hosts. However, macOS offers strong support for running processes under an emulated `x86_64` architecture. Teach CMake to select either `arm64` or `x86_64` as the host architecture on Apple Silicon based on the architecture of its own process. When CMake is built as a universal binary, macOS will select whichever slice (architecture) is appropriate under the user's shell, and `CMAKE_HOST_SYSTEM_PROCESSOR` will match. Also offer a `CMAKE_APPLE_SILICON_PROCESSOR` variable and environment variable to provide users with explicit control over the host architecture selection regardless of CMake's own architecture. Finally, if `CMAKE_OSX_ARCHITECTURES` is not set, pass explicit flags to the toolchain to use selected host architecture instead of letting the toolchain pick. Fixes: #21554
* | Help: Add `.. versionadded` directives to module docsNikita Nemkin2020-12-021-2/+5
| | | | | | | | Issue: #19715
* | CUDA: Initialize CMAKE_CUDA_ARCHITECTURES using $ENV{CUDAARCHS}Raul Tambre2020-11-301-0/+13
|/ | | | | | | NVCC's default architecture may be newer than the one supported by the machine's GPU. In such cases it's useful to have an environment variable for initializing CMAKE_CUDA_ARCHITECTURES to avoid specifying it for every invocation.
* Help: Fix `.. versionadded` directives in environment variable docsNikita Nemkin2020-11-1127-49/+5
| | | | | | | | Many environment variables were documented late and got assigned wrong versions by the script. (The whole Help/envvar section was only added in 3.10). Issue: #19715
* ISPC: Update help documentation to include ISPCRobert Maynard2020-08-282-0/+28
|
* Toolchain: Update documentation for initial compiler flagsFred Baksik2020-08-038-1/+57
|
* Help: Add Sphinx 'versionadded' directives to each top-level documentKitware Robot2020-07-0641-0/+82
| | | | | | | Run the `Utilities/Sphinx/update_versions.py` script to add initial markup to every top-level document and find module. Issue: #19715
* Help: Clarify how env vars and ..._INIT variables interactCraig Scott2020-05-247-0/+14
| | | Fixes: #20358
generated by cgit v0.12 at 2025-03-29 13:41:46 (GMT)