group__apr__pools.html

apr函数库使用手册

<a class="anchor" name="ga26" doxytag="apr_pools.h::apr_pool_child_cleanup_set" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void apr_pool_child_cleanup_set           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>p</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap>const void *&nbsp;</td>
          <td class="mdname" nowrap> <em>data</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>(*&nbsp;</td>
          <td class="mdname" nowrap> <em>plain_cleanup</em>)(void *), </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>(*&nbsp;</td>
          <td class="mdname" nowrap> <em>child_cleanup</em>)(void *)</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Replace the child cleanup of a previously registered cleanup <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>p</em>&nbsp;</td><td>The pool of the registered cleanup </td></tr>
    <tr><td></td><td valign=top><em>data</em>&nbsp;</td><td>The data of the registered cleanup </td></tr>
    <tr><td></td><td valign=top><em>plain_cleanup</em>&nbsp;</td><td>The plain cleanup function of the registered cleanup </td></tr>
    <tr><td></td><td valign=top><em>child_cleanup</em>&nbsp;</td><td>The function to register as the child cleanup </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga29" doxytag="apr_pools.h::apr_pool_cleanup_for_exec" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void apr_pool_cleanup_for_exec           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Run all of the child_cleanups, so that any unnecessary files are closed because we are about to exec a new program     </td>
  </tr>
</table>
<a class="anchor" name="ga25" doxytag="apr_pools.h::apr_pool_cleanup_kill" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void apr_pool_cleanup_kill           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>p</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap>const void *&nbsp;</td>
          <td class="mdname" nowrap> <em>data</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>(*&nbsp;</td>
          <td class="mdname" nowrap> <em>cleanup</em>)(void *)</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Remove a previously registered cleanup function <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>p</em>&nbsp;</td><td>The pool remove the cleanup from </td></tr>
    <tr><td></td><td valign=top><em>data</em>&nbsp;</td><td>The data to remove from cleanup </td></tr>
    <tr><td></td><td valign=top><em>cleanup</em>&nbsp;</td><td>The function to remove from cleanup </td></tr>
  </table>
</dl>
<dl compact><dt><b>Remarks:</b></dt><dd>For some strange reason only the plain_cleanup is handled by this function </dd></dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga28" doxytag="apr_pools.h::apr_pool_cleanup_null" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="group__apr__errno.html#ga0">apr_status_t</a> apr_pool_cleanup_null           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">void *&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>data</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
An empty cleanup function <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>data</em>&nbsp;</td><td>The data to cleanup </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga24" doxytag="apr_pools.h::apr_pool_cleanup_register" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void apr_pool_cleanup_register           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>p</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap>const void *&nbsp;</td>
          <td class="mdname" nowrap> <em>data</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>(*&nbsp;</td>
          <td class="mdname" nowrap> <em>plain_cleanup</em>)(void *), </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>(*&nbsp;</td>
          <td class="mdname" nowrap> <em>child_cleanup</em>)(void *)</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Register a function to be called when a pool is cleared or destroyed <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>p</em>&nbsp;</td><td>The pool register the cleanup with </td></tr>
    <tr><td></td><td valign=top><em>data</em>&nbsp;</td><td>The data to pass to the cleanup function. </td></tr>
    <tr><td></td><td valign=top><em>plain_cleanup</em>&nbsp;</td><td>The function to call when the pool is cleared or destroyed </td></tr>
    <tr><td></td><td valign=top><em>child_cleanup</em>&nbsp;</td><td>The function to call when a child process is about to exec - this function is called in the child, obviously! </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga27" doxytag="apr_pools.h::apr_pool_cleanup_run" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> <a class="el" href="group__apr__errno.html#ga0">apr_status_t</a> apr_pool_cleanup_run           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *&nbsp;</td>
          <td class="mdname" nowrap> <em>p</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap>void *&nbsp;</td>
          <td class="mdname" nowrap> <em>data</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td></td>
          <td class="md" nowrap><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a>(*&nbsp;</td>
          <td class="mdname" nowrap> <em>cleanup</em>)(void *)</td>
        </tr>
        <tr>
          <td></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Run the specified cleanup function immediately and unregister it. Use <em>data</em> instead of the data that was registered with the cleanup. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td></td><td valign=top><em>p</em>&nbsp;</td><td>The pool remove the cleanup from </td></tr>
    <tr><td></td><td valign=top><em>data</em>&nbsp;</td><td>The data to remove from cleanup </td></tr>
    <tr><td></td><td valign=top><em>cleanup</em>&nbsp;</td><td>The function to remove from cleanup </td></tr>
  </table>
</dl>
    </td>
  </tr>
</table>
<a class="anchor" name="ga8" doxytag="apr_pools.h::apr_pool_clear" ></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"> void apr_pool_clear           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *&nbsp;</td>