diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2021-02-08 16:51:20 +0100 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2021-02-08 22:35:50 +0100 |
| commit | ff9ec4e4a0d932f83e101e02955a8023ad38638a (patch) | |
| tree | d0f6fb310ed0ef2711d538021c19c99d03b2a4f4 /docs | |
| parent | c30bf22f1c1b2d5043517845204d53d6752db0fe (diff) | |
| download | curl-ff9ec4e4a0d932f83e101e02955a8023ad38638a.tar.gz | |
CURLOPT_QUOTE.3: clarify that libcurl doesn't parse what's sent
... so passed in commands may confuse libcurl's knowledge of state.
Reported-by: Bodo Bergmann
Fixes #6577
Closes #6580
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/libcurl/opts/CURLOPT_QUOTE.3 | 17 |
1 files changed, 12 insertions, 5 deletions
diff --git a/docs/libcurl/opts/CURLOPT_QUOTE.3 b/docs/libcurl/opts/CURLOPT_QUOTE.3 index 08ac819b6..300328d6c 100644 --- a/docs/libcurl/opts/CURLOPT_QUOTE.3 +++ b/docs/libcurl/opts/CURLOPT_QUOTE.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -33,14 +33,21 @@ prior to your request. This will be done before any other commands are issued (even before the CWD command for FTP). The linked list should be a fully valid list of 'struct curl_slist' structs properly filled in with text strings. Use \fIcurl_slist_append(3)\fP to append strings (commands) to the list, and clear -the entire list afterwards with \fIcurl_slist_free_all(3)\fP. Disable this -operation again by setting a NULL to this option. When speaking to an FTP -server, prefix the command with an asterisk (*) to make libcurl continue even -if the command fails as by default libcurl will stop at first failure. +the entire list afterwards with \fIcurl_slist_free_all(3)\fP. + +Disable this operation again by setting a NULL to this option. + +When speaking to an FTP server, prefix the command with an asterisk (*) to +make libcurl continue even if the command fails as by default libcurl will +stop at first failure. The set of valid FTP commands depends on the server (see RFC959 for a list of mandatory commands). +libcurl does not inspect, parse or "understand" the commands passed to the +server using this option. If you change connection state, working directory or +similar using quote commands, libcurl will not know about it. + The valid SFTP commands are: .RS .IP "atime date file" |