1 /* ====================================================================
2 * The Apache Software License, Version 1.1
4 * Copyright (c) 2000-2001 The Apache Software Foundation. All rights
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in
16 * the documentation and/or other materials provided with the
19 * 3. The end-user documentation included with the redistribution,
20 * if any, must include the following acknowledgment:
21 * "This product includes software developed by the
22 * Apache Software Foundation (http://www.apache.org/)."
23 * Alternately, this acknowledgment may appear in the software itself,
24 * if and wherever such third-party acknowledgments normally appear.
26 * 4. The names "Apache" and "Apache Software Foundation" must
27 * not be used to endorse or promote products derived from this
28 * software without prior written permission. For written
29 * permission, please contact apache@apache.org.
31 * 5. Products derived from this software may not be called "Apache",
32 * nor may "Apache" appear in their name, without prior written
33 * permission of the Apache Software Foundation.
35 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
36 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
37 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
38 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
39 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
41 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
42 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
43 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
44 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
45 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47 * ====================================================================
49 * This software consists of voluntary contributions made by many
50 * individuals on behalf of the Apache Software Foundation. For more
51 * information on the Apache Software Foundation, please see
52 * <http://www.apache.org/>.
54 * Portions of this software are based upon public domain software
55 * originally written at the National Center for Supercomputing Applications,
56 * University of Illinois, Urbana-Champaign.
59 #include "apr_strings.h"
60 #include "apr_thread_proc.h" /* for RLIMIT stuff */
62 #define APR_WANT_STRFUNC
67 #include "http_config.h"
68 #include "http_connection.h"
69 #include "http_protocol.h" /* For index_of_response(). Grump. */
70 #include "http_request.h"
72 #include "util_filter.h"
73 #include "util_ebcdic.h"
75 #include "scoreboard.h"
79 static const char *set_keep_alive_timeout(cmd_parms *cmd, void *dummy,
82 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
87 cmd->server->keep_alive_timeout = atoi(arg);
91 static const char *set_keep_alive(cmd_parms *cmd, void *dummy,
94 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
99 /* We've changed it to On/Off, but used to use numbers
100 * so we accept anything but "Off" or "0" as "On"
102 if (!strcasecmp(arg, "off") || !strcmp(arg, "0")) {
103 cmd->server->keep_alive = 0;
106 cmd->server->keep_alive = 1;
111 static const char *set_keep_alive_max(cmd_parms *cmd, void *dummy,
114 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
119 cmd->server->keep_alive_max = atoi(arg);
123 static const command_rec http_cmds[] = {
124 AP_INIT_TAKE1("KeepAliveTimeout", set_keep_alive_timeout, NULL, RSRC_CONF,
125 "Keep-Alive timeout duration (sec)"),
126 AP_INIT_TAKE1("MaxKeepAliveRequests", set_keep_alive_max, NULL, RSRC_CONF,
127 "Maximum number of Keep-Alive requests per connection, or 0 for infinite"),
128 AP_INIT_TAKE1("KeepAlive", set_keep_alive, NULL, RSRC_CONF,
129 "Whether persistent connections should be On or Off"),
134 * HTTP/1.1 chunked transfer encoding filter.
136 static apr_status_t chunk_filter(ap_filter_t *f, apr_bucket_brigade *b)
138 #define ASCII_CRLF "\015\012"
139 #define ASCII_ZERO "\060"
140 apr_bucket_brigade *more = NULL;
144 for (more = NULL; b; b = more, more = NULL) {
146 apr_bucket *eos = NULL;
147 apr_bucket *flush = NULL;
148 char chunk_hdr[20]; /* enough space for the snprintf below */
150 APR_BRIGADE_FOREACH(e, b) {
151 if (APR_BUCKET_IS_EOS(e)) {
152 /* there shouldn't be anything after the eos */
156 if (APR_BUCKET_IS_FLUSH(e)) {
159 else if (e->length == -1) {
160 /* unknown amount of data (e.g. a pipe) */
164 rv = apr_bucket_read(e, &data, &len, APR_BLOCK_READ);
165 if (rv != APR_SUCCESS) {
170 * There may be a new next bucket representing the
171 * rest of the data stream on which a read() may
172 * block so we pass down what we have so far.
175 more = apr_brigade_split(b, APR_BUCKET_NEXT(e));
179 /* If there was nothing in this bucket then we can
180 * safely move on to the next one without pausing
181 * to pass down what we have counted up so far.
192 * XXX: if there aren't very many bytes at this point it may
193 * be a good idea to set them aside and return for more,
194 * unless we haven't finished counting this brigade yet.
197 /* if there are content bytes, then wrap them in a chunk */
202 * Insert the chunk header, specifying the number of bytes in
205 /* XXX might be nice to have APR_OFF_T_FMT_HEX */
206 hdr_len = apr_snprintf(chunk_hdr, sizeof(chunk_hdr),
207 "%qx" CRLF, (apr_uint64_t)bytes);
208 ap_xlate_proto_to_ascii(chunk_hdr, hdr_len);
209 e = apr_bucket_transient_create(chunk_hdr, hdr_len);
210 APR_BRIGADE_INSERT_HEAD(b, e);
213 * Insert the end-of-chunk CRLF before an EOS or
214 * FLUSH bucket, or appended to the brigade
216 e = apr_bucket_immortal_create(ASCII_CRLF, 2);
218 APR_BUCKET_INSERT_BEFORE(eos, e);
220 else if (flush != NULL) {
221 APR_BUCKET_INSERT_BEFORE(flush, e);
224 APR_BRIGADE_INSERT_TAIL(b, e);
228 /* RFC 2616, Section 3.6.1
230 * If there is an EOS bucket, then prefix it with:
231 * 1) the last-chunk marker ("0" CRLF)
233 * 3) the end-of-chunked body CRLF
235 * If there is no EOS bucket, then do nothing.
237 * XXX: it would be nice to combine this with the end-of-chunk
238 * marker above, but this is a bit more straight-forward for
242 /* XXX: (2) trailers ... does not yet exist */
243 e = apr_bucket_immortal_create(ASCII_ZERO ASCII_CRLF /* <trailers> */ ASCII_CRLF, 5);
244 APR_BUCKET_INSERT_BEFORE(eos, e);
247 /* pass the brigade to the next filter. */
248 rv = ap_pass_brigade(f->next, b);
249 if (rv != APR_SUCCESS || eos != NULL) {
257 static const char *http_method(const request_rec *r)
260 static apr_port_t http_port(const request_rec *r)
261 { return DEFAULT_HTTP_PORT; }
263 static int ap_pre_http_connection(conn_rec *c)
265 ap_add_input_filter("HTTP_IN", NULL, NULL, c);
266 ap_add_input_filter("CORE_IN", NULL, NULL, c);
267 ap_add_output_filter("CORE", NULL, NULL, c);
271 static int ap_process_http_connection(conn_rec *c)
276 * Read and process each request found on our connection
277 * until no requests are left or we decide to close.
280 ap_update_child_status(AP_CHILD_THREAD_FROM_ID(c->id), SERVER_BUSY_READ, NULL);
281 while ((r = ap_read_request(c)) != NULL) {
283 /* process the request if it was read without error */
285 ap_update_child_status(AP_CHILD_THREAD_FROM_ID(c->id), SERVER_BUSY_WRITE, r);
286 if (r->status == HTTP_OK)
287 ap_process_request(r);
289 if (ap_extended_status)
290 ap_increment_counts(AP_CHILD_THREAD_FROM_ID(c->id), r);
292 if (!c->keepalive || c->aborted)
295 ap_update_child_status(AP_CHILD_THREAD_FROM_ID(c->id), SERVER_BUSY_KEEPALIVE, r);
296 apr_pool_destroy(r->pool);
298 if (ap_graceful_stop_signalled())
305 static void ap_http_insert_filter(request_rec *r)
308 ap_add_output_filter("BYTERANGE", NULL, r, r->connection);
309 ap_add_output_filter("CONTENT_LENGTH", NULL, r, r->connection);
310 ap_add_output_filter("HTTP_HEADER", NULL, r, r->connection);
314 static void register_hooks(apr_pool_t *p)
316 ap_hook_pre_connection(ap_pre_http_connection,NULL,NULL,
317 APR_HOOK_REALLY_LAST);
318 ap_hook_process_connection(ap_process_http_connection,NULL,NULL,
319 APR_HOOK_REALLY_LAST);
320 ap_hook_http_method(http_method,NULL,NULL,APR_HOOK_REALLY_LAST);
321 ap_hook_default_port(http_port,NULL,NULL,APR_HOOK_REALLY_LAST);
323 ap_hook_insert_filter(ap_http_insert_filter, NULL, NULL, APR_HOOK_REALLY_LAST);
324 ap_register_input_filter("HTTP_IN", ap_http_filter, AP_FTYPE_CONNECTION);
325 ap_register_input_filter("DECHUNK", ap_dechunk_filter, AP_FTYPE_TRANSCODE);
326 ap_register_output_filter("HTTP_HEADER", ap_http_header_filter,
327 AP_FTYPE_HTTP_HEADER);
328 ap_register_output_filter("CHUNK", chunk_filter, AP_FTYPE_TRANSCODE);
329 ap_register_output_filter("BYTERANGE", ap_byterange_filter,
330 AP_FTYPE_HTTP_HEADER);
333 AP_DECLARE_DATA module http_module = {
334 STANDARD20_MODULE_STUFF,
335 NULL, /* create per-directory config structure */
336 NULL, /* merge per-directory config structures */
337 NULL, /* create per-server config structure */
338 NULL, /* merge per-server config structures */
339 http_cmds, /* command apr_table_t */
340 register_hooks /* register hooks */