1 #ifndef __CURL_EASY_H 2 #define __CURL_EASY_H 3 /*************************************************************************** 4 * _ _ ____ _ 5 * Project ___| | | | _ \| | 6 * / __| | | | |_) | | 7 * | (__| |_| | _ <| |___ 8 * \___|\___/|_| \_\_____| 9 * 10 * Copyright (C) 1998 - 2008, Daniel Stenberg, <daniel (at) haxx.se>, et al. 11 * 12 * This software is licensed as described in the file COPYING, which 13 * you should have received as part of this distribution. The terms 14 * are also available at http://curl.haxx.se/docs/copyright.html. 15 * 16 * You may opt to use, copy, modify, merge, publish, distribute and/or sell 17 * copies of the Software, and permit persons to whom the Software is 18 * furnished to do so, under the terms of the COPYING file. 19 * 20 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY 21 * KIND, either express or implied. 22 * 23 * $Id: easy.h,v 1.14 2008-05-12 21:43:28 bagder Exp $ 24 ***************************************************************************/ 25 #ifdef __cplusplus 26 extern "C" { 27 #endif 28 29 CURL_EXTERN CURL *curl_easy_init(void); 30 CURL_EXTERN CURLcode curl_easy_setopt(CURL *curl, CURLoption option, ...); 31 CURL_EXTERN CURLcode curl_easy_perform(CURL *curl); 32 CURL_EXTERN void curl_easy_cleanup(CURL *curl); 33 34 /* 35 * NAME curl_easy_getinfo() 36 * 37 * DESCRIPTION 38 * 39 * Request internal information from the curl session with this function. The 40 * third argument MUST be a pointer to a long, a pointer to a char * or a 41 * pointer to a double (as the documentation describes elsewhere). The data 42 * pointed to will be filled in accordingly and can be relied upon only if the 43 * function returns CURLE_OK. This function is intended to get used *AFTER* a 44 * performed transfer, all results from this function are undefined until the 45 * transfer is completed. 46 */ 47 CURL_EXTERN CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ...); 48 49 50 /* 51 * NAME curl_easy_duphandle() 52 * 53 * DESCRIPTION 54 * 55 * Creates a new curl session handle with the same options set for the handle 56 * passed in. Duplicating a handle could only be a matter of cloning data and 57 * options, internal state info and things like persistant connections cannot 58 * be transfered. It is useful in multithreaded applications when you can run 59 * curl_easy_duphandle() for each new thread to avoid a series of identical 60 * curl_easy_setopt() invokes in every thread. 61 */ 62 CURL_EXTERN CURL* curl_easy_duphandle(CURL *curl); 63 64 /* 65 * NAME curl_easy_reset() 66 * 67 * DESCRIPTION 68 * 69 * Re-initializes a CURL handle to the default values. This puts back the 70 * handle to the same state as it was in when it was just created. 71 * 72 * It does keep: live connections, the Session ID cache, the DNS cache and the 73 * cookies. 74 */ 75 CURL_EXTERN void curl_easy_reset(CURL *curl); 76 77 /* 78 * NAME curl_easy_recv() 79 * 80 * DESCRIPTION 81 * 82 * Receives data from the connected socket. Use after successful 83 * curl_easy_perform() with CURLOPT_CONNECT_ONLY option. 84 */ 85 CURL_EXTERN CURLcode curl_easy_recv(CURL *curl, void *buffer, size_t buflen, 86 size_t *n); 87 88 /* 89 * NAME curl_easy_send() 90 * 91 * DESCRIPTION 92 * 93 * Sends data over the connected socket. Use after successful 94 * curl_easy_perform() with CURLOPT_CONNECT_ONLY option. 95 */ 96 CURL_EXTERN CURLcode curl_easy_send(CURL *curl, const void *buffer, 97 size_t buflen, size_t *n); 98 99 #ifdef __cplusplus 100 } 101 #endif 102 103 #endif 104
