summaryrefslogtreecommitdiffstats
path: root/Help/variable
diff options
context:
space:
mode:
authorMichael Hirsch <scivision@users.noreply.gitlab.kitware.com>2021-04-29 14:45:05 (GMT)
committerBrad King <brad.king@kitware.com>2021-05-04 16:29:13 (GMT)
commit7398993f5b0444d6c7997d5bf14f96c982d07021 (patch)
tree32b671379ced5f4631f76783f1773abe9ac2c8b8 /Help/variable
parent9edff7f43e6c679a4ce4b3c97432894cf98fb56c (diff)
downloadCMake-7398993f5b0444d6c7997d5bf14f96c982d07021.zip
CMake-7398993f5b0444d6c7997d5bf14f96c982d07021.tar.gz
CMake-7398993f5b0444d6c7997d5bf14f96c982d07021.tar.bz2
Help: Document CMAKE_TLS_VERIFY variable explicitly
Previously it was mentioned only in the `file` and `ExternalProject` documentation.
Diffstat (limited to 'Help/variable')
-rw-r--r--Help/variable/CMAKE_TLS_VERIFY.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_TLS_VERIFY.rst b/Help/variable/CMAKE_TLS_VERIFY.rst
new file mode 100644
index 0000000..24f8a25
--- /dev/null
+++ b/Help/variable/CMAKE_TLS_VERIFY.rst
@@ -0,0 +1,17 @@
+CMAKE_TLS_VERIFY
+----------------
+
+Specify the default value for the :command:`file(DOWNLOAD)` and
+:command:`file(UPLOAD)` commands' ``TLS_VERIFY`` options.
+If not set, the default is *off*.
+
+This setting is also used by the :module:`ExternalProject` module
+for internal calls to :command:`file(DOWNLOAD)`.
+
+TLS verification can help provide confidence that one is connecting
+to the desired server. When downloading known content, one should
+also use file hashes to verify it.
+
+.. code-block:: cmake
+
+ set(CMAKE_TLS_VERIFY TRUE)