2012-12-28 06:03:09 -05:00
|
|
|
#ifndef HEADER_CURL_HTTP_H
|
|
|
|
#define HEADER_CURL_HTTP_H
|
2002-09-03 07:52:59 -04:00
|
|
|
/***************************************************************************
|
2004-06-15 04:45:22 -04:00
|
|
|
* _ _ ____ _
|
|
|
|
* Project ___| | | | _ \| |
|
|
|
|
* / __| | | | |_) | |
|
|
|
|
* | (__| |_| | _ <| |___
|
1999-12-29 09:20:26 -05:00
|
|
|
* \___|\___/|_| \_\_____|
|
|
|
|
*
|
2013-08-04 13:34:16 -04:00
|
|
|
* Copyright (C) 1998 - 2013, Daniel Stenberg, <daniel@haxx.se>, et al.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2002-09-03 07:52:59 -04: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.
|
2004-06-15 04:45:22 -04:00
|
|
|
*
|
2001-01-03 04:29:33 -05: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
|
2002-09-03 07:52:59 -04:00
|
|
|
* furnished to do so, under the terms of the COPYING file.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2001-01-03 04:29:33 -05:00
|
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
|
|
* KIND, either express or implied.
|
1999-12-29 09:20:26 -05:00
|
|
|
*
|
2002-09-03 07:52:59 -04:00
|
|
|
***************************************************************************/
|
2013-09-07 07:01:43 -04:00
|
|
|
#include "curl_setup.h"
|
|
|
|
|
2002-06-11 07:13:01 -04:00
|
|
|
#ifndef CURL_DISABLE_HTTP
|
2007-10-12 09:36:37 -04:00
|
|
|
|
2013-09-07 07:01:43 -04:00
|
|
|
#ifdef USE_NGHTTP2
|
|
|
|
#include <nghttp2/nghttp2.h>
|
|
|
|
#endif
|
|
|
|
|
2007-10-12 09:36:37 -04:00
|
|
|
extern const struct Curl_handler Curl_handler_http;
|
|
|
|
|
|
|
|
#ifdef USE_SSL
|
|
|
|
extern const struct Curl_handler Curl_handler_https;
|
|
|
|
#endif
|
|
|
|
|
2007-08-26 01:53:26 -04:00
|
|
|
bool Curl_compareheader(const char *headerline, /* line to check */
|
2002-11-28 10:48:23 -05:00
|
|
|
const char *header, /* header keyword _with_ colon */
|
|
|
|
const char *content); /* content string to find */
|
|
|
|
|
2010-01-21 08:58:30 -05:00
|
|
|
char *Curl_checkheaders(struct SessionHandle *data, const char *thisheader);
|
|
|
|
|
|
|
|
/* ------------------------------------------------------------------------- */
|
|
|
|
/*
|
|
|
|
* The add_buffer series of functions are used to build one large memory chunk
|
|
|
|
* from repeated function invokes. Used so that the entire HTTP request can
|
|
|
|
* be sent in one go.
|
|
|
|
*/
|
|
|
|
struct Curl_send_buffer {
|
|
|
|
char *buffer;
|
|
|
|
size_t size_max;
|
|
|
|
size_t size_used;
|
|
|
|
};
|
|
|
|
typedef struct Curl_send_buffer Curl_send_buffer;
|
|
|
|
|
|
|
|
Curl_send_buffer *Curl_add_buffer_init(void);
|
|
|
|
CURLcode Curl_add_bufferf(Curl_send_buffer *in, const char *fmt, ...);
|
|
|
|
CURLcode Curl_add_buffer(Curl_send_buffer *in, const void *inptr, size_t size);
|
|
|
|
CURLcode Curl_add_buffer_send(Curl_send_buffer *in,
|
2010-07-24 16:52:35 -04:00
|
|
|
struct connectdata *conn,
|
|
|
|
long *bytes_written,
|
|
|
|
size_t included_body_bytes,
|
|
|
|
int socketindex);
|
2010-01-21 08:58:30 -05:00
|
|
|
|
|
|
|
CURLcode Curl_add_timecondition(struct SessionHandle *data,
|
|
|
|
Curl_send_buffer *buf);
|
|
|
|
CURLcode Curl_add_custom_headers(struct connectdata *conn,
|
|
|
|
Curl_send_buffer *req_buffer);
|
|
|
|
|
2000-09-14 10:05:01 -04:00
|
|
|
/* protocol-specific functions set up to be called by the main engine */
|
2005-02-09 08:06:40 -05:00
|
|
|
CURLcode Curl_http(struct connectdata *conn, bool *done);
|
2007-01-16 17:22:10 -05:00
|
|
|
CURLcode Curl_http_done(struct connectdata *, CURLcode, bool premature);
|
2005-02-09 08:06:40 -05:00
|
|
|
CURLcode Curl_http_connect(struct connectdata *conn, bool *done);
|
2013-08-04 13:34:16 -04:00
|
|
|
CURLcode Curl_http_setup_conn(struct connectdata *conn);
|
1999-12-29 09:20:26 -05:00
|
|
|
|
2013-01-03 20:50:28 -05:00
|
|
|
/* The following functions are defined in http_chunks.c */
|
2001-03-07 18:51:41 -05:00
|
|
|
void Curl_httpchunk_init(struct connectdata *conn);
|
|
|
|
CHUNKcode Curl_httpchunk_read(struct connectdata *conn, char *datap,
|
|
|
|
ssize_t length, ssize_t *wrote);
|
2004-03-30 01:40:01 -05:00
|
|
|
|
2013-01-03 20:50:28 -05:00
|
|
|
/* These functions are in http.c */
|
2003-08-11 07:47:45 -04:00
|
|
|
void Curl_http_auth_stage(struct SessionHandle *data, int stage);
|
2004-05-04 03:52:53 -04:00
|
|
|
CURLcode Curl_http_input_auth(struct connectdata *conn,
|
2007-08-27 02:31:28 -04:00
|
|
|
int httpcode, const char *header);
|
2004-05-04 03:52:53 -04:00
|
|
|
CURLcode Curl_http_auth_act(struct connectdata *conn);
|
2008-08-04 18:00:22 -04:00
|
|
|
CURLcode Curl_http_perhapsrewind(struct connectdata *conn);
|
2004-03-30 01:40:01 -05:00
|
|
|
|
2004-06-15 04:45:22 -04:00
|
|
|
/* If only the PICKNONE bit is set, there has been a round-trip and we
|
|
|
|
selected to use no auth at all. Ie, we actively select no auth, as opposed
|
|
|
|
to not having one selected. The other CURLAUTH_* defines are present in the
|
|
|
|
public curl/curl.h header. */
|
|
|
|
#define CURLAUTH_PICKNONE (1<<30) /* don't use auth */
|
|
|
|
|
2004-11-24 11:11:35 -05:00
|
|
|
/* MAX_INITIAL_POST_SIZE indicates the number of bytes that will make the POST
|
|
|
|
data get included in the initial data chunk sent to the server. If the
|
|
|
|
data is larger than this, it will automatically get split up in multiple
|
|
|
|
system calls.
|
|
|
|
|
|
|
|
This value used to be fairly big (100K), but we must take into account that
|
|
|
|
if the server rejects the POST due for authentication reasons, this data
|
|
|
|
will always be uncondtionally sent and thus it may not be larger than can
|
|
|
|
always be afforded to send twice.
|
|
|
|
|
|
|
|
It must not be greater than 64K to work on VMS.
|
|
|
|
*/
|
2004-11-05 09:43:35 -05:00
|
|
|
#ifndef MAX_INITIAL_POST_SIZE
|
2006-08-18 18:54:57 -04:00
|
|
|
#define MAX_INITIAL_POST_SIZE (64*1024)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef TINY_INITIAL_POST_SIZE
|
|
|
|
#define TINY_INITIAL_POST_SIZE 1024
|
2004-11-05 09:43:35 -05:00
|
|
|
#endif
|
|
|
|
|
2009-12-12 17:17:51 -05:00
|
|
|
#endif /* CURL_DISABLE_HTTP */
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* HTTP unique setup
|
|
|
|
***************************************************************************/
|
|
|
|
struct HTTP {
|
|
|
|
struct FormData *sendit;
|
|
|
|
curl_off_t postsize; /* off_t to handle large file sizes */
|
|
|
|
const char *postdata;
|
|
|
|
|
|
|
|
const char *p_pragma; /* Pragma: string */
|
|
|
|
const char *p_accept; /* Accept: string */
|
|
|
|
curl_off_t readbytecount;
|
|
|
|
curl_off_t writebytecount;
|
|
|
|
|
|
|
|
/* For FORM posting */
|
|
|
|
struct Form form;
|
|
|
|
|
|
|
|
struct back {
|
|
|
|
curl_read_callback fread_func; /* backup storage for fread pointer */
|
|
|
|
void *fread_in; /* backup storage for fread_in pointer */
|
|
|
|
const char *postdata;
|
|
|
|
curl_off_t postsize;
|
|
|
|
} backup;
|
|
|
|
|
|
|
|
enum {
|
|
|
|
HTTPSEND_NADA, /* init */
|
|
|
|
HTTPSEND_REQUEST, /* sending a request */
|
|
|
|
HTTPSEND_BODY, /* sending body */
|
|
|
|
HTTPSEND_LAST /* never use this */
|
|
|
|
} sending;
|
|
|
|
|
|
|
|
void *send_buffer; /* used if the request couldn't be sent in one chunk,
|
|
|
|
points to an allocated send_buffer struct */
|
|
|
|
};
|
|
|
|
|
2013-09-07 07:01:43 -04:00
|
|
|
struct http_conn {
|
|
|
|
#ifdef USE_NGHTTP2
|
|
|
|
nghttp2_session *h2;
|
2013-09-07 11:00:11 -04:00
|
|
|
#else
|
|
|
|
int unused; /* prevent a compiler warning */
|
2013-09-07 07:01:43 -04:00
|
|
|
#endif
|
|
|
|
};
|
|
|
|
|
2009-12-29 16:45:02 -05:00
|
|
|
CURLcode Curl_http_readwrite_headers(struct SessionHandle *data,
|
|
|
|
struct connectdata *conn,
|
|
|
|
ssize_t *nread,
|
|
|
|
bool *stop_reading);
|
|
|
|
|
2011-04-04 10:24:37 -04:00
|
|
|
/**
|
|
|
|
* Curl_http_output_auth() setups the authentication headers for the
|
|
|
|
* host/proxy and the correct authentication
|
|
|
|
* method. conn->data->state.authdone is set to TRUE when authentication is
|
|
|
|
* done.
|
|
|
|
*
|
|
|
|
* @param conn all information about the current connection
|
|
|
|
* @param request pointer to the request keyword
|
|
|
|
* @param path pointer to the requested path
|
|
|
|
* @param proxytunnel boolean if this is the request setting up a "proxy
|
|
|
|
* tunnel"
|
|
|
|
*
|
|
|
|
* @returns CURLcode
|
|
|
|
*/
|
|
|
|
CURLcode
|
|
|
|
Curl_http_output_auth(struct connectdata *conn,
|
|
|
|
const char *request,
|
|
|
|
const char *path,
|
|
|
|
bool proxytunnel); /* TRUE if this is the request setting
|
|
|
|
up the proxy tunnel */
|
|
|
|
|
2012-12-28 06:03:09 -05:00
|
|
|
#endif /* HEADER_CURL_HTTP_H */
|
|
|
|
|