2b49d17cba
Daniel Stenberg
2025-10-12
Subject
docs: expand on quoting rules for file names in SFTP quote
Binary
No binary (build failed)
Architecture & Compiler Flags
—
Build Log
(log yok)
Commit Diff GitHub →
docs/cmdline-opts/quote.md+6 -3
| @@ -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 | |
docs/libcurl/opts/CURLOPT_QUOTE.md+8 -4
| @@ -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 | |