diff options
| author | Patrick Monnerat <patrick@monnerat.net> | 2021-10-25 12:58:37 +0200 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2021-11-15 10:40:03 +0100 |
| commit | b20b364764cca2d577640126494fe2b09ae22e5d (patch) | |
| tree | 78846a017865e51309fa64bc9bed29c8c6a63b09 /docs/cmdline-opts | |
| parent | 6ec28eb68729240cd359803dd2f65cb3d5b03f42 (diff) | |
| download | curl-b20b364764cca2d577640126494fe2b09ae22e5d.tar.gz | |
mime: use percent-escaping for multipart form field and file names
Until now, form field and file names where escaped using the
backslash-escaping algorithm defined for multipart mails. This commit
replaces this with the percent-escaping method for URLs.
As this may introduce incompatibilities with server-side applications, a
new libcurl option CURLOPT_MIME_OPTIONS with bitmask
CURLMIMEOPT_FORMESCAPE is introduced to revert to legacy use of
backslash-escaping. This is controlled by new cli tool option
--form-escape.
New tests and documentation are provided for this feature.
Reported by: Ryan Sleevi
Fixes #7789
Closes #7805
Diffstat (limited to 'docs/cmdline-opts')
| -rw-r--r-- | docs/cmdline-opts/Makefile.inc | 1 | ||||
| -rw-r--r-- | docs/cmdline-opts/form-escape.d | 10 |
2 files changed, 11 insertions, 0 deletions
diff --git a/docs/cmdline-opts/Makefile.inc b/docs/cmdline-opts/Makefile.inc index 506025a75..f8b571127 100644 --- a/docs/cmdline-opts/Makefile.inc +++ b/docs/cmdline-opts/Makefile.inc @@ -75,6 +75,7 @@ DPAGES = \ fail-with-body.d \ fail.d \ false-start.d \ + form-escape.d \ form-string.d \ form.d \ ftp-account.d \ diff --git a/docs/cmdline-opts/form-escape.d b/docs/cmdline-opts/form-escape.d new file mode 100644 index 000000000..5fcd9ac1d --- /dev/null +++ b/docs/cmdline-opts/form-escape.d @@ -0,0 +1,10 @@ +Long: form-escape +Help: Escape multipart form field/file names using backslash +Protocols: HTTP +See-also: form +Added: 7.81.0 +Category: http post +Example: --form-escape --form 'field\\name=curl' 'file=@load"this' $URL +--- +Tells curl to pass on names of multipart form fields and files using +backslash-escaping instead of percent-encoding. |