blob: f5dcbce30cacae011bc53072e18cf2ff67221347 [file] [log] [blame]
Willy Tarreaubaaee002006-06-26 02:48:02 +02001/*
Willy Tarreaub0c9bc42009-10-04 15:56:38 +02002 * include/proto/proto_http.h
3 * This file contains HTTP protocol definitions.
4 *
Willy Tarreauff011f22011-01-06 17:51:27 +01005 * Copyright (C) 2000-2011 Willy Tarreau - w@1wt.eu
Willy Tarreaub0c9bc42009-10-04 15:56:38 +02006 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation, version 2.1
10 * exclusively.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
Willy Tarreaubaaee002006-06-26 02:48:02 +020021
22#ifndef _PROTO_PROTO_HTTP_H
23#define _PROTO_PROTO_HTTP_H
24
Willy Tarreaue3ba5f02006-06-29 18:54:54 +020025#include <common/config.h>
Willy Tarreaubaaee002006-06-26 02:48:02 +020026#include <types/proto_http.h>
27#include <types/session.h>
28#include <types/task.h>
29
Willy Tarreau58f10d72006-12-04 02:26:12 +010030/*
31 * some macros used for the request parsing.
32 * from RFC2616:
33 * CTL = <any US-ASCII control character (octets 0 - 31) and DEL (127)>
Willy Tarreau8d5d7f22007-01-21 19:16:41 +010034 * SEP = one of the 17 defined separators or SP or HT
35 * LWS = CR, LF, SP or HT
36 * SPHT = SP or HT. Use this macro and not a boolean expression for best speed.
37 * CRLF = CR or LF. Use this macro and not a boolean expression for best speed.
38 * token = any CHAR except CTL or SEP. Use this macro and not a boolean expression for best speed.
Willy Tarreau4b89ad42007-03-04 18:13:58 +010039 *
40 * added for ease of use:
41 * ver_token = 'H', 'P', 'T', '/', '.', and digits.
Willy Tarreau58f10d72006-12-04 02:26:12 +010042 */
Willy Tarreau58f10d72006-12-04 02:26:12 +010043
Willy Tarreau8d5d7f22007-01-21 19:16:41 +010044extern const char http_is_ctl[256];
45extern const char http_is_sep[256];
46extern const char http_is_lws[256];
47extern const char http_is_spht[256];
48extern const char http_is_crlf[256];
49extern const char http_is_token[256];
Willy Tarreau4b89ad42007-03-04 18:13:58 +010050extern const char http_is_ver_token[256];
Willy Tarreau8d5d7f22007-01-21 19:16:41 +010051
Willy Tarreau436d9ed2011-05-11 16:10:11 +020052extern const int http_err_codes[HTTP_ERR_SIZE];
53extern struct chunk http_err_chunks[HTTP_ERR_SIZE];
54extern const char *HTTP_302;
55extern const char *HTTP_303;
56
Willy Tarreau8d5d7f22007-01-21 19:16:41 +010057#define HTTP_IS_CTL(x) (http_is_ctl[(unsigned char)(x)])
58#define HTTP_IS_SEP(x) (http_is_sep[(unsigned char)(x)])
59#define HTTP_IS_LWS(x) (http_is_lws[(unsigned char)(x)])
60#define HTTP_IS_SPHT(x) (http_is_spht[(unsigned char)(x)])
61#define HTTP_IS_CRLF(x) (http_is_crlf[(unsigned char)(x)])
62#define HTTP_IS_TOKEN(x) (http_is_token[(unsigned char)(x)])
Willy Tarreau4b89ad42007-03-04 18:13:58 +010063#define HTTP_IS_VER_TOKEN(x) (http_is_ver_token[(unsigned char)(x)])
Willy Tarreaubaaee002006-06-26 02:48:02 +020064
65int event_accept(int fd);
Willy Tarreaubaaee002006-06-26 02:48:02 +020066int process_cli(struct session *t);
Willy Tarreaufa7e1022008-10-19 07:30:41 +020067int process_srv_data(struct session *t);
68int process_srv_conn(struct session *t);
Willy Tarreau3a816292009-07-07 10:55:49 +020069int http_wait_for_request(struct session *s, struct buffer *req, int an_bit);
Willy Tarreau1d0dfb12009-07-07 15:10:31 +020070int http_process_req_common(struct session *s, struct buffer *req, int an_bit, struct proxy *px);
Willy Tarreau3a816292009-07-07 10:55:49 +020071int http_process_request(struct session *t, struct buffer *req, int an_bit);
72int http_process_tarpit(struct session *s, struct buffer *req, int an_bit);
73int http_process_request_body(struct session *s, struct buffer *req, int an_bit);
Willy Tarreaub37c27e2009-10-18 22:53:08 +020074int http_wait_for_response(struct session *s, struct buffer *rep, int an_bit);
75int http_process_res_common(struct session *t, struct buffer *rep, int an_bit, struct proxy *px);
Willy Tarreaud98cf932009-12-27 22:54:55 +010076int http_request_forward_body(struct session *s, struct buffer *req, int an_bit);
77int http_response_forward_body(struct session *s, struct buffer *res, int an_bit);
Willy Tarreaubaaee002006-06-26 02:48:02 +020078
Willy Tarreau58f10d72006-12-04 02:26:12 +010079void debug_hdr(const char *dir, struct session *t, const char *start, const char *end);
Willy Tarreau8d5d7f22007-01-21 19:16:41 +010080void get_srv_from_appsession(struct session *t, const char *begin, int len);
81int apply_filter_to_req_headers(struct session *t, struct buffer *req, struct hdr_exp *exp);
82int apply_filter_to_req_line(struct session *t, struct buffer *req, struct hdr_exp *exp);
Willy Tarreau6c123b12010-01-28 20:22:06 +010083int apply_filters_to_request(struct session *s, struct buffer *req, struct proxy *px);
Willy Tarreaufdb563c2010-01-31 15:43:27 +010084int apply_filters_to_response(struct session *t, struct buffer *rtr, struct proxy *px);
Cyril Bontéb21570a2009-11-29 20:04:48 +010085void manage_client_side_appsession(struct session *t, const char *buf, int len);
Willy Tarreau58f10d72006-12-04 02:26:12 +010086void manage_client_side_cookies(struct session *t, struct buffer *req);
Willy Tarreaua15645d2007-03-18 16:22:39 +010087void manage_server_side_cookies(struct session *t, struct buffer *rtr);
88void check_response_for_cacheability(struct session *t, struct buffer *rtr);
Willy Tarreau295a8372011-03-10 11:25:07 +010089int stats_check_uri(struct stream_interface *si, struct http_txn *txn, struct proxy *backend);
Willy Tarreau80587432006-12-24 17:47:20 +010090void init_proto_http();
matt.farnsworth@nokia.com1c2ab962008-04-14 20:47:37 +020091int http_find_header2(const char *name, int len,
Willy Tarreau68085d82010-01-18 14:54:04 +010092 char *sol, struct hdr_idx *idx,
matt.farnsworth@nokia.com1c2ab962008-04-14 20:47:37 +020093 struct hdr_ctx *ctx);
Willy Tarreau55a8d0e2008-11-30 18:47:21 +010094void http_sess_log(struct session *s);
95void perform_http_redirect(struct session *s, struct stream_interface *si);
Willy Tarreau0cac36f2008-11-30 20:44:17 +010096void http_return_srv_error(struct session *s, struct stream_interface *si);
Willy Tarreau4076a152009-04-02 15:18:36 +020097void http_capture_bad_message(struct error_snapshot *es, struct session *s,
98 struct buffer *buf, struct http_msg *msg,
Willy Tarreau078272e2010-12-12 12:46:33 +010099 int state, struct proxy *other_end);
Willy Tarreau294c4732011-12-16 21:35:50 +0100100unsigned int http_get_hdr(struct http_msg *msg, const char *hname, int hlen,
101 struct hdr_idx *idx, int occ,
102 struct hdr_ctx *ctx, char **vptr, int *vlen);
Willy Tarreaubaaee002006-06-26 02:48:02 +0200103
Willy Tarreau0937bc42009-12-22 15:03:09 +0100104void http_init_txn(struct session *s);
105void http_end_txn(struct session *s);
106void http_reset_txn(struct session *s);
107
Willy Tarreauff011f22011-01-06 17:51:27 +0100108struct http_req_rule *parse_http_req_cond(const char **args, const char *file, int linenum, struct proxy *proxy);
109void free_http_req_rules(struct list *r);
Willy Tarreau436d9ed2011-05-11 16:10:11 +0200110struct chunk *error_message(struct session *s, int msgnum);
Willy Tarreauff011f22011-01-06 17:51:27 +0100111
Willy Tarreaufa355d42009-11-29 18:12:29 +0100112/* to be used when contents change in an HTTP message */
113#define http_msg_move_end(msg, bytes) do { \
114 unsigned int _bytes = (bytes); \
115 (msg)->col += (_bytes); \
116 (msg)->sov += (_bytes); \
117 (msg)->eoh += (_bytes); \
118 } while (0)
119
Willy Tarreaubaaee002006-06-26 02:48:02 +0200120#endif /* _PROTO_PROTO_HTTP_H */
121
122/*
123 * Local variables:
124 * c-indent-level: 8
125 * c-basic-offset: 8
126 * End:
127 */