CMake Modules¶
cmmm¶
Download and configure CMakeMM
cmmm([NO_CHANGELOG] [NO_COLOR] [SHOW_PROGRESS] [VERSION <version>] [DESTINATION <path>] [INACTIVITY_TIMEOUT <seconds>] [TIMEOUT <seconds>] [TLS_VERIFY <ON|OFF>] [TLS_CAINFO <file>] [RETRIES <number/INFINITY>])
Options¶
The options are:
NO_CHANGELOGOptional Disable changelog printing.
NO_COLOROptional Disable the color on terminal.
SHOW_PROGRESSOptional Print progress information as status messages until the operation is complete.
VERSION <version>Optional Version of CMakeMM to download (use one of the versions in https://github.com/cmake-tools/cmmm/releases or 'latest' for the last version. Only for testing !).
DESTINATION <path>Optional Path destination to install CMakeMM.
INACTIVITY_TIMEOUT <seconds>Optional Terminate the operation after a period of inactivity.
TIMEOUT <seconds>Optional Terminate the operation after a given total time has elapsed.
TLS_VERIFY <ON|OFF>Optional Specify whether to verify the server certificate for
https://URLs. The default is to not verify. If this option is not specified, the value of the CMAKE_TLS_VERIFY variable will be used instead.TLS_CAINFO <file>Optional Specify a custom Certificate Authority file for
https://URLs. If this option is not specified, the value of the CMAKE_TLS_CAINFO variable will be used instead.RETRIES <number/INFINITY>Optional Specify the number of retries if download fails.
cmmm_modules_list¶
Download a module list.
cmmm_modules_list(URL <url>)
cmmm_modules_list(FILEPATH <path>)
Options¶
The options are:
URL <url>the URL in the form provider:foo/bar#tag
FILEPATH <path>the file to download
NO_COLOROptional Disable the color on terminal.
SHOW_PROGRESSOptional Print progress information as status messages until the operation is complete.
TLS_VERIFY <ON|OFF>Optional Specify whether to verify the server certificate for
https://URLs. The default is to not verify. If this option is not specified, the value of the CMAKE_TLS_VERIFY variable will be used instead.TLS_CAINFO <file>Optional Specify a custom Certificate Authority file for
https://URLs. If this option is not specified, the value of the CMAKE_TLS_CAINFO variable will be used instead.RETRIES <number/INFINITY>Optional Specify the number of retries if download fails.
INACTIVITY_TIMEOUT <seconds>Optional Terminate the operation after a period of inactivity.
TIMEOUT <seconds>Optional Terminate the operation after a given total time has elapsed.
DESTINATION <path>Optional Path destination to install CMakeMM.
USERPWD <username>:<password>Optional Set username and password for operation.
NETRC <level>Optional 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:
IGNOREDThe .netrc file is ignored. This is the default.
OPTIONALThe .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.
REQUIREDThe .netrc file is required, and information in the URL is ignored.
NETRC_FILE <file>Optional Specify an alternative .netrc file to the one in your home directory, if the
NETRClevel is OPTIONAL or REQUIRED. If this option is not specified, the value of the CMAKE_NETRC_FILE variable will be used instead.EXPECTED_HASH <algorithm>=<value>Optional Verify that the downloaded content hash matches the expected value, where <algorithm> is one of the algorithms supported by <HASH>. If the file already exists and matches the hash, the download is skipped. If the file already exists and does not match the hash, the file is downloaded again. If after download the file does not match the hash, the operation fails with an error. It is an error to specify this option if DOWNLOAD is not given a <file>.
HTTPHEADER <HTTP-header>Optional HTTP header for DOWNLOAD operation. HTTPHEADER can be repeated for multiple options.
ALWAYS_DOWNLOAD <bool>Optional Always redownload the list file.