2006-06-26 00:48:02 +00:00
|
|
|
/*
|
2009-10-04 13:56:38 +00:00
|
|
|
* include/proto/proto_http.h
|
|
|
|
* This file contains HTTP protocol definitions.
|
|
|
|
*
|
2011-01-06 16:51:27 +00:00
|
|
|
* Copyright (C) 2000-2011 Willy Tarreau - w@1wt.eu
|
2009-10-04 13:56:38 +00:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation, version 2.1
|
|
|
|
* exclusively.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
*/
|
2006-06-26 00:48:02 +00:00
|
|
|
|
|
|
|
#ifndef _PROTO_PROTO_HTTP_H
|
|
|
|
#define _PROTO_PROTO_HTTP_H
|
|
|
|
|
2006-06-29 16:54:54 +00:00
|
|
|
#include <common/config.h>
|
2006-06-26 00:48:02 +00:00
|
|
|
#include <types/proto_http.h>
|
|
|
|
#include <types/session.h>
|
|
|
|
#include <types/task.h>
|
|
|
|
|
2006-12-04 01:26:12 +00:00
|
|
|
/*
|
|
|
|
* some macros used for the request parsing.
|
|
|
|
* from RFC2616:
|
|
|
|
* CTL = <any US-ASCII control character (octets 0 - 31) and DEL (127)>
|
2007-01-21 18:16:41 +00:00
|
|
|
* SEP = one of the 17 defined separators or SP or HT
|
|
|
|
* LWS = CR, LF, SP or HT
|
|
|
|
* SPHT = SP or HT. Use this macro and not a boolean expression for best speed.
|
|
|
|
* CRLF = CR or LF. Use this macro and not a boolean expression for best speed.
|
|
|
|
* token = any CHAR except CTL or SEP. Use this macro and not a boolean expression for best speed.
|
2007-03-04 17:13:58 +00:00
|
|
|
*
|
|
|
|
* added for ease of use:
|
|
|
|
* ver_token = 'H', 'P', 'T', '/', '.', and digits.
|
2006-12-04 01:26:12 +00:00
|
|
|
*/
|
|
|
|
|
2007-01-21 18:16:41 +00:00
|
|
|
extern const char http_is_ctl[256];
|
|
|
|
extern const char http_is_sep[256];
|
|
|
|
extern const char http_is_lws[256];
|
|
|
|
extern const char http_is_spht[256];
|
|
|
|
extern const char http_is_crlf[256];
|
|
|
|
extern const char http_is_token[256];
|
2007-03-04 17:13:58 +00:00
|
|
|
extern const char http_is_ver_token[256];
|
2007-01-21 18:16:41 +00:00
|
|
|
|
2011-05-11 14:10:11 +00:00
|
|
|
extern const int http_err_codes[HTTP_ERR_SIZE];
|
|
|
|
extern struct chunk http_err_chunks[HTTP_ERR_SIZE];
|
|
|
|
extern const char *HTTP_302;
|
|
|
|
extern const char *HTTP_303;
|
|
|
|
|
2007-01-21 18:16:41 +00:00
|
|
|
#define HTTP_IS_CTL(x) (http_is_ctl[(unsigned char)(x)])
|
|
|
|
#define HTTP_IS_SEP(x) (http_is_sep[(unsigned char)(x)])
|
|
|
|
#define HTTP_IS_LWS(x) (http_is_lws[(unsigned char)(x)])
|
|
|
|
#define HTTP_IS_SPHT(x) (http_is_spht[(unsigned char)(x)])
|
|
|
|
#define HTTP_IS_CRLF(x) (http_is_crlf[(unsigned char)(x)])
|
|
|
|
#define HTTP_IS_TOKEN(x) (http_is_token[(unsigned char)(x)])
|
2007-03-04 17:13:58 +00:00
|
|
|
#define HTTP_IS_VER_TOKEN(x) (http_is_ver_token[(unsigned char)(x)])
|
2006-06-26 00:48:02 +00:00
|
|
|
|
|
|
|
int event_accept(int fd);
|
|
|
|
int process_cli(struct session *t);
|
[MAJOR] rework of the server FSM
srv_state has been removed from HTTP state machines, and states
have been split in either TCP states or analyzers. For instance,
the TARPIT state has just become a simple analyzer.
New flags have been added to the struct buffer to compensate this.
The high-level stream processors sometimes need to force a disconnection
without touching a file-descriptor (eg: report an error). But if
they touched BF_SHUTW or BF_SHUTR, the file descriptor would not
be closed. Thus, the two SHUT?_NOW flags have been added so that
an application can request a forced close which the stream interface
will be forced to obey.
During this change, a new BF_HIJACK flag was added. It will
be used for data generation, eg during a stats dump. It
prevents the producer on a buffer from sending data into it.
BF_SHUTR_NOW /* the producer must shut down for reads ASAP */
BF_SHUTW_NOW /* the consumer must shut down for writes ASAP */
BF_HIJACK /* the producer is temporarily replaced */
BF_SHUTW_NOW has precedence over BF_HIJACK. BF_HIJACK has
precedence over BF_MAY_FORWARD (so that it does not need it).
New functions buffer_shutr_now(), buffer_shutw_now(), buffer_abort()
are provided to manipulate BF_SHUT* flags.
A new type "stream_interface" has been added to describe both
sides of a buffer. A stream interface has states and error
reporting. The session now has two stream interfaces (one per
side). Each buffer has stream_interface pointers to both
consumer and producer sides.
The server-side file descriptor has moved to its stream interface,
so that even the buffer has access to it.
process_srv() has been split into three parts :
- tcp_get_connection() obtains a connection to the server
- tcp_connection_failed() tests if a previously attempted
connection has succeeded or not.
- process_srv_data() only manages the data phase, and in
this sense should be roughly equivalent to process_cli.
Little code has been removed, and a lot of old code has been
left in comments for now.
2008-10-19 05:30:41 +00:00
|
|
|
int process_srv_data(struct session *t);
|
|
|
|
int process_srv_conn(struct session *t);
|
2009-07-07 08:55:49 +00:00
|
|
|
int http_wait_for_request(struct session *s, struct buffer *req, int an_bit);
|
2009-07-07 13:10:31 +00:00
|
|
|
int http_process_req_common(struct session *s, struct buffer *req, int an_bit, struct proxy *px);
|
2009-07-07 08:55:49 +00:00
|
|
|
int http_process_request(struct session *t, struct buffer *req, int an_bit);
|
|
|
|
int http_process_tarpit(struct session *s, struct buffer *req, int an_bit);
|
|
|
|
int http_process_request_body(struct session *s, struct buffer *req, int an_bit);
|
2012-01-04 18:02:01 +00:00
|
|
|
int http_send_name_header(struct http_txn *txn, struct http_msg *msg, struct buffer *buf, struct proxy* be, const char* svr_name);
|
2009-10-18 20:53:08 +00:00
|
|
|
int http_wait_for_response(struct session *s, struct buffer *rep, int an_bit);
|
|
|
|
int http_process_res_common(struct session *t, struct buffer *rep, int an_bit, struct proxy *px);
|
2009-12-27 21:54:55 +00:00
|
|
|
int http_request_forward_body(struct session *s, struct buffer *req, int an_bit);
|
|
|
|
int http_response_forward_body(struct session *s, struct buffer *res, int an_bit);
|
2006-06-26 00:48:02 +00:00
|
|
|
|
2006-12-04 01:26:12 +00:00
|
|
|
void debug_hdr(const char *dir, struct session *t, const char *start, const char *end);
|
2007-01-21 18:16:41 +00:00
|
|
|
void get_srv_from_appsession(struct session *t, const char *begin, int len);
|
|
|
|
int apply_filter_to_req_headers(struct session *t, struct buffer *req, struct hdr_exp *exp);
|
|
|
|
int apply_filter_to_req_line(struct session *t, struct buffer *req, struct hdr_exp *exp);
|
2010-01-28 19:22:06 +00:00
|
|
|
int apply_filters_to_request(struct session *s, struct buffer *req, struct proxy *px);
|
2010-01-31 14:43:27 +00:00
|
|
|
int apply_filters_to_response(struct session *t, struct buffer *rtr, struct proxy *px);
|
2009-11-29 19:04:48 +00:00
|
|
|
void manage_client_side_appsession(struct session *t, const char *buf, int len);
|
2006-12-04 01:26:12 +00:00
|
|
|
void manage_client_side_cookies(struct session *t, struct buffer *req);
|
2007-03-18 15:22:39 +00:00
|
|
|
void manage_server_side_cookies(struct session *t, struct buffer *rtr);
|
|
|
|
void check_response_for_cacheability(struct session *t, struct buffer *rtr);
|
2011-03-10 10:25:07 +00:00
|
|
|
int stats_check_uri(struct stream_interface *si, struct http_txn *txn, struct proxy *backend);
|
2006-12-24 16:47:20 +00:00
|
|
|
void init_proto_http();
|
2008-04-14 18:47:37 +00:00
|
|
|
int http_find_header2(const char *name, int len,
|
2010-01-18 13:54:04 +00:00
|
|
|
char *sol, struct hdr_idx *idx,
|
2008-04-14 18:47:37 +00:00
|
|
|
struct hdr_ctx *ctx);
|
2008-11-30 17:47:21 +00:00
|
|
|
void http_sess_log(struct session *s);
|
|
|
|
void perform_http_redirect(struct session *s, struct stream_interface *si);
|
2008-11-30 19:44:17 +00:00
|
|
|
void http_return_srv_error(struct session *s, struct stream_interface *si);
|
2009-04-02 13:18:36 +00:00
|
|
|
void http_capture_bad_message(struct error_snapshot *es, struct session *s,
|
|
|
|
struct buffer *buf, struct http_msg *msg,
|
2010-12-12 11:46:33 +00:00
|
|
|
int state, struct proxy *other_end);
|
2011-12-16 20:35:50 +00:00
|
|
|
unsigned int http_get_hdr(struct http_msg *msg, const char *hname, int hlen,
|
|
|
|
struct hdr_idx *idx, int occ,
|
|
|
|
struct hdr_ctx *ctx, char **vptr, int *vlen);
|
2006-06-26 00:48:02 +00:00
|
|
|
|
2009-12-22 14:03:09 +00:00
|
|
|
void http_init_txn(struct session *s);
|
|
|
|
void http_end_txn(struct session *s);
|
|
|
|
void http_reset_txn(struct session *s);
|
|
|
|
|
2011-01-06 16:51:27 +00:00
|
|
|
struct http_req_rule *parse_http_req_cond(const char **args, const char *file, int linenum, struct proxy *proxy);
|
|
|
|
void free_http_req_rules(struct list *r);
|
2011-05-11 14:10:11 +00:00
|
|
|
struct chunk *error_message(struct session *s, int msgnum);
|
2011-01-06 16:51:27 +00:00
|
|
|
|
2009-11-29 17:12:29 +00:00
|
|
|
/* to be used when contents change in an HTTP message */
|
|
|
|
#define http_msg_move_end(msg, bytes) do { \
|
|
|
|
unsigned int _bytes = (bytes); \
|
|
|
|
(msg)->col += (_bytes); \
|
|
|
|
(msg)->sov += (_bytes); \
|
|
|
|
(msg)->eoh += (_bytes); \
|
|
|
|
} while (0)
|
|
|
|
|
2006-06-26 00:48:02 +00:00
|
|
|
#endif /* _PROTO_PROTO_HTTP_H */
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Local variables:
|
|
|
|
* c-indent-level: 8
|
|
|
|
* c-basic-offset: 8
|
|
|
|
* End:
|
|
|
|
*/
|