Kitware/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-24 19:59:47 +08:00
Code Issues Projects Releases Wiki Activity

Help: Add documentation for CMAKE_TLS_CAINFO

Browse Source
This commit is contained in:
Craig Scott
2021-10-04 21:46:46 +11:00
parent b3a0bddc4e
commit 2a82bd85b6
4 changed files with 17 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
Help/command/file.rst
View File

@@ -1113,8 +1113,9 @@ If neither ``NETRC`` option is given CMake will check variables
For ``https://`` URLs CMake must be built with OpenSSL support. ``TLS/SSL`` For ``https://`` URLs CMake must be built with OpenSSL support. ``TLS/SSL``
certificates are not checked by default. Set ``TLS_VERIFY`` to ``ON`` to certificates are not checked by default. Set ``TLS_VERIFY`` to ``ON`` to
check certificates. If neither ``TLS`` option is given CMake will check check certificates. If neither ``TLS`` option is given, CMake will use the
variables :variable:`CMAKE_TLS_VERIFY` and ``CMAKE_TLS_CAINFO``, respectively. settings from the :variable:`CMAKE_TLS_VERIFY` and :variable:`CMAKE_TLS_CAINFO`
variables instead.
Additional options to ``DOWNLOAD`` are: Additional options to ``DOWNLOAD`` are:

1
Help/manual/cmake-variables.7.rst
View File

@@ -247,6 +247,7 @@ Variables that Change Behavior
/variable/CMAKE_SYSTEM_LIBRARY_PATH /variable/CMAKE_SYSTEM_LIBRARY_PATH
/variable/CMAKE_SYSTEM_PREFIX_PATH /variable/CMAKE_SYSTEM_PREFIX_PATH
/variable/CMAKE_SYSTEM_PROGRAM_PATH /variable/CMAKE_SYSTEM_PROGRAM_PATH
/variable/CMAKE_TLS_CAINFO
/variable/CMAKE_TLS_VERIFY /variable/CMAKE_TLS_VERIFY
/variable/CMAKE_USER_MAKE_RULES_OVERRIDE /variable/CMAKE_USER_MAKE_RULES_OVERRIDE
/variable/CMAKE_WARN_DEPRECATED /variable/CMAKE_WARN_DEPRECATED

9
Help/variable/CMAKE_TLS_CAINFO.rst Normal file
View File

@@ -0,0 +1,9 @@
CMAKE_TLS_CAINFO
----------------
Specify the default value for the :command:`file(DOWNLOAD)` and
:command:`file(UPLOAD)` commands' ``TLS_CAINFO`` options.
It is unset by default.
This variable is also used by the :module:`ExternalProject` module
for internal calls to :command:`file(DOWNLOAD)`.

8
Modules/ExternalProject.cmake
View File

@@ -224,14 +224,14 @@ External Project Definition
``TLS_CAINFO <file>`` ``TLS_CAINFO <file>``
Specify a custom certificate authority file to use if ``TLS_VERIFY`` Specify a custom certificate authority file to use if ``TLS_VERIFY``
is enabled. If this option is not specified, the value of the is enabled. If this option is not specified, the value of the
``CMAKE_TLS_CAINFO`` variable will be used instead (see :variable:`CMAKE_TLS_CAINFO` variable will be used instead (see
:command:`file(DOWNLOAD)`) :command:`file(DOWNLOAD)`)
``NETRC <level>`` ``NETRC <level>``
.. versionadded:: 3.11 .. versionadded:: 3.11
Specify whether the ``.netrc`` file is to be used for operation. Specify whether the ``.netrc`` file is to be used for operation.
If this option is not specified, the value of the ``CMAKE_NETRC`` If this option is not specified, the value of the :variable:`CMAKE_NETRC`
variable will be used instead (see :command:`file(DOWNLOAD)`) variable will be used instead (see :command:`file(DOWNLOAD)`)
Valid levels are: Valid levels are:
@@ -251,8 +251,8 @@ External Project Definition
Specify an alternative ``.netrc`` file to the one in your home directory Specify an alternative ``.netrc`` file to the one in your home directory
if the ``NETRC`` level is ``OPTIONAL`` or ``REQUIRED``. If this option if the ``NETRC`` level is ``OPTIONAL`` or ``REQUIRED``. If this option
is not specified, the value of the ``CMAKE_NETRC_FILE`` variable will is not specified, the value of the :variable:`CMAKE_NETRC_FILE` variable
be used instead (see :command:`file(DOWNLOAD)`) will be used instead (see :command:`file(DOWNLOAD)`)
.. versionadded:: 3.1 .. versionadded:: 3.1
Added support for `tbz2`, `.tar.xz`, `.txz`, and `.7z` extensions. Added support for `tbz2`, `.tar.xz`, `.txz`, and `.7z` extensions.