Docs: --post-file is binary data

Wget considers the file mentioned in the --post-file argument as a
binary file and does not strip any control characters. The lack of this
information in the documentation can cause a lot of headaches debugging
for a simple issue
This commit is contained in:
Darshit Shah 2015-03-06 22:00:24 +05:30
parent 16f1fb1d1f
commit 524f26a200
1 changed files with 5 additions and 0 deletions

View File

@ -1521,6 +1521,11 @@ Please note that wget does not require the content to be of the form
simply transmit whatever data is provided to it. Most servers however expect
the POST data to be in the above format when processing HTML Forms.
When sending a POST request using the @samp{--post-file} option, Wget treats
the file as a binary file and will send every character in the POST request
without stripping trailing newline or formfeed characters. Any other control
characters in the text will also be sent as-is in the POST request.
Please be aware that Wget needs to know the size of the POST data in
advance. Therefore the argument to @code{--post-file} must be a regular
file; specifying a FIFO or something like @file{/dev/stdin} won't work.