From: Stefan Fritsch <sf@apache.org>
Date: Sun, 12 Sep 2010 12:52:48 +0000 (+0000)
Subject: add comment about (not) using pools in error log format handlers
X-Git-Tag: 2.3.9~503
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fb36cd85853fcec5355960d40db101c650afd485;p=apache

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 affd42a6ad..9c8fa9e1b2 100644
--- 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);