add comment about (not) using pools in error log format handlers

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

diff --git a/include/http_core.h b/include/http_core.h
index affd42a6ada3b99871e1786ee3f926107903c516..9c8fa9e1b256b8ffcf1cb9de20038d389aac633d 100644 (file)
--- a/include/http_core.h
+++ b/include/http_core.h
@@ -694,6 +694,10 @@ typedef struct ap_errorlog_info {
 
 /**
  * callback function prototype for a external errorlog handler
+ * @note To avoid unbounded memory usage, these functions must not allocate
+ * memory from the server, connection, or request pools. If an errorlog
+ * handler absolutely needs a pool to pass to other functions, it must create
+ * and destroy a sub-pool.
  */
 typedef int ap_errorlog_handler_fn_t(const ap_errorlog_info *info,
                                      const char *arg, char *buf, int buflen);