mirror of
https://github.com/curl/curl.git
synced 2026-01-27 01:44:17 +00:00
9e6f1c5efb
Usage: - autotools: `--disable-typecheck` (or `--enable-typecheck` (default)) - cmake: `-DCURL_DISABLE_TYPECHECK=ON`. To disable `curl_easy_setopt()`/`curl_easy_getinfo()` type checking with supported (new) gcc and clang compilers. It is useful to improve build performance for the `tests/libtest` target. In particular the CodeQL analyzer may take above an hour to compile with type checking enabled, and disabling it brings it down to seconds. On local machines it may also cut build times in half when build testdeps, depending on platform and compiler. Other than these cases, we recommend leaving type checking enabled. Ref: fdacf34aaeac79ad14fa48dcafae24a6de68823d #19632 Also: - GHA/codeql: use it. - test1165: check in `include/curl`. - lib1912: delete stray todo comment. - spelling and comment nits. Closes #19637
198 lines
3.4 KiB
Markdown
198 lines
3.4 KiB
Markdown
<!--
|
|
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
|
|
SPDX-License-Identifier: curl
|
|
-->
|
|
|
|
# Code defines to disable features and protocols
|
|
|
|
## `CURL_DISABLE_ALTSVC`
|
|
|
|
Disable support for Alt-Svc: HTTP headers.
|
|
|
|
## `CURL_DISABLE_BINDLOCAL`
|
|
|
|
Disable support for binding the local end of connections.
|
|
|
|
## `CURL_DISABLE_COOKIES`
|
|
|
|
Disable support for HTTP cookies.
|
|
|
|
## `CURL_DISABLE_BASIC_AUTH`
|
|
|
|
Disable support for the Basic authentication methods.
|
|
|
|
## `CURL_DISABLE_BEARER_AUTH`
|
|
|
|
Disable support for the Bearer authentication methods.
|
|
|
|
## `CURL_DISABLE_DIGEST_AUTH`
|
|
|
|
Disable support for the Digest authentication methods.
|
|
|
|
## `CURL_DISABLE_KERBEROS_AUTH`
|
|
|
|
Disable support for the Kerberos authentication methods.
|
|
|
|
## `CURL_DISABLE_NEGOTIATE_AUTH`
|
|
|
|
Disable support for the negotiate authentication methods.
|
|
|
|
## `CURL_DISABLE_AWS`
|
|
|
|
Disable **aws-sigv4** support.
|
|
|
|
## `CURL_DISABLE_CA_SEARCH`
|
|
|
|
Disable unsafe CA bundle search in PATH on Windows.
|
|
|
|
## `CURL_DISABLE_DICT`
|
|
|
|
Disable the DICT protocol
|
|
|
|
## `CURL_DISABLE_DOH`
|
|
|
|
Disable DNS-over-HTTPS
|
|
|
|
## `CURL_DISABLE_FILE`
|
|
|
|
Disable the FILE protocol
|
|
|
|
## `CURL_DISABLE_FORM_API`
|
|
|
|
Disable the form API
|
|
|
|
## `CURL_DISABLE_FTP`
|
|
|
|
Disable the FTP (and FTPS) protocol
|
|
|
|
## `CURL_DISABLE_GETOPTIONS`
|
|
|
|
Disable the `curl_easy_options()` API calls that lets users get information
|
|
about existing options to `curl_easy_setopt()`.
|
|
|
|
## `CURL_DISABLE_GOPHER`
|
|
|
|
Disable the GOPHER protocol.
|
|
|
|
## `CURL_DISABLE_HEADERS_API`
|
|
|
|
Disable the HTTP header API.
|
|
|
|
## `CURL_DISABLE_HSTS`
|
|
|
|
Disable the HTTP Strict Transport Security support.
|
|
|
|
## `CURL_DISABLE_HTTP`
|
|
|
|
Disable the HTTP(S) protocols. Note that this then also disable HTTP proxy
|
|
support.
|
|
|
|
## `CURL_DISABLE_HTTP_AUTH`
|
|
|
|
Disable support for all HTTP authentication methods.
|
|
|
|
## `CURL_DISABLE_IMAP`
|
|
|
|
Disable the IMAP(S) protocols.
|
|
|
|
## `CURL_DISABLE_LDAP`
|
|
|
|
Disable the LDAP(S) protocols.
|
|
|
|
## `CURL_DISABLE_LDAPS`
|
|
|
|
Disable the LDAPS protocol.
|
|
|
|
## `CURL_DISABLE_LIBCURL_OPTION`
|
|
|
|
Disable the --libcurl option from the curl tool.
|
|
|
|
## `CURL_DISABLE_MIME`
|
|
|
|
Disable MIME support.
|
|
|
|
## `CURL_DISABLE_MQTT`
|
|
|
|
Disable MQTT support.
|
|
|
|
## `CURL_DISABLE_NETRC`
|
|
|
|
Disable the netrc parser.
|
|
|
|
## `CURL_DISABLE_NTLM`
|
|
|
|
Disable support for NTLM.
|
|
|
|
## `CURL_DISABLE_OPENSSL_AUTO_LOAD_CONFIG`
|
|
|
|
Disable the auto load config support in the OpenSSL backend.
|
|
|
|
## `CURL_DISABLE_PARSEDATE`
|
|
|
|
Disable date parsing
|
|
|
|
## `CURL_DISABLE_POP3`
|
|
|
|
Disable the POP3 protocol
|
|
|
|
## `CURL_DISABLE_PROGRESS_METER`
|
|
|
|
Disable the built-in progress meter
|
|
|
|
## `CURL_DISABLE_PROXY`
|
|
|
|
Disable support for proxies
|
|
|
|
## `CURL_DISABLE_IPFS`
|
|
|
|
Disable the IPFS/IPNS protocols. This affects the curl tool only, where
|
|
IPFS/IPNS protocol support is implemented.
|
|
|
|
## `CURL_DISABLE_RTSP`
|
|
|
|
Disable the RTSP protocol.
|
|
|
|
## `CURL_DISABLE_SHA512_256`
|
|
|
|
Disable the SHA-512/256 hash algorithm.
|
|
|
|
## `CURL_DISABLE_SHUFFLE_DNS`
|
|
|
|
Disable the shuffle DNS feature
|
|
|
|
## `CURL_DISABLE_SMB`
|
|
|
|
Disable the SMB(S) protocols
|
|
|
|
## `CURL_DISABLE_SMTP`
|
|
|
|
Disable the SMTP(S) protocols
|
|
|
|
## `CURL_DISABLE_SOCKETPAIR`
|
|
|
|
Disable the use of `socketpair()` internally to allow waking up and canceling
|
|
`curl_multi_poll()`.
|
|
|
|
## `CURL_DISABLE_TELNET`
|
|
|
|
Disable the TELNET protocol
|
|
|
|
## `CURL_DISABLE_TFTP`
|
|
|
|
Disable the TFTP protocol
|
|
|
|
## `CURL_DISABLE_TYPECHECK`
|
|
|
|
Disable `curl_easy_setopt()`/`curl_easy_getinfo()` type checking.
|
|
|
|
Useful to improve build performance for the `tests/libtest` test tool.
|
|
|
|
## `CURL_DISABLE_VERBOSE_STRINGS`
|
|
|
|
Disable verbose strings and error messages.
|
|
|
|
## `CURL_DISABLE_WEBSOCKETS`
|
|
|
|
Disable the WebSocket protocols.
|