From ff9ec4e4a0d932f83e101e02955a8023ad38638a Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 8 Feb 2021 16:51:20 +0100 Subject: [PATCH] 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 --- docs/libcurl/opts/CURLOPT_QUOTE.3 | 17 ++++++++++++----- 1 file 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, , et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, , 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"