xref: /third_party/curl/docs/examples/postit2.c (revision 13498266)
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 file name '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 will 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 file name: <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
46int 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 will get 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