1 #ifndef __URL_H
2 #define __URL_H
3 /***************************************************************************
4  *                                  _   _ ____  _
5  *  Project                     ___| | | |  _ \| |
6  *                             / __| | | | |_) | |
7  *                            | (__| |_| |  _ <| |___
8  *                             \___|\___/|_| \_\_____|
9  *
10  * Copyright (C) 1998 - 2009, 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: url.h,v 1.43 2009-02-07 22:53:38 bagder Exp $
24  ***************************************************************************/
25 
26 #include <stdarg.h> /* to make sure we have ap_list */
27 
28 /*
29  * Prototypes for library-wide functions provided by url.c
30  */
31 
32 CURLcode Curl_open(struct SessionHandle **curl);
33 CURLcode Curl_init_userdefined(struct UserDefined *set);
34 CURLcode Curl_setopt(struct SessionHandle *data, CURLoption option,
35                      va_list arg);
36 CURLcode Curl_dupset(struct SessionHandle * dst, struct SessionHandle * src);
37 void Curl_freeset(struct SessionHandle * data);
38 CURLcode Curl_close(struct SessionHandle *data); /* opposite of curl_open() */
39 CURLcode Curl_connect(struct SessionHandle *, struct connectdata **,
40                       bool *async, bool *protocol_connect);
41 CURLcode Curl_async_resolved(struct connectdata *conn,
42                              bool *protocol_connect);
43 CURLcode Curl_do(struct connectdata **, bool *done);
44 CURLcode Curl_do_more(struct connectdata *);
45 CURLcode Curl_done(struct connectdata **, CURLcode, bool premature);
46 CURLcode Curl_disconnect(struct connectdata *);
47 CURLcode Curl_protocol_connect(struct connectdata *conn, bool *done);
48 CURLcode Curl_protocol_connecting(struct connectdata *conn, bool *done);
49 CURLcode Curl_protocol_doing(struct connectdata *conn, bool *done);
50 void Curl_safefree(void *ptr);
51 
52 /* create a connection cache */
53 struct conncache *Curl_mk_connc(int type, long amount);
54 /* free a connection cache */
55 void Curl_rm_connc(struct conncache *c);
56 /* Change number of entries of a connection cache */
57 CURLcode Curl_ch_connc(struct SessionHandle *data,
58                        struct conncache *c,
59                        long newamount);
60 
61 int Curl_protocol_getsock(struct connectdata *conn,
62                           curl_socket_t *socks,
63                           int numsocks);
64 int Curl_doing_getsock(struct connectdata *conn,
65                        curl_socket_t *socks,
66                        int numsocks);
67 
68 bool Curl_isPipeliningEnabled(const struct SessionHandle *handle);
69 CURLcode Curl_addHandleToPipeline(struct SessionHandle *handle,
70                                   struct curl_llist *pipeline);
71 int Curl_removeHandleFromPipeline(struct SessionHandle *handle,
72                                   struct curl_llist *pipeline);
73 /* remove the specified connection from all (possible) pipelines and related
74    queues */
75 void Curl_getoff_all_pipelines(struct SessionHandle *data,
76                                struct connectdata *conn);
77 
78 void Curl_close_connections(struct SessionHandle *data);
79 
80 /* Called on connect, and if there's already a protocol-specific struct
81    allocated for a different connection, this frees it that it can be setup
82    properly later on. */
83 void Curl_reset_reqproto(struct connectdata *conn);
84 
85 #define CURL_DEFAULT_PROXY_PORT 1080 /* default proxy port unless specified */
86 #define CURL_DEFAULT_SOCKS5_GSSAPI_SERVICE "rcmd" /* default socks5 gssapi service */
87 
88 #endif
89