]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
CURLOPT_QUOTE.3: clarify that libcurl doesn't parse what's sent
authorDaniel Stenberg <daniel@haxx.se>
Mon, 8 Feb 2021 15:51:20 +0000 (16:51 +0100)
committerDaniel Stenberg <daniel@haxx.se>
Mon, 8 Feb 2021 21:35:50 +0000 (22:35 +0100)
... so passed in commands may confuse libcurl's knowledge of state.

Reported-by: Bodo Bergmann
Fixes #6577
Closes #6580

docs/libcurl/opts/CURLOPT_QUOTE.3

index 08ac819b694396a8f67c6dc4a90a5fa41a39e46a..300328d6c6d1b90609fe09a29819277882db7c25 100644 (file)
@@ -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"