From c092b0f0f394df78a74990a7a89fc6e90a79ea99 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Sun, 2 Aug 2015 00:14:23 +0200 Subject: docs: formpost needs the full size at start of upload Closes #360 --- docs/curl.1 | 4 +++- docs/libcurl/curl_formadd.3 | 5 ++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/curl.1 b/docs/curl.1 index 69ab9781d..e3303a54f 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -607,7 +607,9 @@ input: \fBcurl\fP -F password=@/etc/passwd www.mypasswords.com To read content from stdin instead of a file, use - as the filename. This goes -for both @ and < constructs. +for both @ and < constructs. Unfortunately it does not support reading the +file from a named pipe or similar, as it needs the full size before the +transfer starts. You can also tell curl what Content-Type to use by using 'type=', in a manner similar to: diff --git a/docs/libcurl/curl_formadd.3 b/docs/libcurl/curl_formadd.3 index 3e48149ef..cdae51be2 100644 --- a/docs/libcurl/curl_formadd.3 +++ b/docs/libcurl/curl_formadd.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -103,6 +103,9 @@ given file match one of the internally known file extensions. For providing multiple \fBCURLFORM_FILE\fP arguments each followed by the filename (and each \fICURLFORM_FILE\fP is allowed to have a \fICURLFORM_CONTENTTYPE\fP). + +The given upload file has to exist in its full in the file system already when +the upload starts, as libcurl needs to read the correct file size beforehand. .IP CURLFORM_CONTENTTYPE is used in combination with \fICURLFORM_FILE\fP. Followed by a pointer to a string which provides the content-type for this part, possibly instead of an -- cgit v1.2.1