1 /* ====================================================================
2 * The Apache Software License, Version 1.1
4 * Copyright (c) 2000 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_network_io.h"
62 #include "ap_config.h"
64 #include "http_config.h"
65 #include "ap_listen.h"
72 ap_listen_rec *ap_listeners;
73 static ap_listen_rec *old_listeners;
74 static int ap_listenbacklog;
75 static int send_buffer_size;
77 /* TODO: make_sock is just begging and screaming for APR abstraction */
78 static ap_status_t make_sock(ap_pool_t *p, ap_listen_rec *server)
80 ap_socket_t *s = server->sd;
87 ap_get_local_port(&port,s);
88 ap_get_local_ipaddr(&ipaddr,s);
89 ap_snprintf(addr, sizeof(addr), "address %s port %u", ipaddr,
92 stat = ap_setsocketopt(s, APR_SO_REUSEADDR, one);
93 if (stat != APR_SUCCESS && stat != APR_ENOTIMPL) {
94 ap_log_error(APLOG_MARK, APLOG_CRIT, stat, NULL,
95 "make_sock: for %s, setsockopt: (SO_REUSEADDR)", addr);
100 stat = ap_setsocketopt(s, APR_SO_KEEPALIVE, one);
101 if (stat != APR_SUCCESS && stat != APR_ENOTIMPL) {
102 ap_log_error(APLOG_MARK, APLOG_CRIT, stat, NULL,
103 "make_sock: for %s, setsockopt: (SO_KEEPALIVE)", addr);
109 * To send data over high bandwidth-delay connections at full
110 * speed we must force the TCP window to open wide enough to keep the
111 * pipe full. The default window size on many systems
112 * is only 4kB. Cross-country WAN connections of 100ms
113 * at 1Mb/s are not impossible for well connected sites.
114 * If we assume 100ms cross-country latency,
115 * a 4kB buffer limits throughput to 40kB/s.
117 * To avoid this problem I've added the SendBufferSize directive
118 * to allow the web master to configure send buffer size.
120 * The trade-off of larger buffers is that more kernel memory
121 * is consumed. YMMV, know your customers and your network!
123 * -John Heidemann <johnh@isi.edu> 25-Oct-96
125 * If no size is specified, use the kernel default.
127 if (send_buffer_size) {
128 stat = ap_setsocketopt(s, APR_SO_SNDBUF, send_buffer_size);
129 if (stat != APR_SUCCESS && stat != APR_ENOTIMPL) {
130 ap_log_error(APLOG_MARK, APLOG_WARNING, stat, NULL,
131 "make_sock: failed to set SendBufferSize for %s, "
132 "using default", addr);
133 /* not a fatal error */
137 if ((stat = ap_bind(s)) != APR_SUCCESS) {
138 ap_log_error(APLOG_MARK, APLOG_CRIT, stat, NULL,
139 "make_sock: could not bind to %s", addr);
144 if ((stat = ap_listen(s, ap_listenbacklog)) != APR_SUCCESS) {
145 ap_log_error(APLOG_MARK, APLOG_ERR, stat, NULL,
146 "make_sock: unable to listen for connections on %s", addr);
157 static ap_status_t close_listeners_on_exec(void *v)
161 for (lr = ap_listeners; lr; lr = lr->next) {
162 ap_close_socket(lr->sd);
169 static void alloc_listener(process_rec *process, char *addr, unsigned int port)
171 ap_listen_rec **walk;
175 unsigned int oldport;
177 /* see if we've got an old listener for this address:port */
178 for (walk = &old_listeners; *walk; walk = &(*walk)->next) {
179 ap_get_local_port(&oldport, (*walk)->sd);
180 ap_get_local_ipaddr(&oldaddr,(*walk)->sd);
181 if (!strcmp(oldaddr, addr) && port == oldport) {
182 /* re-use existing record */
185 new->next = ap_listeners;
191 /* this has to survive restarts */
192 new = ap_palloc(process->pool, sizeof(ap_listen_rec));
194 if ((status = ap_create_tcp_socket(&new->sd, process->pool)) != APR_SUCCESS) {
195 ap_log_error(APLOG_MARK, APLOG_CRIT, status, NULL,
196 "make_sock: failed to get a socket for %s", addr);
199 ap_set_local_port(new->sd, port);
200 ap_set_local_ipaddr(new->sd, addr);
201 new->next = ap_listeners;
205 #if !defined(WIN32) && !defined(PREFORK_MPM) && !defined(SPMT_OS2_MPM)
208 int ap_listen_open(process_rec *process, unsigned port)
210 ap_pool_t *pconf = process->pconf;
215 /* allocate a default listener if necessary */
216 if (ap_listeners == NULL) {
217 alloc_listener(process, APR_ANYADDR, port ? port : DEFAULT_HTTP_PORT);
221 for (lr = ap_listeners; lr; lr = lr->next) {
226 if (make_sock(pconf, lr) == APR_SUCCESS) {
233 /* close the old listeners */
234 for (lr = old_listeners; lr; lr = next) {
235 ap_close_socket(lr->sd);
240 old_listeners = NULL;
242 ap_register_cleanup(pconf, NULL, ap_null_cleanup, close_listeners_on_exec);
244 return num_open ? 0 : -1;
247 #if !defined(WIN32) && !defined(PREFORK_MPM)
248 int ap_setup_listeners(server_rec *s)
251 int num_listeners = 0;
252 if (ap_listen_open(s->process, s->port)) {
255 for (lr = ap_listeners; lr; lr = lr->next) {
258 return num_listeners;
262 void ap_listen_pre_config(void)
264 old_listeners = ap_listeners;
266 ap_listenbacklog = DEFAULT_LISTENBACKLOG;
270 const char *ap_set_listener(cmd_parms *cmd, void *dummy, const char *ips_)
272 char *ips=ap_pstrdup(cmd->pool, ips_);
276 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
281 ports = strchr(ips, ':');
284 return "Missing IP address";
286 else if (ports[1] == '\0') {
287 return "Address must end in :<port-number>";
297 return "Port must be numeric";
300 if (ports == ips) { /* no address */
301 alloc_listener(cmd->server->process, APR_ANYADDR, port);
304 ips[(ports - ips) - 1] = '\0';
305 alloc_listener(cmd->server->process, ips, port);
311 const char *ap_set_listenbacklog(cmd_parms *cmd, void *dummy, const char *arg)
315 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
322 return "ListenBacklog must be > 0";
324 ap_listenbacklog = b;
328 const char *ap_set_send_buffer_size(cmd_parms *cmd, void *dummy, const char *arg)
331 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
336 if (s < 512 && s != 0) {
337 return "SendBufferSize must be >= 512 bytes, or 0 for system default.";
339 send_buffer_size = s;