From: Ryan Bloom <rbb@apache.org>
Date: Tue, 13 Nov 2001 04:01:28 +0000 (+0000)
Subject: Add docs for the newest hook.
X-Git-Tag: 2.0.29~164
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=61ebbf74e34d56fbcc52a76bc32d5a9bec0012bf;p=thirdparty%2Fapache%2Fhttpd.git

Add docs for the newest hook.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@91892 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/include/http_connection.h b/include/http_connection.h
index 8b497d53fa6..3a619637714 100644
--- a/include/http_connection.h
+++ b/include/http_connection.h
@@ -129,9 +129,19 @@ AP_DECLARE_HOOK(int,pre_connection,(conn_rec *c))
 AP_DECLARE_HOOK(int,process_connection,(conn_rec *c))
 
 /**
+ * This hook allows modules to create connections. After the connection
+ * has been accepted, the socket is passed to this function to actually
+ * insert all filters that operate on the network, and create the connection
+ * record. The first module to create a connection is the last module
+ * run
+ * @param p The pool from which to allocate the connection record
+ * @param csd The socket that has been accepted
+ * @param conn_id A unique identifier for this connection.  The ID only
+ *                needs to be unique at that time, not forever.
+ * @return An allocated connection record or NULL.
  */
 AP_DECLARE_HOOK(conn_rec *, create_connection,
-                (apr_pool_t *p, apr_socket_t *csd, int conn_ed))
+                (apr_pool_t *p, apr_socket_t *csd, int conn_id))
 
 #ifdef __cplusplus
 }