summaryrefslogtreecommitdiff
path: root/include
diff options
context:
space:
mode:
authorRich Bowen <rbowen@apache.org>2022-02-23 14:38:20 +0000
committerRich Bowen <rbowen@apache.org>2022-02-23 14:38:20 +0000
commit669bdbb45bff9f9b85408d869296b00ed14e5b1e (patch)
tree285bb2699c89c57a6ce7fcfad2a379f16a8c9954 /include
parent6c7a308b2000c1c2eebf4288f21269451bc5881e (diff)
downloadhttpd-669bdbb45bff9f9b85408d869296b00ed14e5b1e.tar.gz
Resolves BZ65861 - clarify post_config api doc
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1898347 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'include')
-rw-r--r--include/http_config.h10
1 files changed, 10 insertions, 0 deletions
diff --git a/include/http_config.h b/include/http_config.h
index 2aac6d4325..39fe72aff8 100644
--- a/include/http_config.h
+++ b/include/http_config.h
@@ -1350,6 +1350,16 @@ AP_DECLARE_HOOK(void,test_config,(apr_pool_t *pconf, server_rec *s))
/**
* Run the post_config function for each module
+ *
+ * The function might be called multiple times. @a pconf, @a plog, and
+ * @a ptemp may be cleared and/or destroyed between calls.
+ *
+ * The function will be called zero or one times with the server's state being
+ * #AP_SQ_MS_CREATE_PRE_CONFIG, and will be called one or more times with
+ * the server's state being #AP_SQ_MS_CREATE_CONFIG.
+ *
+ * @see ap_state_query(), #AP_SQ_MAIN_STATE
+ *
* @param pconf The config pool
* @param plog The logging streams pool
* @param ptemp The temporary pool