granicus.if.org Git - apache/blob - include/http_connection.h

   1 /* ====================================================================
   2  * The Apache Software License, Version 1.1
   3  *
   4  * Copyright (c) 2000-2001 The Apache Software Foundation.  All rights
   5  * reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  *
  11  * 1. Redistributions of source code must retain the above copyright
  12  *    notice, this list of conditions and the following disclaimer.
  13  *
  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
  17  *    distribution.
  18  *
  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.
  25  *
  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.
  30  *
  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.
  34  *
  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
  46  * SUCH DAMAGE.
  47  * ====================================================================
  48  *
  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/>.
  53  */
  54
  55 #ifndef APACHE_HTTP_CONNECTION_H
  56 #define APACHE_HTTP_CONNECTION_H
  57
  58 #include "apr_hooks.h"
  59 #include "apr_network_io.h"
  60
  61 #ifdef __cplusplus
  62 extern "C" {
  63 #endif
  64
  65 /**
  66  * @package Apache connection library
  67  */
  68
  69 #ifdef CORE_PRIVATE
  70 /**
  71  * Create a new connection.
  72  * @param p Pool to allocate data structures out of
  73  * @param server The server to create the connection for
  74  * @param inout The socket to use for all communication with the client
  75  * @param id ID of this connection; unique at any point in time.
  76  * @return new conn_rec, or NULL if the connection has already been reset
  77  */
  78 conn_rec *ap_new_connection(apr_pool_t *p, server_rec *server,
  79                             apr_socket_t *inout, long id);
  80
  81 /**
  82  * This is the protocol module driver.  This calls all of the
  83  * pre-connection and connection hooks for all protocol modules.
  84  * @param c The connection on which the request is read
  85  * @deffunc void ap_process_connection(conn_rec *)
  86  */
  87 AP_CORE_DECLARE(void) ap_process_connection(conn_rec *);
  88
  89 /**
  90  * The http pre-protocol handler.  This makes sets up Apache to serve http
  91  * requests
  92  * @param c The connection on which the request is read
  93  * @return OK or DECLINED
  94  */
  95 int ap_pre_http_connection(conn_rec *);
  96
  97 /**
  98  * The http protocol handler.  This makes Apache serve http requests
  99  * @param c The connection on which the request is read
 100  * @return OK or DECLINED
 101  */
 102 AP_CORE_DECLARE_NONSTD(int) ap_process_http_connection(conn_rec *);
 103
 104 AP_CORE_DECLARE(void) ap_flush_conn(conn_rec *c);
 105
 106 /**
 107  * This function is responsible for the following cases:
 108  * <PRE>
 109  * we now proceed to read from the client until we get EOF, or until
 110  * MAX_SECS_TO_LINGER has passed.  the reasons for doing this are
 111  * documented in a draft:
 112  *
 113  * http://www.ics.uci.edu/pub/ietf/http/draft-ietf-http-connection-00.txt
 114  *
 115  * in a nutshell -- if we don't make this effort we risk causing
 116  * TCP RST packets to be sent which can tear down a connection before
 117  * all the response data has been sent to the client.
 118  * </PRE>
 119  * @param c The connection we are closing
 120  */
 121 void ap_lingering_close(conn_rec *);
 122 #endif
 123
 124   /* Hooks */
 125 /**
 126  * This hook gives protocol modules an opportunity to set everything up
 127  * before calling the protocol handler.  All pre-connection hooks are
 128  * run until one returns something other than ok or decline
 129  * @param c The connection on which the request has been received.
 130  * @return OK or DECLINED
 131  * @deffunc int ap_run_pre_connection(conn_rec *c)
 132  */
 133 AP_DECLARE_HOOK(int,pre_connection,(conn_rec *c))
 134
 135 /**
 136  * This hook implements different protocols.  After a connection has been
 137  * established, the protocol module must read and serve the request.  This
 138  * function does that for each protocol module.  The first protocol module
 139  * to handle the request is the last module run.
 140  * @param c The connection on which the request has been received.
 141  * @return OK or DECLINED
 142  * @deffunc int ap_run_process_connection(conn_rec *c)
 143  */
 144 AP_DECLARE_HOOK(int,process_connection,(conn_rec *c))
 145
 146 #ifdef __cplusplus
 147 }
 148 #endif
 149
 150 #endif  /* !APACHE_HTTP_REQUEST_H */