xref: /curl/docs/examples/multi-single.c (revision 53b4dfe4)
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  * using the multi interface to do a single download
26  * </DESC>
27  */
28 
29 #include <stdio.h>
30 #include <string.h>
31 
32 /* curl stuff */
33 #include <curl/curl.h>
34 
35 /*
36  * Simply download an HTTP file.
37  */
main(void)38 int main(void)
39 {
40   CURL *http_handle;
41   CURLM *multi_handle;
42   int still_running = 1; /* keep number of running handles */
43 
44   curl_global_init(CURL_GLOBAL_DEFAULT);
45 
46   http_handle = curl_easy_init();
47 
48   /* set the options (I left out a few, you get the point anyway) */
49   curl_easy_setopt(http_handle, CURLOPT_URL, "https://www.example.com/");
50 
51   /* init a multi stack */
52   multi_handle = curl_multi_init();
53 
54   /* add the individual transfers */
55   curl_multi_add_handle(multi_handle, http_handle);
56 
57   do {
58     CURLMcode mc = curl_multi_perform(multi_handle, &still_running);
59 
60     if(!mc)
61       /* wait for activity, timeout or "nothing" */
62       mc = curl_multi_poll(multi_handle, NULL, 0, 1000, NULL);
63 
64     if(mc) {
65       fprintf(stderr, "curl_multi_poll() failed, code %d.\n", (int)mc);
66       break;
67     }
68 
69   } while(still_running);
70 
71   curl_multi_remove_handle(multi_handle, http_handle);
72 
73   curl_easy_cleanup(http_handle);
74 
75   curl_multi_cleanup(multi_handle);
76 
77   curl_global_cleanup();
78 
79   return 0;
80 }
81