mirror of
https://github.com/moparisthebest/curl
synced 2025-02-28 09:21:50 -05:00
docs: FTP quotes support '*' prefix to ignore errors
By default libcurl stops processing quote commands on failures.
This commit is contained in:
parent
bfca0e2f50
commit
3e71ebe4eb
22
docs/curl.1
22
docs/curl.1
@ -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
|
||||||
|
@ -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
|
||||||
|
Loading…
x
Reference in New Issue
Block a user