docs: FTP quotes support '*' prefix to ignore errors

By default libcurl stops processing quote commands on failures.
This commit is contained in:
Daniel Stenberg 2011-06-30 09:57:23 +02:00
parent bfca0e2f50
commit 3e71ebe4eb
2 changed files with 28 additions and 22 deletions

View File

@ -1068,16 +1068,18 @@ file will not be read and used. See the \fI-K, --config\fP for details on the
default config file search path. default config file search path.
.IP "-Q, --quote <command>" .IP "-Q, --quote <command>"
(FTP/SFTP) Send an arbitrary command to the remote FTP or SFTP server. Quote (FTP/SFTP) Send an arbitrary command to the remote FTP or SFTP server. Quote
commands are sent BEFORE the transfer takes place (just after the commands are sent BEFORE the transfer takes place (just after the initial PWD
initial PWD command in an FTP transfer, to be exact). To make commands command in an FTP transfer, to be exact). To make commands take place after a
take place after a successful transfer, prefix them with a dash '-'. successful transfer, prefix them with a dash '-'. To make commands be sent
To make commands be sent after libcurl has changed the working directory, after libcurl has changed the working directory, just before the transfer
just before the transfer command(s), prefix the command with a '+' (this command(s), prefix the command with a '+' (this is only supported for
is only supported for FTP). You may specify any number of commands. If FTP). You may specify any number of commands. If the server returns failure
the server returns failure for one of the commands, the entire operation for one of the commands, the entire operation will be aborted. You must send
will be aborted. You must send syntactically correct FTP commands as syntactically correct FTP commands as RFC 959 defines to FTP servers, or one
RFC 959 defines to FTP servers, or one of the commands listed below to of the commands listed below to SFTP servers. This option can be used
SFTP servers. This option can be used multiple times. multiple times. When speaking to a FTP server, prefix the command with an
asterisk (*) to make libcurl continue even if the command fails as by default
curl will stop at first failure.
SFTP is a binary protocol. Unlike for FTP, libcurl interprets SFTP quote SFTP is a binary protocol. Unlike for FTP, libcurl interprets SFTP quote
commands itself before sending them to the server. File names may be quoted commands itself before sending them to the server. File names may be quoted

View File

@ -1313,18 +1313,22 @@ Examples with specified ports:
You disable PORT again and go back to using the passive version by setting You disable PORT again and go back to using the passive version by setting
this option to NULL. this option to NULL.
.IP CURLOPT_QUOTE .IP CURLOPT_QUOTE
Pass a pointer to a linked list of FTP or SFTP commands to pass to Pass a pointer to a linked list of FTP or SFTP commands to pass to the server
the server prior to your FTP request. This will be done before any prior to your FTP request. This will be done before any other commands are
other commands are issued (even before the CWD command for FTP). The issued (even before the CWD command for FTP). The linked list should be a
linked list should be a fully valid list of 'struct curl_slist' structs fully valid list of 'struct curl_slist' structs properly filled in with text
properly filled in with text strings. Use \fIcurl_slist_append(3)\fP strings. Use \fIcurl_slist_append(3)\fP to append strings (commands) to the
to append strings (commands) to the list, and clear the entire list list, and clear the entire list afterwards with
afterwards with \fIcurl_slist_free_all(3)\fP. Disable this operation \fIcurl_slist_free_all(3)\fP. Disable this operation again by setting a NULL
again by setting a NULL to this option. to this option. When speaking to a FTP server, prefix the command with an
The set of valid FTP commands depends on the server (see RFC959 for a asterisk (*) to make libcurl continue even if the command fails as by default
list of mandatory commands). libcurl will stop at first failure.
The valid SFTP commands are: chgrp, chmod, chown, ln, mkdir, pwd,
rename, rm, rmdir, symlink (see The set of valid FTP commands depends on the server (see RFC959 for a list of
mandatory commands).
The valid SFTP commands are: chgrp, chmod, chown, ln, mkdir, pwd, rename, rm,
rmdir, symlink (see
.BR curl (1)) .BR curl (1))
(SFTP support added in 7.16.3) (SFTP support added in 7.16.3)
.IP CURLOPT_POSTQUOTE .IP CURLOPT_POSTQUOTE