xref: /curl/docs/examples/postit2.c (revision f540e43b)
1 /***************************************************************************
2  *                                  _   _ ____  _
3  *  Project                     ___| | | |  _ \| |
4  *                             / __| | | | |_) | |
5  *                            | (__| |_| |  _ <| |___
6  *                             \___|\___/|_| \_\_____|
7  *
8  * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
9  *
10  * This software is licensed as described in the file COPYING, which
11  * you should have received as part of this distribution. The terms
12  * are also available at https://curl.se/docs/copyright.html.
13  *
14  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15  * copies of the Software, and permit persons to whom the Software is
16  * furnished to do so, under the terms of the COPYING file.
17  *
18  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19  * KIND, either express or implied.
20  *
21  * SPDX-License-Identifier: curl
22  *
23  ***************************************************************************/
24 /* <DESC>
25  * HTTP Multipart formpost with file upload and two additional parts.
26  * </DESC>
27  */
28 /* Example code that uploads a filename 'foo' to a remote script that accepts
29  * "HTML form based" (as described in RFC 1738) uploads using HTTP POST.
30  *
31  * The imaginary form we fill in looks like:
32  *
33  * <form method="post" enctype="multipart/form-data" action="examplepost.cgi">
34  * Enter file: <input type="file" name="sendfile" size="40">
35  * Enter filename: <input type="text" name="filename" size="30">
36  * <input type="submit" value="send" name="submit">
37  * </form>
38  *
39  */
40 
41 #include <stdio.h>
42 #include <string.h>
43 
44 #include <curl/curl.h>
45 
main(int argc,char * argv[])46 int main(int argc, char *argv[])
47 {
48   CURL *curl;
49   CURLcode res;
50 
51   curl_mime *form = NULL;
52   curl_mimepart *field = NULL;
53   struct curl_slist *headerlist = NULL;
54   static const char buf[] = "Expect:";
55 
56   curl_global_init(CURL_GLOBAL_ALL);
57 
58   curl = curl_easy_init();
59   if(curl) {
60     /* Create the form */
61     form = curl_mime_init(curl);
62 
63     /* Fill in the file upload field */
64     field = curl_mime_addpart(form);
65     curl_mime_name(field, "sendfile");
66     curl_mime_filedata(field, "postit2.c");
67 
68     /* Fill in the filename field */
69     field = curl_mime_addpart(form);
70     curl_mime_name(field, "filename");
71     curl_mime_data(field, "postit2.c", CURL_ZERO_TERMINATED);
72 
73     /* Fill in the submit field too, even if this is rarely needed */
74     field = curl_mime_addpart(form);
75     curl_mime_name(field, "submit");
76     curl_mime_data(field, "send", CURL_ZERO_TERMINATED);
77 
78     /* initialize custom header list (stating that Expect: 100-continue is not
79        wanted */
80     headerlist = curl_slist_append(headerlist, buf);
81     /* what URL that receives this POST */
82     curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/examplepost.cgi");
83     if((argc == 2) && (!strcmp(argv[1], "noexpectheader")))
84       /* only disable 100-continue header if explicitly requested */
85       curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headerlist);
86     curl_easy_setopt(curl, CURLOPT_MIMEPOST, form);
87 
88     /* Perform the request, res gets the return code */
89     res = curl_easy_perform(curl);
90     /* Check for errors */
91     if(res != CURLE_OK)
92       fprintf(stderr, "curl_easy_perform() failed: %s\n",
93               curl_easy_strerror(res));
94 
95     /* always cleanup */
96     curl_easy_cleanup(curl);
97 
98     /* then cleanup the form */
99     curl_mime_free(form);
100     /* free slist */
101     curl_slist_free_all(headerlist);
102   }
103   return 0;
104 }
105