| 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@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.1 2008-12-12 16:46:08 ovyn 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
|
|---|
