[Apache]

Package Name: Apache connection library

Global Functions

(void);
This function is responsible for the following cases:
we now proceed to read from the client until we get EOF, or until
MAX_SECS_TO_LINGER has passed.  the reasons for doing this are
documented in a draft:
http://www.ics.uci.edu/pub/ietf/http/draft-ietf-http-connection-00.txt
in a nutshell -- if we don't make this effort we risk causing
TCP RST packets to be sent which can tear down a connection before
all the response data has been sent to the client.

Parameters
cThe connection we are closing
(conn_rec *, create_connection, (apr_pool_t *p, server_rec *server, apr_socket_t *csd, long conn_id, void *sbh, apr_bucket_alloc_t *alloc));
create_connection is a RUN_FIRST hook which allows modules to create connections. In general, you should not install filters with the create_connection hook. If you require vhost configuration information to make filter installation decisions, you must use the pre_connection or install_network_transport hook. This hook should close the connection if it encounters a fatal error condition.

Parameters
pThe pool from which to allocate the connection record
csdThe socket that has been accepted
conn_idA unique identifier for this connection. The ID only needs to be unique at that time, not forever.
sbhA handle to scoreboard information for this connection.
Return Value
An allocated connection record or NULL.

apr_bucket*ap_bucket_eoc_make(apr_bucket *b);
Determine if a bucket is an End Of Connection (EOC) bucket Make the bucket passed in an End Of Connection (EOC) bucket

Parameters
eThe bucket to inspect
bThe bucket to make into an EOC bucket
Return Value
true or false The new bucket, or NULL if allocation failed

apr_bucket*ap_bucket_eoc_create(apr_bucket_alloc_t *list);
Create a bucket referring to an End Of Connection (EOC). This indicates that the connection will be closed.

Parameters
listThe freelist from which this bucket should be allocated
Return Value
The new bucket, or NULL if allocation failed

intap_run_pre_connection(conn_rec *c, void *csd);
This hook gives protocol modules an opportunity to set everything up before calling the protocol handler. All pre-connection hooks are run until one returns something other than ok or decline

Parameters
cThe connection on which the request has been received.
csdThe mechanism on which this connection is to be read. Most times this will be a socket, but it is up to the module that accepts the request to determine the exact type.
Return Value
OK or DECLINED

intap_run_process_connection(conn_rec *c);
This hook implements different protocols. After a connection has been established, the protocol module must read and serve the request. This function does that for each protocol module. The first protocol module to handle the request is the last module run.

Parameters
cThe connection on which the request has been received.
Return Value
OK or DECLINED

voidap_process_connection(conn_rec *c, void *csd);
This is the protocol module driver. This calls all of the pre-connection and connection hooks for all protocol modules.

Parameters
cThe connection on which the request is read
csdThe mechanism on which this connection is to be read. Most times this will be a socket, but it is up to the module that accepts the request to determine the exact type.

© 2000 [Apache Software Foundation]
Generated by ScanDoc 0.14
Last Updated: Fri Apr 14 12:43:20 2006