diff options
| author | Brad King <brad.king@kitware.com> | 2017-10-19 13:27:22 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2017-10-19 13:27:43 (GMT) |
| commit | 358ceee5d84723f60c2db5cdff52445d478d6a42 (patch) | |
| tree | dd5348a6b863c3ad92577376b4d9969d27eb5d30 /Help/command | |
| parent | d20927533014312ae4b6ef6c1a3da5daf4e60618 (diff) | |
| parent | d45aa38a068ef38331b5dab195c42502e3829eb0 (diff) | |
| download | CMake-358ceee5d84723f60c2db5cdff52445d478d6a42.zip CMake-358ceee5d84723f60c2db5cdff52445d478d6a42.tar.gz CMake-358ceee5d84723f60c2db5cdff52445d478d6a42.tar.bz2 | |
Merge topic 'curl_netrc_options'
d45aa38a Add dev notes for topic 'curl_netrc_options'
60c272b6 ExternalProject: Add support for NETRC and NETRC_FILE suboption
754e39dd Add testcases for file(DOWNLOAD|UPLOAD) netrc options
5d67e902 file(DOWNLOAD|UPLOAD): Add 'NETRC' and 'NETRC_FILE' suboption
Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: Ruslan Baratov <ruslan_baratov@yahoo.com>
Merge-request: !1376
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/file.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst index edccac5..4d4ebb4 100644 --- a/Help/command/file.rst +++ b/Help/command/file.rst @@ -232,6 +232,31 @@ Options to both ``DOWNLOAD`` and ``UPLOAD`` are: ``HTTPHEADER <HTTP-header>`` HTTP header for operation. Suboption can be repeated several times. +``NETRC <level>`` + Specify whether the .netrc file is to be used for operation. If this + option is not specified, the value of the ``CMAKE_NETRC`` variable + will be used instead. + Valid levels are: + + ``IGNORED`` + The .netrc file is ignored. + This is the default. + ``OPTIONAL`` + The .netrc file is optional, and information in the URL is preferred. + The file will be scanned to find which ever information is not specified + in the URL. + ``REQUIRED`` + The .netrc file is required, and information in the URL is ignored. + +``NETRC_FILE <file>`` + Specify an alternative .netrc file to the one in your home directory, + if the ``NETRC`` level is ``OPTIONAL`` or ``REQUIRED``. If this option + is not specified, the value of the ``CMAKE_NETRC_FILE`` variable will + be used instead. + +If neither ``NETRC`` option is given CMake will check variables +``CMAKE_NETRC`` and ``CMAKE_NETRC_FILE``, respectively. + Additional options to ``DOWNLOAD`` are: ``EXPECTED_HASH ALGO=<value>`` |