xref: /aosp_15_r20/external/curl/docs/CURL-DISABLE.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker<!--
2*6236dae4SAndroid Build Coastguard WorkerCopyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard Worker
4*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
5*6236dae4SAndroid Build Coastguard Worker-->
6*6236dae4SAndroid Build Coastguard Worker
7*6236dae4SAndroid Build Coastguard Worker# Code defines to disable features and protocols
8*6236dae4SAndroid Build Coastguard Worker
9*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_ALTSVC`
10*6236dae4SAndroid Build Coastguard Worker
11*6236dae4SAndroid Build Coastguard WorkerDisable support for Alt-Svc: HTTP headers.
12*6236dae4SAndroid Build Coastguard Worker
13*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_BINDLOCAL`
14*6236dae4SAndroid Build Coastguard Worker
15*6236dae4SAndroid Build Coastguard WorkerDisable support for binding the local end of connections.
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_COOKIES`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerDisable support for HTTP cookies.
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_BASIC_AUTH`
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerDisable support for the Basic authentication methods.
24*6236dae4SAndroid Build Coastguard Worker
25*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_BEARER_AUTH`
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerDisable support for the Bearer authentication methods.
28*6236dae4SAndroid Build Coastguard Worker
29*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_DIGEST_AUTH`
30*6236dae4SAndroid Build Coastguard Worker
31*6236dae4SAndroid Build Coastguard WorkerDisable support for the Digest authentication methods.
32*6236dae4SAndroid Build Coastguard Worker
33*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_KERBEROS_AUTH`
34*6236dae4SAndroid Build Coastguard Worker
35*6236dae4SAndroid Build Coastguard WorkerDisable support for the Kerberos authentication methods.
36*6236dae4SAndroid Build Coastguard Worker
37*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_NEGOTIATE_AUTH`
38*6236dae4SAndroid Build Coastguard Worker
39*6236dae4SAndroid Build Coastguard WorkerDisable support for the negotiate authentication methods.
40*6236dae4SAndroid Build Coastguard Worker
41*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_AWS`
42*6236dae4SAndroid Build Coastguard Worker
43*6236dae4SAndroid Build Coastguard WorkerDisable **aws-sigv4** support.
44*6236dae4SAndroid Build Coastguard Worker
45*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_CA_SEARCH`
46*6236dae4SAndroid Build Coastguard Worker
47*6236dae4SAndroid Build Coastguard WorkerDisable unsafe CA bundle search in PATH on Windows.
48*6236dae4SAndroid Build Coastguard Worker
49*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_DICT`
50*6236dae4SAndroid Build Coastguard Worker
51*6236dae4SAndroid Build Coastguard WorkerDisable the DICT protocol
52*6236dae4SAndroid Build Coastguard Worker
53*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_DOH`
54*6236dae4SAndroid Build Coastguard Worker
55*6236dae4SAndroid Build Coastguard WorkerDisable DNS-over-HTTPS
56*6236dae4SAndroid Build Coastguard Worker
57*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_FILE`
58*6236dae4SAndroid Build Coastguard Worker
59*6236dae4SAndroid Build Coastguard WorkerDisable the FILE protocol
60*6236dae4SAndroid Build Coastguard Worker
61*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_FORM_API`
62*6236dae4SAndroid Build Coastguard Worker
63*6236dae4SAndroid Build Coastguard WorkerDisable the form API
64*6236dae4SAndroid Build Coastguard Worker
65*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_FTP`
66*6236dae4SAndroid Build Coastguard Worker
67*6236dae4SAndroid Build Coastguard WorkerDisable the FTP (and FTPS) protocol
68*6236dae4SAndroid Build Coastguard Worker
69*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_GETOPTIONS`
70*6236dae4SAndroid Build Coastguard Worker
71*6236dae4SAndroid Build Coastguard WorkerDisable the `curl_easy_options` API calls that lets users get information
72*6236dae4SAndroid Build Coastguard Workerabout existing options to `curl_easy_setopt`.
73*6236dae4SAndroid Build Coastguard Worker
74*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_GOPHER`
75*6236dae4SAndroid Build Coastguard Worker
76*6236dae4SAndroid Build Coastguard WorkerDisable the GOPHER protocol.
77*6236dae4SAndroid Build Coastguard Worker
78*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_HEADERS_API`
79*6236dae4SAndroid Build Coastguard Worker
80*6236dae4SAndroid Build Coastguard WorkerDisable the HTTP header API.
81*6236dae4SAndroid Build Coastguard Worker
82*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_HSTS`
83*6236dae4SAndroid Build Coastguard Worker
84*6236dae4SAndroid Build Coastguard WorkerDisable the HTTP Strict Transport Security support.
85*6236dae4SAndroid Build Coastguard Worker
86*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_HTTP`
87*6236dae4SAndroid Build Coastguard Worker
88*6236dae4SAndroid Build Coastguard WorkerDisable the HTTP(S) protocols. Note that this then also disable HTTP proxy
89*6236dae4SAndroid Build Coastguard Workersupport.
90*6236dae4SAndroid Build Coastguard Worker
91*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_HTTP_AUTH`
92*6236dae4SAndroid Build Coastguard Worker
93*6236dae4SAndroid Build Coastguard WorkerDisable support for all HTTP authentication methods.
94*6236dae4SAndroid Build Coastguard Worker
95*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_IMAP`
96*6236dae4SAndroid Build Coastguard Worker
97*6236dae4SAndroid Build Coastguard WorkerDisable the IMAP(S) protocols.
98*6236dae4SAndroid Build Coastguard Worker
99*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_LDAP`
100*6236dae4SAndroid Build Coastguard Worker
101*6236dae4SAndroid Build Coastguard WorkerDisable the LDAP(S) protocols.
102*6236dae4SAndroid Build Coastguard Worker
103*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_LDAPS`
104*6236dae4SAndroid Build Coastguard Worker
105*6236dae4SAndroid Build Coastguard WorkerDisable the LDAPS protocol.
106*6236dae4SAndroid Build Coastguard Worker
107*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_LIBCURL_OPTION`
108*6236dae4SAndroid Build Coastguard Worker
109*6236dae4SAndroid Build Coastguard WorkerDisable the --libcurl option from the curl tool.
110*6236dae4SAndroid Build Coastguard Worker
111*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_MIME`
112*6236dae4SAndroid Build Coastguard Worker
113*6236dae4SAndroid Build Coastguard WorkerDisable MIME support.
114*6236dae4SAndroid Build Coastguard Worker
115*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_MQTT`
116*6236dae4SAndroid Build Coastguard Worker
117*6236dae4SAndroid Build Coastguard WorkerDisable MQTT support.
118*6236dae4SAndroid Build Coastguard Worker
119*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_NETRC`
120*6236dae4SAndroid Build Coastguard Worker
121*6236dae4SAndroid Build Coastguard WorkerDisable the netrc parser.
122*6236dae4SAndroid Build Coastguard Worker
123*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_NTLM`
124*6236dae4SAndroid Build Coastguard Worker
125*6236dae4SAndroid Build Coastguard WorkerDisable support for NTLM.
126*6236dae4SAndroid Build Coastguard Worker
127*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_OPENSSL_AUTO_LOAD_CONFIG`
128*6236dae4SAndroid Build Coastguard Worker
129*6236dae4SAndroid Build Coastguard WorkerDisable the auto load config support in the OpenSSL backend.
130*6236dae4SAndroid Build Coastguard Worker
131*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_PARSEDATE`
132*6236dae4SAndroid Build Coastguard Worker
133*6236dae4SAndroid Build Coastguard WorkerDisable date parsing
134*6236dae4SAndroid Build Coastguard Worker
135*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_POP3`
136*6236dae4SAndroid Build Coastguard Worker
137*6236dae4SAndroid Build Coastguard WorkerDisable the POP3 protocol
138*6236dae4SAndroid Build Coastguard Worker
139*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_PROGRESS_METER`
140*6236dae4SAndroid Build Coastguard Worker
141*6236dae4SAndroid Build Coastguard WorkerDisable the built-in progress meter
142*6236dae4SAndroid Build Coastguard Worker
143*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_PROXY`
144*6236dae4SAndroid Build Coastguard Worker
145*6236dae4SAndroid Build Coastguard WorkerDisable support for proxies
146*6236dae4SAndroid Build Coastguard Worker
147*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_IPFS`
148*6236dae4SAndroid Build Coastguard Worker
149*6236dae4SAndroid Build Coastguard WorkerDisable the IPFS/IPNS protocols. This affects the curl tool only, where
150*6236dae4SAndroid Build Coastguard WorkerIPFS/IPNS protocol support is implemented.
151*6236dae4SAndroid Build Coastguard Worker
152*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_RTSP`
153*6236dae4SAndroid Build Coastguard Worker
154*6236dae4SAndroid Build Coastguard WorkerDisable the RTSP protocol.
155*6236dae4SAndroid Build Coastguard Worker
156*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_SHA512_256`
157*6236dae4SAndroid Build Coastguard Worker
158*6236dae4SAndroid Build Coastguard WorkerDisable the SHA-512/256 hash algorithm.
159*6236dae4SAndroid Build Coastguard Worker
160*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_SHUFFLE_DNS`
161*6236dae4SAndroid Build Coastguard Worker
162*6236dae4SAndroid Build Coastguard WorkerDisable the shuffle DNS feature
163*6236dae4SAndroid Build Coastguard Worker
164*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_SMB`
165*6236dae4SAndroid Build Coastguard Worker
166*6236dae4SAndroid Build Coastguard WorkerDisable the SMB(S) protocols
167*6236dae4SAndroid Build Coastguard Worker
168*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_SMTP`
169*6236dae4SAndroid Build Coastguard Worker
170*6236dae4SAndroid Build Coastguard WorkerDisable the SMTP(S) protocols
171*6236dae4SAndroid Build Coastguard Worker
172*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_SOCKETPAIR`
173*6236dae4SAndroid Build Coastguard Worker
174*6236dae4SAndroid Build Coastguard WorkerDisable the use of `socketpair()` internally to allow waking up and canceling
175*6236dae4SAndroid Build Coastguard Worker`curl_multi_poll()`.
176*6236dae4SAndroid Build Coastguard Worker
177*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_TELNET`
178*6236dae4SAndroid Build Coastguard Worker
179*6236dae4SAndroid Build Coastguard WorkerDisable the TELNET protocol
180*6236dae4SAndroid Build Coastguard Worker
181*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_TFTP`
182*6236dae4SAndroid Build Coastguard Worker
183*6236dae4SAndroid Build Coastguard WorkerDisable the TFTP protocol
184*6236dae4SAndroid Build Coastguard Worker
185*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_VERBOSE_STRINGS`
186*6236dae4SAndroid Build Coastguard Worker
187*6236dae4SAndroid Build Coastguard WorkerDisable verbose strings and error messages.
188*6236dae4SAndroid Build Coastguard Worker
189*6236dae4SAndroid Build Coastguard Worker## `CURL_DISABLE_WEBSOCKETS`
190*6236dae4SAndroid Build Coastguard Worker
191*6236dae4SAndroid Build Coastguard WorkerDisable the WebSocket protocols.
192