http_connection.h revision 53509ebdb0660b47696e64b8214b73818d339553
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding/* ====================================================================
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * The Apache Software License, Version 1.1
bc8fd1b0b1afdf89b8d28eefa8cd74e26ba97986fielding * Copyright (c) 2000-2001 The Apache Software Foundation. All rights
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * reserved.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * Redistribution and use in source and binary forms, with or without
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * modification, are permitted provided that the following conditions
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * 1. Redistributions of source code must retain the above copyright
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * notice, this list of conditions and the following disclaimer.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * 2. Redistributions in binary form must reproduce the above copyright
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * notice, this list of conditions and the following disclaimer in
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * the documentation and/or other materials provided with the
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * distribution.
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * 3. The end-user documentation included with the redistribution,
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * if any, must include the following acknowledgment:
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * "This product includes software developed by the
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * Apache Software Foundation (http://www.apache.org/)."
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * Alternately, this acknowledgment may appear in the software itself,
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * if and wherever such third-party acknowledgments normally appear.
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * 4. The names "Apache" and "Apache Software Foundation" must
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * not be used to endorse or promote products derived from this
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * software without prior written permission. For written
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * permission, please contact apache@apache.org.
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * 5. Products derived from this software may not be called "Apache",
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * nor may "Apache" appear in their name, without prior written
64185f9824e42f21ca7b9ae6c004484215c031a7rbb * permission of the Apache Software Foundation.
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * SUCH DAMAGE.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * ====================================================================
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * This software consists of voluntary contributions made by many
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * individuals on behalf of the Apache Software Foundation. For more
7e79e8fd53348f9fc6e8009a4a2522425ab6f08ffielding * information on the Apache Software Foundation, please see
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fieldingextern "C" {
1b21d7b3d97def358b2e923655edeb16613a1c31gstein * @package Apache connection library
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * Create a new connection.
2d71630471d1c23f0137309e3c3957c633ecbfd6rbb * @param p Pool to allocate data structures out of
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @param server The server to create the connection for
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @param inout The socket to use for all communication with the client
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @param id ID of this connection; unique at any point in time.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @return new conn_rec, or NULL if the connection has already been reset
51af95bb51b5084e883bad250b2afa2838e9ceebfieldingAP_CORE_DECLARE(conn_rec *)ap_new_connection(apr_pool_t *p, server_rec *server,
7fae9cc4639013f3c04c085547256c68814aee8ftrawick * This is the protocol module driver. This calls all of the
7fae9cc4639013f3c04c085547256c68814aee8ftrawick * pre-connection and connection hooks for all protocol modules.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @param c The connection on which the request is read
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @deffunc void ap_process_connection(conn_rec *)
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fieldingAP_CORE_DECLARE(void) ap_process_connection(conn_rec *);
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding /* Hooks */
785be1b6298010956622771c870ab3cd8ca57a2faaron * This hook gives protocol modules an opportunity to set everything up
785be1b6298010956622771c870ab3cd8ca57a2faaron * before calling the protocol handler. All pre-connection hooks are
785be1b6298010956622771c870ab3cd8ca57a2faaron * run until one returns something other than ok or decline
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @param c The connection on which the request has been received.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @return OK or DECLINED
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * @deffunc int ap_run_pre_connection(conn_rec *c)
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding * This hook implements different protocols. After a connection has been
785be1b6298010956622771c870ab3cd8ca57a2faaron * established, the protocol module must read and serve the request. This
785be1b6298010956622771c870ab3cd8ca57a2faaron * function does that for each protocol module. The first protocol module
785be1b6298010956622771c870ab3cd8ca57a2faaron * to handle the request is the last module run.
785be1b6298010956622771c870ab3cd8ca57a2faaron * @param c The connection on which the request has been received.
785be1b6298010956622771c870ab3cd8ca57a2faaron * @return OK or DECLINED
785be1b6298010956622771c870ab3cd8ca57a2faaron * @deffunc int ap_run_process_connection(conn_rec *c)
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fieldingAP_DECLARE_HOOK(int,process_connection,(conn_rec *c))
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding#endif /* !APACHE_HTTP_REQUEST_H */