mirror/curl
2
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2024-11-21 01:16:58 +08:00
Code Issues Packages Projects Releases Wiki Activity
feea9263e9
curl/lib/url.h

86 lines
3.8 KiB
C
Raw Normal View History

stdio.h, stdlib.h, string.h, stdarg.h and ctype.h inclusion done in setup_once.h
2011-07-26 23:23:27 +08:00
#ifndef HEADER_CURL_URL_H
#define HEADER_CURL_URL_H
updated source code boilerplate/header
2002-09-03 19:52:59 +08:00
/***************************************************************************
I made Curl_done() take a pointer-pointer in the first argument instead, and if the connection is killed it blanks the pointer it points to, to make it easier to detect usage problems whereever Curl_done() is used.
2004-05-17 16:05:46 +08:00
* _ _ ____ _
* Project ___| | | | _ \| |
* / __| | | | |_) | |
* | (__| |_| | _ <| |___
moved here from the newlib branch
2000-05-22 22:12:12 +08:00
* \___|\___/|_| \_\_____|
*
FTP: when EPSV gets a 229 but fails to connect, retry with PASV This is a regression as this logic used to work. It isn't clear when it broke, but I'm assuming in 7.28.0 when we went all-multi internally. This likely never worked with the multi interface. As the failed connection is detected once the multi state has reached DO_MORE, the Curl_do_more() function was now expanded somewhat so that the ftp_do_more() function can request to go "back" to the previous state when it makes another attempt - using PASV. Added test case 1233 to verify this fix. It has the little issue that it assumes no service is listening/accepting connections on port 1... Reported-by: byte_bucket in the #curl IRC channel
2013-08-06 05:49:53 +08:00
* Copyright (C) 1998 - 2013, Daniel Stenberg, <daniel@haxx.se>, et al.
moved here from the newlib branch
2000-05-22 22:12:12 +08:00
*
updated source code boilerplate/header
2002-09-03 19:52:59 +08:00
* This software is licensed as described in the file COPYING, which
* you should have received as part of this distribution. The terms
* are also available at http://curl.haxx.se/docs/copyright.html.
I made Curl_done() take a pointer-pointer in the first argument instead, and if the connection is killed it blanks the pointer it points to, to make it easier to detect usage problems whereever Curl_done() is used.
2004-05-17 16:05:46 +08:00
*
dual-license fix
2001-01-03 17:29:33 +08:00
* You may opt to use, copy, modify, merge, publish, distribute and/or sell
* copies of the Software, and permit persons to whom the Software is
updated source code boilerplate/header
2002-09-03 19:52:59 +08:00
* furnished to do so, under the terms of the COPYING file.
moved here from the newlib branch
2000-05-22 22:12:12 +08:00
*
dual-license fix
2001-01-03 17:29:33 +08:00
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
* KIND, either express or implied.
moved here from the newlib branch
2000-05-22 22:12:12 +08:00
*
updated source code boilerplate/header
2002-09-03 19:52:59 +08:00
***************************************************************************/
build: fix circular header inclusion with other packages This commit renames lib/setup.h to lib/curl_setup.h and renames lib/setup_once.h to lib/curl_setup_once.h. Removes the need and usage of a header inclusion guard foreign to libcurl. [1] Removes the need and presence of an alarming notice we carried in old setup_once.h [2] ---------------------------------------- 1 - lib/setup_once.h used __SETUP_ONCE_H macro as header inclusion guard up to commit ec691ca3 which changed this to HEADER_CURL_SETUP_ONCE_H, this single inclusion guard is enough to ensure that inclusion of lib/setup_once.h done from lib/setup.h is only done once. Additionally lib/setup.h has always used __SETUP_ONCE_H macro to protect inclusion of setup_once.h even after commit ec691ca3, this was to avoid a circular header inclusion triggered when building a c-ares enabled version with c-ares sources available which also has a setup_once.h header. Commit ec691ca3 exposes the real nature of __SETUP_ONCE_H usage in lib/setup.h, it is a header inclusion guard foreign to libcurl belonging to c-ares's setup_once.h The renaming this commit does, fixes the circular header inclusion, and as such removes the need and usage of a header inclusion guard foreign to libcurl. Macro __SETUP_ONCE_H no longer used in libcurl. 2 - Due to the circular interdependency of old lib/setup_once.h and the c-ares setup_once.h header, old file lib/setup_once.h has carried back from 2006 up to now days an alarming and prominent notice about the need of keeping libcurl's and c-ares's setup_once.h in sync. Given that this commit fixes the circular interdependency, the need and presence of mentioned notice is removed. All mentioned interdependencies come back from now old days when the c-ares project lived inside a curl subdirectory. This commit removes last traces of such fact.
2013-01-07 02:06:49 +08:00
#include "curl_setup.h"
Internal symbols that aren't static are now prefixed with 'Curl_'
2001-01-05 18:11:41 +08:00
moved the url.c prototypes to here
2001-08-15 14:53:34 +08:00
/*
Revert changes relative to lib/*.[ch] recent renaming This reverts renaming and usage of lib/*.h header files done 28-12-2012, reverting 2 commits: f871de0... build: make use of 76 lib/*.h renamed files ffd8e12... build: rename 76 lib/*.h files This also reverts removal of redundant include guard (redundant thanks to changes in above commits) done 2-12-2013, reverting 1 commit: c087374... curl_setup.h: remove redundant include guard This also reverts renaming and usage of lib/*.c source files done 3-12-2013, reverting 3 commits: 13606bb... build: make use of 93 lib/*.c renamed files 5b6e792... build: rename 93 lib/*.c files 7d83dff... build: commit 13606bbfde follow-up 1 Start of related discussion thread: http://curl.haxx.se/mail/lib-2013-01/0012.html Asking for confirmation on pushing this revertion commit: http://curl.haxx.se/mail/lib-2013-01/0048.html Confirmation summary: http://curl.haxx.se/mail/lib-2013-01/0079.html NOTICE: The list of 2 files that have been modified by other intermixed commits, while renamed, and also by at least one of the 6 commits this one reverts follows below. These 2 files will exhibit a hole in history unless git's '--follow' option is used when viewing logs. lib/curl_imap.h lib/curl_smtp.h
2013-01-04 09:50:28 +08:00
* Prototypes for library-wide functions provided by url.c
moved the url.c prototypes to here
2001-08-15 14:53:34 +08:00
*/
Major rename and redesign of the internal "backbone" structs. Details will be posted in a minute to the libcurl list.
2001-08-31 06:48:34 +08:00
CURLcode Curl_open(struct SessionHandle **curl);
Unified much of the SessionHandle initialization done in Curl_open() and curl_easy_reset() by creating Curl_init_userdefined(). This had the side effect of fixing curl_easy_reset() so it now also resets CURLOPT_FTP_FILEMETHOD and CURLOPT_SSL_SESSIONID_CACHE
2009-01-08 08:31:49 +08:00
CURLcode Curl_init_userdefined(struct UserDefined *set);
Simplified the code within curl_easy_perform() that calls Curl_perform(). Pointed out by Bjorn Reese.
2005-07-17 20:44:11 +08:00
CURLcode Curl_setopt(struct SessionHandle *data, CURLoption option,
va_list arg);
Patrick Monnerat and I modified libcurl so that now it *copies* all strings passed to it with curl_easy_setopt()! Previously it has always just refered to the data, forcing the user to keep the data around until libcurl is done with it. That is now history and libcurl will instead clone the given strings and keep private copies.
2007-08-02 05:20:01 +08:00
CURLcode Curl_dupset(struct SessionHandle * dst, struct SessionHandle * src);
void Curl_freeset(struct SessionHandle * data);
merged the multi-dev branch back into MAIN again
2002-01-03 23:01:22 +08:00
CURLcode Curl_close(struct SessionHandle *data); /* opposite of curl_open() */
ares awareness/usage/support added. If configure --enable-ares is used, we build libcurl to use ares for asynch name resolves.
2003-08-05 22:40:59 +08:00
CURLcode Curl_connect(struct SessionHandle *, struct connectdata **,
FTP code turned into state machine. Not completely yet, but a good start. The tag 'before_ftp_statemachine' was set just before this commit in case of future need.
2005-02-09 21:06:40 +08:00
bool *async, bool *protocol_connect);
CURLcode Curl_do(struct connectdata **, bool *done);
FTP: when EPSV gets a 229 but fails to connect, retry with PASV This is a regression as this logic used to work. It isn't clear when it broke, but I'm assuming in 7.28.0 when we went all-multi internally. This likely never worked with the multi interface. As the failed connection is detected once the multi state has reached DO_MORE, the Curl_do_more() function was now expanded somewhat so that the ftp_do_more() function can request to go "back" to the previous state when it makes another attempt - using PASV. Added test case 1233 to verify this fix. It has the little issue that it assumes no service is listening/accepting connections on port 1... Reported-by: byte_bucket in the #curl IRC channel
2013-08-06 05:49:53 +08:00
CURLcode Curl_do_more(struct connectdata *, int *completed);
- Armel Asselin improved libcurl to behave a lot better when an easy handle doing an FTP transfer is removed from a multi handle before completion. The fix also fixed the "alive counter" to be correct on "premature removal" for all protocols.
2007-01-17 06:22:10 +08:00
CURLcode Curl_done(struct connectdata **, CURLcode, bool premature);
url: provide dead_connection flag in Curl_handler::disconnect It helps to prevent a hangup with some FTP servers in case idle session timeout has exceeded. But it may be useful also for other protocols that send any quit message on disconnect. Currently used by FTP, POP3, IMAP and SMTP.
2010-11-19 20:43:20 +08:00
CURLcode Curl_disconnect(struct connectdata *, bool dead_connection);
FTP code turned into state machine. Not completely yet, but a good start. The tag 'before_ftp_statemachine' was set just before this commit in case of future need.
2005-02-09 21:06:40 +08:00
CURLcode Curl_protocol_connect(struct connectdata *conn, bool *done);
CURLcode Curl_protocol_connecting(struct connectdata *conn, bool *done);
CURLcode Curl_protocol_doing(struct connectdata *conn, bool *done);
async resolvers: further cleanups asyn-ares.c and asyn-thread.c are two separate backends that implement the same (internal) async resolver API for libcurl to use. Backend is specified at build time. The internal resolver API is defined in asyn.h for asynch resolvers.
2011-01-31 07:10:35 +08:00
CURLcode Curl_setup_conn(struct connectdata *conn,
bool *protocol_done);
SessionHandle: the protocol specific pointer is now a void * All protocol handler structs are now opaque (void *) in the SessionHandle struct and moved in the request-specific sub-struct 'SingleRequest'. The intension is to keep the protocol specific knowledge in their own dedicated source files [protocol].c etc. There's some "leakage" where this policy is violated, to be addressed at a later point in time.
2013-08-05 16:32:08 +08:00
void Curl_free_request_state(struct SessionHandle *data);
First curl_multi_socket() commit. Should primarily be considered as an internal code rearrange to fit the future better.
2006-04-10 23:00:53 +08:00
int Curl_protocol_getsock(struct connectdata *conn,
curl_socket_t *socks,
int numsocks);
int Curl_doing_getsock(struct connectdata *conn,
curl_socket_t *socks,
int numsocks);
Dmitry Kurochkin worked a lot on improving the HTTP Pipelining support that previously had a number of flaws, perhaps most notably when an application fired up N transfers at once as then they wouldn't pipeline at all that nicely as anyone would think... Test case 530 was also updated to take the improved functionality into account.
2008-01-16 20:24:00 +08:00
bool Curl_isPipeliningEnabled(const struct SessionHandle *handle);
Fixed an out of memory handling issue with HTTP pipelines.
2007-05-03 03:13:56 +08:00
CURLcode Curl_addHandleToPipeline(struct SessionHandle *handle,
Enabled a few more gcc warnings with --enable-debug. Renamed a few variables to avoid shadowing global declarations.
2007-09-27 09:45:22 +08:00
struct curl_llist *pipeline);
Bogdan Nicula's second test case (posted Sun, 08 Oct 2006) converted to test case 535 and it now runs fine. Again a problem with the pipelining code not taking all possible (error) conditions into account.
2006-10-09 14:58:05 +08:00
int Curl_removeHandleFromPipeline(struct SessionHandle *handle,
Enabled a few more gcc warnings with --enable-debug. Renamed a few variables to avoid shadowing global declarations.
2007-09-27 09:45:22 +08:00
struct curl_llist *pipeline);
- Igor Novoseltsev filed bug #2351645 (http://curl.haxx.se/bug/view.cgi?id=2351645) that identified a problem with the multi interface that occured if you removed an easy handle while in progress and the handle was used in a HTTP pipeline.
2008-12-03 23:20:27 +08:00
/* remove the specified connection from all (possible) pipelines and related
queues */
void Curl_getoff_all_pipelines(struct SessionHandle *data,
struct connectdata *conn);
Major overhaul introducing http pipelining support and shared connection cache within the multi handle.
2006-09-08 05:49:20 +08:00
void Curl_close_connections(struct SessionHandle *data);
provide CURL_DEFAULT_PROXY_PORT set to 1080 for the default port libcurl assumes proxies to use
2008-04-06 05:13:31 +08:00
#define CURL_DEFAULT_PROXY_PORT 1080 /* default proxy port unless specified */
source cleanup: unify look, style and indent levels By the use of a the new lib/checksrc.pl script that checks that our basic source style rules are followed.
2011-04-20 21:17:42 +08:00
#define CURL_DEFAULT_SOCKS5_GSSAPI_SERVICE "rcmd" /* default socks5 gssapi
service */
Negotiate: custom service names for SPNEGO. * Add new options, CURLOPT_PROXY_SERVICE_NAME and CURLOPT_SERVICE_NAME. * Add new curl options, --proxy-service-name and --service-name.
2015-03-29 20:52:31 +08:00
#define CURL_DEFAULT_PROXY_SERVICE_NAME "HTTP" /* default negotiate proxy
service */
#define CURL_DEFAULT_SERVICE_NAME "HTTP" /* default negotiate service */
provide CURL_DEFAULT_PROXY_PORT set to 1080 for the default port libcurl assumes proxies to use
2008-04-06 05:13:31 +08:00
FTP: make the data connection work when going through proxy This is a regression since the switch to always-multi internally c43127414d89c. Test 1316 was modified since we now clearly call the Curl_client_write() function when doing the LIST transfer part and then the handler->protocol says FTP and ftpc.transfertype is 'A' which implies text converting even though that the response is initially a HTTP CONNECT response in this case.
2013-10-27 02:19:27 +08:00
CURLcode Curl_connected_proxy(struct connectdata *conn, int sockindex);
- Constantine Sapuntzakis fixed bug report #2784055 (http://curl.haxx.se/bug/view.cgi?id=2784055) identifying a problem to connect to SOCKS proxies when using the multi interface. It turned out to almost not work at all previously. We need to wait for the TCP connect to be properly verified before doing the SOCKS magic. There's still a flaw in the FTP code for this.
2009-05-08 18:59:40 +08:00
multi interface: missed storing connection time Dirk Manske reported a regression. When connecting with the multi interface, there were situations where libcurl wouldn't store connect time correctly as it used to (and is documented to) do. Using his fine sample program we could repeat it, and I wrote up test case 573 using that code. The problem does not easily show itself using the local test suite though. The fix, also as suggested by Dirk, is a bit on the ugly side as it adds yet another call to Curl_verboseconnect() and setting the TIMER_CONNECT time. That situation is subject for some closer inspection in the future.
2010-05-08 05:49:29 +08:00
#ifdef CURL_DISABLE_VERBOSE_STRINGS
fix a bunch of MSVC compiler warnings
2011-09-03 22:06:10 +08:00
#define Curl_verboseconnect(x) Curl_nop_stmt
multi interface: missed storing connection time Dirk Manske reported a regression. When connecting with the multi interface, there were situations where libcurl wouldn't store connect time correctly as it used to (and is documented to) do. Using his fine sample program we could repeat it, and I wrote up test case 573 using that code. The problem does not easily show itself using the local test suite though. The fix, also as suggested by Dirk, is a bit on the ugly side as it adds yet another call to Curl_verboseconnect() and setting the TIMER_CONNECT time. That situation is subject for some closer inspection in the future.
2010-05-08 05:49:29 +08:00
#else
void Curl_verboseconnect(struct connectdata *conn);
#endif
stdio.h, stdlib.h, string.h, stdarg.h and ctype.h inclusion done in setup_once.h
2011-07-26 23:23:27 +08:00
#endif /* HEADER_CURL_URL_H */
Reference in New Issue Copy Permalink