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
75 lines
1.4 KiB
Markdown
75 lines
1.4 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_FTPSSLAUTH
|
|
Section: 3
|
|
Source: libcurl
|
|
Protocol:
|
|
- FTP
|
|
See-also:
|
|
- CURLOPT_FTP_SSL_CCC (3)
|
|
- CURLOPT_USE_SSL (3)
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_FTPSSLAUTH - order in which to attempt TLS vs SSL
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPSSLAUTH, long order);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Pass a long using one of the values from below, to alter how libcurl issues
|
|
"AUTH TLS" or "AUTH SSL" when FTP over SSL is activated. This is only
|
|
interesting if CURLOPT_USE_SSL(3) is also set.
|
|
|
|
Possible *order* values:
|
|
|
|
## CURLFTPAUTH_DEFAULT
|
|
|
|
Allow libcurl to decide.
|
|
|
|
## CURLFTPAUTH_SSL
|
|
|
|
Try "AUTH SSL" first, and only if that fails try "AUTH TLS".
|
|
|
|
## CURLFTPAUTH_TLS
|
|
|
|
Try "AUTH TLS" first, and only if that fails try "AUTH SSL".
|
|
|
|
# DEFAULT
|
|
|
|
CURLFTPAUTH_DEFAULT
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
CURLcode res;
|
|
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
|
|
curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_TRY);
|
|
/* funny server, ask for SSL before TLS */
|
|
curl_easy_setopt(curl, CURLOPT_FTPSSLAUTH, (long)CURLFTPAUTH_SSL);
|
|
res = curl_easy_perform(curl);
|
|
curl_easy_cleanup(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Added in 7.12.2
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
|