mirror of
https://github.com/curl/curl.git
synced 2026-06-29 11:03:12 +03:00
e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
86 lines
2.3 KiB
Markdown
86 lines
2.3 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_PROTOCOLS_STR
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLINFO_SCHEME (3)
|
|
- CURLOPT_DEFAULT_PROTOCOL (3)
|
|
- CURLOPT_REDIR_PROTOCOLS_STR (3)
|
|
- CURLOPT_URL (3)
|
|
- curl_version_info (3)
|
|
Protocol:
|
|
- All
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_PROTOCOLS_STR - allowed protocols
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROTOCOLS_STR, char *spec);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Pass a pointer to a string that holds a comma-separated list of case
|
|
insensitive protocol names (URL schemes) to allow in the transfer. This
|
|
option allows applications to use libcurl built to support a wide range of
|
|
protocols but still limit specific transfers to only be allowed to use a
|
|
subset of them. By default, libcurl accepts all protocols it was built with
|
|
support for. See also CURLOPT_REDIR_PROTOCOLS_STR(3).
|
|
|
|
If trying to set a non-existing protocol or if no matching protocol at all is
|
|
set, it returns error.
|
|
|
|
These are the available protocols:
|
|
|
|
DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS,
|
|
MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP,
|
|
SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS
|
|
|
|
You can set "ALL" as a short-cut to enable all protocols. Note that by setting
|
|
all, you may enable protocols that were not supported the day you write this
|
|
but are introduced in a future libcurl version.
|
|
|
|
curl_version_info(3) can be used to get a list of all supported
|
|
protocols in the current libcurl. CURLINFO_SCHEME(3) is the recommended
|
|
way to figure out the protocol used in a previous transfer.
|
|
|
|
# DEFAULT
|
|
|
|
All protocols built-in
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(int argc, char **argv)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
/* pass in the URL from an external source */
|
|
curl_easy_setopt(curl, CURLOPT_URL, argv[1]);
|
|
|
|
/* only allow HTTP, TFTP and SFTP */
|
|
curl_easy_setopt(curl, CURLOPT_PROTOCOLS_STR, "http,tftp,sftp");
|
|
|
|
/* Perform the request */
|
|
curl_easy_perform(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Added in 7.85.0
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns CURLE_UNKNOWN_OPTION if the option is not implemented,
|
|
CURLE_UNSUPPORTED_PROTOCOL if a listed protocol is not supported or disabled,
|
|
CURLE_BAD_FUNCTION_ARGUMENT if no protocol is listed else CURLE_OK.
|