docs: expand on quoting rules for file names in SFTP quote

Reported-by: Harry Sintonen
Closes #19025
This commit is contained in:
Daniel Stenberg 2025-10-11 22:44:30 +02:00
parent 6e35eb4879
commit 2b49d17cba
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
2 changed files with 14 additions and 7 deletions

View file

@ -37,9 +37,12 @@ You must send syntactically correct FTP commands as RFC 959 defines to FTP
servers, or one of the commands listed below to SFTP servers.
SFTP is a binary protocol. Unlike for FTP, curl interprets SFTP quote commands
itself before sending them to the server. Filenames may be quoted shell-style
to embed spaces or special characters. Following is the list of all supported
SFTP quote commands:
itself before sending them to the server. Filenames must be provided within
double quotes to embed spaces, backslashes, quotes or double quotes. Within
double quotes the following escape sequences are available for that purpose:
\\, \", and \'.
Following is the list of all supported SFTP quote commands:
## atime date file
The atime command sets the last access time of the file named by the file

View file

@ -52,11 +52,15 @@ 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 does not know about it.
The path arguments for FTP or SFTP can use single or double quotes to
distinguish a space from being the parameter separator or being a part of the
path. e.g. rename with sftp using a quote command like this:
The path arguments for FTP or SFTP should use double quotes to distinguish a
space from being the parameter separator or being a part of the path. For
example, rename with sftp using a quote command like this:
"rename 'test/_upload.txt' 'test/Hello World.txt'"
rename "test/_upload.txt" "test/Hello World.txt"
For SFTP, filenames must be provided within double quotes to embed spaces,
backslashes, quotes or double quotes. Within double quotes the following
escape sequences are available for that purpose: \\, \", and \'.
# SFTP commands