~ubuntu-branches/ubuntu/vivid/curl/vivid

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_formadd.3

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Schuldei
  • Date: 2009-04-02 23:35:45 UTC
  • mto: (1.2.1 upstream) (3.2.3 sid)
  • mto: This revision was merged to the branch mainline in revision 38.
  • Revision ID: james.westby@ubuntu.com-20090402233545-geixkwhe3izccjt7
Tags: upstream-7.19.4
ImportĀ upstreamĀ versionĀ 7.19.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\" You can view this file with:
2
2
.\" nroff -man [file]
3
 
.\" $Id: curl_formadd.3,v 1.17 2008-03-31 10:02:24 bagder Exp $
 
3
.\" $Id: curl_formadd.3,v 1.19 2009-01-12 21:22:51 bagder Exp $
4
4
.\"
5
5
.TH curl_formadd 3 "24 June 2002" "libcurl 7.9.8" "libcurl Manual"
6
6
.SH NAME
106
106
Tells libcurl to use the \fICURLOPT_READFUNCTION\fP callback to get data. The
107
107
parameter you pass to \fICURLFORM_STREAM\fP is the pointer passed on to the
108
108
read callback's fourth argument. If you want the part to look like a file
109
 
upload one, set the \fICURLFORM_FILENAME\fP parameter as well. (Option added
110
 
in libcurl 7.18.2)
 
109
upload one, set the \fICURLFORM_FILENAME\fP parameter as well. Note that when
 
110
using \fICURLFORM_STREAM\fP, \fICURLFORM_CONTENTSLENGTH\fP must also be set
 
111
with the total expected length of the part. (Option added in libcurl 7.18.2)
111
112
.IP CURLFORM_ARRAY
112
113
Another possibility to send options to curl_formadd() is the
113
114
\fBCURLFORM_ARRAY\fP option, that passes a struct curl_forms array pointer as
128
129
 
129
130
See example below.
130
131
.SH RETURN VALUE
131
 
0 means everything was ok, non-zero means an error occurred as
 
132
0 means everything was ok, non-zero means an error occurred corresponding
 
133
to a CURL_FORMADD_* constant defined in
132
134
.I <curl/curl.h>
133
 
defines.
134
135
.SH EXAMPLE
135
136
.nf
136
137