svn commit: r746955 - /apr/apr/trunk/include/apr_pools.h

[jo...@apache.org]

Author: jorton
Date: Mon Feb 23 10:48:37 2009
New Revision: 746955

URL: http://svn.apache.org/viewvc?rev=746955&view=rev
Log:
* include/apr_pools.h (apr_pool_create_unmanaged_ex): ... is considered
  harmful; child cleanups don't work.

Modified:
    apr/apr/trunk/include/apr_pools.h

Modified: apr/apr/trunk/include/apr_pools.h
URL: http://svn.apache.org/viewvc/apr/apr/trunk/include/apr_pools.h?rev=746955&r1=746954&r2=746955&view=diff
==============================================================================
--- apr/apr/trunk/include/apr_pools.h (original)
+++ apr/apr/trunk/include/apr_pools.h Mon Feb 23 10:48:37 2009
@@ -207,6 +207,10 @@
  *         destroyed by calling apr_pool_destroy, to prevent memory leaks.
  *         Use of this function is discouraged, think twice about whether
  *         you really really need it.
+ * @warning Any child cleanups registered against the new pool, or
+ *         against sub-pools thereof, will not be executed during an
+ *         invocation of apr_proc_create(), so resources created in an
+ *         "unmanaged" pool heirarchy will leak to child processes.
  */
 APR_DECLARE(apr_status_t) apr_pool_create_unmanaged_ex(apr_pool_t **newpool,
                                                    apr_abortfunc_t abort_fn,