| Server IP : 20.75.53.88 / Your IP : 216.73.217.72 [ Web Server : Apache System : Linux VMRALP-3 4.4.0-256-generic #290~14.04.1-Ubuntu SMP Thu Jun 20 09:24:50 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 5.5.9-1ubuntu4.29+esm15 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority, Domains : 3 Domains MySQL : ON | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /proc/self/root/usr/share/doc/libaprutil1-dev/html/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.6"/>
<title>Apache Portable Runtime Utility Library: Hook Functions</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Apache Portable Runtime Utility Library
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(11)"><span class="SelectionMark"> </span>Pages</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#groups">Modules</a> |
<a href="#define-members">Macros</a> |
<a href="#func-members">Functions</a> |
<a href="#var-members">Variables</a> </div>
<div class="headertitle">
<div class="title">Hook Functions<div class="ingroups"><a class="el" href="group___a_p_r___util.html">APR Utility Functions</a></div></div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="groups"></a>
Modules</h2></td></tr>
<tr class="memitem:group__apr__hook__probes"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hook__probes.html">Hook probe capability</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:group___a_p_r___util___o_p_t___h_o_o_k"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___o_p_t___h_o_o_k.html">Optional Hook Functions</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ga832a6d3b73a43b3f7c58c5702ddccce9"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga832a6d3b73a43b3f7c58c5702ddccce9">APR_IMPLEMENT_HOOK_GET_PROTO</a>(ns, link, name)   link##_DECLARE(apr_array_header_t *) ns##_hook_get_##name(void)</td></tr>
<tr class="separator:ga832a6d3b73a43b3f7c58c5702ddccce9"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga69298243d3c4ffb4627fd3d04b522f44"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga69298243d3c4ffb4627fd3d04b522f44">APR_DECLARE_EXTERNAL_HOOK</a>(ns, link, ret, name, args)</td></tr>
<tr class="separator:ga69298243d3c4ffb4627fd3d04b522f44"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa936f5a0d1164d301aa157de6023fae5"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gaa936f5a0d1164d301aa157de6023fae5">APR_HOOK_STRUCT</a>(members)   static struct { members } _hooks;</td></tr>
<tr class="separator:gaa936f5a0d1164d301aa157de6023fae5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5699f73166bae88b6f6ac0bf7618b0f6"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga5699f73166bae88b6f6ac0bf7618b0f6">APR_HOOK_LINK</a>(name)   apr_array_header_t *link_##name;</td></tr>
<tr class="separator:ga5699f73166bae88b6f6ac0bf7618b0f6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2500abadaa54b3a9d6ec25ff33a6b0cc"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a>(ns, link, name)</td></tr>
<tr class="separator:ga2500abadaa54b3a9d6ec25ff33a6b0cc"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga2d11a43b6431ec568cc1647da4a2079c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga2d11a43b6431ec568cc1647da4a2079c">APR_IMPLEMENT_EXTERNAL_HOOK_VOID</a>(ns, link, name, args_decl, args_use)</td></tr>
<tr class="separator:ga2d11a43b6431ec568cc1647da4a2079c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab466280bdabe0cc2ee5880cbb512fa3d"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gab466280bdabe0cc2ee5880cbb512fa3d">APR_IMPLEMENT_EXTERNAL_HOOK_RUN_ALL</a>(ns, link, ret, name, args_decl, args_use, ok, decline)</td></tr>
<tr class="separator:gab466280bdabe0cc2ee5880cbb512fa3d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0420a2aa9ca6b3c1638bdb76025ecc57"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga0420a2aa9ca6b3c1638bdb76025ecc57">APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST</a>(ns, link, ret, name, args_decl, args_use, decline)</td></tr>
<tr class="separator:ga0420a2aa9ca6b3c1638bdb76025ecc57"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab004dcbfff32997deb15040e48f07e92"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gab004dcbfff32997deb15040e48f07e92">APR_HOOK_REALLY_FIRST</a>   (-10)</td></tr>
<tr class="separator:gab004dcbfff32997deb15040e48f07e92"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga564dea4803813674cb6b742f65a3d2b2"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga564dea4803813674cb6b742f65a3d2b2">APR_HOOK_FIRST</a>   0</td></tr>
<tr class="separator:ga564dea4803813674cb6b742f65a3d2b2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab9a5d50c3478c4d640deccec6b0ce879"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gab9a5d50c3478c4d640deccec6b0ce879">APR_HOOK_MIDDLE</a>   10</td></tr>
<tr class="separator:gab9a5d50c3478c4d640deccec6b0ce879"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa610a95f03d7b4aee922c28b0919f028"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gaa610a95f03d7b4aee922c28b0919f028">APR_HOOK_LAST</a>   20</td></tr>
<tr class="separator:gaa610a95f03d7b4aee922c28b0919f028"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae3c7d2cf35e8c89828dfff7a85b0ed77"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#gae3c7d2cf35e8c89828dfff7a85b0ed77">APR_HOOK_REALLY_LAST</a>   30</td></tr>
<tr class="separator:gae3c7d2cf35e8c89828dfff7a85b0ed77"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga04843fe00dc3c08c23130fef3ba1260c"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga04843fe00dc3c08c23130fef3ba1260c">apr_hook_sort_register</a> (const char *szHookName, apr_array_header_t **aHooks)</td></tr>
<tr class="separator:ga04843fe00dc3c08c23130fef3ba1260c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1e0b6cf91dac5417c1b9cbd1b46b8991"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga1e0b6cf91dac5417c1b9cbd1b46b8991">apr_hook_sort_all</a> (void)</td></tr>
<tr class="separator:ga1e0b6cf91dac5417c1b9cbd1b46b8991"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1de31557683f53c2a07f73990962c585"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga1de31557683f53c2a07f73990962c585">apr_hook_debug_show</a> (const char *szName, const char *const *aszPre, const char *const *aszSucc)</td></tr>
<tr class="separator:ga1de31557683f53c2a07f73990962c585"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5d20451da75574c8433feb1bd5b2ce10"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga5d20451da75574c8433feb1bd5b2ce10">apr_hook_deregister_all</a> (void)</td></tr>
<tr class="separator:ga5d20451da75574c8433feb1bd5b2ce10"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="var-members"></a>
Variables</h2></td></tr>
<tr class="memitem:ga8911bb699a5f03ad3c36d579ca0eca23"><td class="memItemLeft" align="right" valign="top">apr_pool_t * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga8911bb699a5f03ad3c36d579ca0eca23">apr_hook_global_pool</a></td></tr>
<tr class="separator:ga8911bb699a5f03ad3c36d579ca0eca23"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga59309caeb9b47d921727530494f264be"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga59309caeb9b47d921727530494f264be">apr_hook_debug_enabled</a></td></tr>
<tr class="separator:ga59309caeb9b47d921727530494f264be"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga37be3c217439ceddbda16054b020a658"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___hook.html#ga37be3c217439ceddbda16054b020a658">apr_hook_debug_current</a></td></tr>
<tr class="separator:ga37be3c217439ceddbda16054b020a658"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="ga69298243d3c4ffb4627fd3d04b522f44"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_DECLARE_EXTERNAL_HOOK</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ns, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">link, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">ret, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">name, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"><span class="keyword">typedef</span> ret ns##_HOOK_##name##_t args; \</div>
<div class="line">link##_DECLARE(<span class="keywordtype">void</span>) ns<span class="preprocessor">##_hook_##name(ns##_HOOK_##name##_t *pf, \</span></div>
<div class="line"><span class="preprocessor"> const char * const *aszPre, \</span></div>
<div class="line"><span class="preprocessor"> const char * const *aszSucc, int nOrder); \</span></div>
<div class="line"><span class="preprocessor">link##_DECLARE(ret) ns##_run_##name args; \</span></div>
<div class="line"><span class="preprocessor">APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name); \</span></div>
<div class="line"><span class="preprocessor">typedef struct ns##_LINK_##name##_t \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> ns##_HOOK_##name##_t *pFunc; \</span></div>
<div class="line"><span class="preprocessor"> const char *szName; \</span></div>
<div class="line"><span class="preprocessor"> const char * const *aszPredecessors; \</span></div>
<div class="line"><span class="preprocessor"> const char * const *aszSuccessors; \</span></div>
<div class="line"><span class="preprocessor"> int nOrder; \</span></div>
<div class="line"><span class="preprocessor"> } ns##_LINK_##name##_t;</span></div>
</div><!-- fragment --><p>macro to declare the hook correctly </p>
</div>
</div>
<a class="anchor" id="ga564dea4803813674cb6b742f65a3d2b2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_FIRST   0</td>
</tr>
</table>
</div><div class="memdoc">
<p>run this hook first </p>
</div>
</div>
<a class="anchor" id="gaa610a95f03d7b4aee922c28b0919f028"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_LAST   20</td>
</tr>
</table>
</div><div class="memdoc">
<p>run this hook after every other hook which is defined </p>
</div>
</div>
<a class="anchor" id="ga5699f73166bae88b6f6ac0bf7618b0f6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_LINK</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">name</td><td>)</td>
<td>   apr_array_header_t *link_##name;</td>
</tr>
</table>
</div><div class="memdoc">
<p>macro to link the hook structure </p>
</div>
</div>
<a class="anchor" id="gab9a5d50c3478c4d640deccec6b0ce879"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_MIDDLE   10</td>
</tr>
</table>
</div><div class="memdoc">
<p>run this hook somewhere </p>
</div>
</div>
<a class="anchor" id="gab004dcbfff32997deb15040e48f07e92"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_REALLY_FIRST   (-10)</td>
</tr>
</table>
</div><div class="memdoc">
<p>run this hook first, before ANYTHING </p>
</div>
</div>
<a class="anchor" id="gae3c7d2cf35e8c89828dfff7a85b0ed77"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_REALLY_LAST   30</td>
</tr>
</table>
</div><div class="memdoc">
<p>run this hook last, after EVERYTHING </p>
</div>
</div>
<a class="anchor" id="gaa936f5a0d1164d301aa157de6023fae5"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HOOK_STRUCT</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">members</td><td>)</td>
<td>   static struct { members } _hooks;</td>
</tr>
</table>
</div><div class="memdoc">
<p>macro to declare the hook structure </p>
</div>
</div>
<a class="anchor" id="ga2500abadaa54b3a9d6ec25ff33a6b0cc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_IMPLEMENT_EXTERNAL_HOOK_BASE</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ns, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">link, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">name </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line">link##_DECLARE(<span class="keywordtype">void</span>) ns<span class="preprocessor">##_hook_##name(ns##_HOOK_##name##_t *pf,const char * const *aszPre, \</span></div>
<div class="line"><span class="preprocessor"> const char * const *aszSucc,int nOrder) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> ns##_LINK_##name##_t *pHook; \</span></div>
<div class="line"><span class="preprocessor"> if(!_hooks.link_##name) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> _hooks.link_##name=apr_array_make(apr_hook_global_pool,1,sizeof(ns##_LINK_##name##_t)); \</span></div>
<div class="line"><span class="preprocessor"> apr_hook_sort_register(#name,&_hooks.link_##name); \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor"> pHook=apr_array_push(_hooks.link_##name); \</span></div>
<div class="line"><span class="preprocessor"> pHook->pFunc=pf; \</span></div>
<div class="line"><span class="preprocessor"> pHook->aszPredecessors=aszPre; \</span></div>
<div class="line"><span class="preprocessor"> pHook->aszSuccessors=aszSucc; \</span></div>
<div class="line"><span class="preprocessor"> pHook->nOrder=nOrder; \</span></div>
<div class="line"><span class="preprocessor"> pHook->szName=apr_hook_debug_current; \</span></div>
<div class="line"><span class="preprocessor"> if(apr_hook_debug_enabled) \</span></div>
<div class="line"><span class="preprocessor"> apr_hook_debug_show(#name,aszPre,aszSucc); \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor"> APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> return _hooks.link_##name; \</span></div>
<div class="line"><span class="preprocessor"> }</span></div>
</div><!-- fragment --><p>macro to implement the hook </p>
</div>
</div>
<a class="anchor" id="gab466280bdabe0cc2ee5880cbb512fa3d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_IMPLEMENT_EXTERNAL_HOOK_RUN_ALL</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ns, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">link, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">ret, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">name, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args_decl, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args_use, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">ok, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">decline </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"><a class="code" href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a>(ns,link,name) \</div>
<div class="line">link##_DECLARE(ret) ns<span class="preprocessor">##_run_##name args_decl \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> ns##_LINK_##name##_t *pHook; \</span></div>
<div class="line"><span class="preprocessor"> int n; \</span></div>
<div class="line"><span class="preprocessor"> ret rv = ok; \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_INT_DCL_UD; \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_ENTRY(ud, ns, name, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> if(_hooks.link_##name) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \</span></div>
<div class="line"><span class="preprocessor"> for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_INVOKE(ud, ns, name, (char *)pHook[n].szName, args_use); \</span></div>
<div class="line"><span class="preprocessor"> rv=pHook[n].pFunc args_use; \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_COMPLETE(ud, ns, name, (char *)pHook[n].szName, rv, args_use); \</span></div>
<div class="line"><span class="preprocessor"> if(rv != ok && rv != decline) \</span></div>
<div class="line"><span class="preprocessor"> break; \</span></div>
<div class="line"><span class="preprocessor"> rv = ok; \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_RETURN(ud, ns, name, rv, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> return rv; \</span></div>
<div class="line"><span class="preprocessor"> }</span></div>
<div class="ttc" id="group___a_p_r___util___hook_html_ga2500abadaa54b3a9d6ec25ff33a6b0cc"><div class="ttname"><a href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a></div><div class="ttdeci">#define APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns, link, name)</div><div class="ttdef"><b>Definition:</b> apr_hooks.h:143</div></div>
</div><!-- fragment --><p>Implement a hook that runs until one of the functions returns something other than OK or DECLINE </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ns</td><td>The namespace prefix of the hook functions </td></tr>
<tr><td class="paramname">link</td><td>The linkage declaration prefix of the hook </td></tr>
<tr><td class="paramname">ret</td><td>Type to return </td></tr>
<tr><td class="paramname">name</td><td>The name of the hook </td></tr>
<tr><td class="paramname">args_decl</td><td>The declaration of the arguments for the hook </td></tr>
<tr><td class="paramname">args_use</td><td>The names for the arguments for the hook </td></tr>
<tr><td class="paramname">ok</td><td>Success value </td></tr>
<tr><td class="paramname">decline</td><td>Decline value </td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>The link prefix FOO corresponds to FOO_DECLARE() macros, which provide export linkage from the module that IMPLEMENTs the hook, and import linkage from external modules that link to the hook's module. </dd></dl>
</div>
</div>
<a class="anchor" id="ga0420a2aa9ca6b3c1638bdb76025ecc57"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ns, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">link, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">ret, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">name, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args_decl, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args_use, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">decline </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"><a class="code" href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a>(ns,link,name) \</div>
<div class="line">link##_DECLARE(ret) ns<span class="preprocessor">##_run_##name args_decl \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> ns##_LINK_##name##_t *pHook; \</span></div>
<div class="line"><span class="preprocessor"> int n; \</span></div>
<div class="line"><span class="preprocessor"> ret rv = decline; \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_INT_DCL_UD; \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_ENTRY(ud, ns, name, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> if(_hooks.link_##name) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \</span></div>
<div class="line"><span class="preprocessor"> for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_INVOKE(ud, ns, name, (char *)pHook[n].szName, args_use); \</span></div>
<div class="line"><span class="preprocessor"> rv=pHook[n].pFunc args_use; \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_COMPLETE(ud, ns, name, (char *)pHook[n].szName, rv, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> if(rv != decline) \</span></div>
<div class="line"><span class="preprocessor"> break; \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_RETURN(ud, ns, name, rv, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> return rv; \</span></div>
<div class="line"><span class="preprocessor"> }</span></div>
<div class="ttc" id="group___a_p_r___util___hook_html_ga2500abadaa54b3a9d6ec25ff33a6b0cc"><div class="ttname"><a href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a></div><div class="ttdeci">#define APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns, link, name)</div><div class="ttdef"><b>Definition:</b> apr_hooks.h:143</div></div>
</div><!-- fragment --><p>Implement a hook that runs until the first function returns something other than the value of decline </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ns</td><td>The namespace prefix of the hook functions </td></tr>
<tr><td class="paramname">link</td><td>The linkage declaration prefix of the hook </td></tr>
<tr><td class="paramname">name</td><td>The name of the hook </td></tr>
<tr><td class="paramname">ret</td><td>Type to return </td></tr>
<tr><td class="paramname">args_decl</td><td>The declaration of the arguments for the hook </td></tr>
<tr><td class="paramname">args_use</td><td>The names for the arguments for the hook </td></tr>
<tr><td class="paramname">decline</td><td>Decline value </td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>The link prefix FOO corresponds to FOO_DECLARE() macros, which provide export linkage from the module that IMPLEMENTs the hook, and import linkage from external modules that link to the hook's module. </dd></dl>
</div>
</div>
<a class="anchor" id="ga2d11a43b6431ec568cc1647da4a2079c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_IMPLEMENT_EXTERNAL_HOOK_VOID</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ns, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">link, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">name, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args_decl, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">args_use </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line"><a class="code" href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a>(ns,link,name) \</div>
<div class="line">link##_DECLARE(<span class="keywordtype">void</span>) ns<span class="preprocessor">##_run_##name args_decl \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> ns##_LINK_##name##_t *pHook; \</span></div>
<div class="line"><span class="preprocessor"> int n; \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_INT_DCL_UD; \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_ENTRY(ud, ns, name, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> if(_hooks.link_##name) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \</span></div>
<div class="line"><span class="preprocessor"> for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \</span></div>
<div class="line"><span class="preprocessor"> { \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_INVOKE(ud, ns, name, (char *)pHook[n].szName, args_use); \</span></div>
<div class="line"><span class="preprocessor"> pHook[n].pFunc args_use; \</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_COMPLETE(ud, ns, name, (char *)pHook[n].szName, 0, args_use); \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor"> } \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> APR_HOOK_PROBE_RETURN(ud, ns, name, 0, args_use); \</span></div>
<div class="line"><span class="preprocessor">\</span></div>
<div class="line"><span class="preprocessor"> }</span></div>
<div class="ttc" id="group___a_p_r___util___hook_html_ga2500abadaa54b3a9d6ec25ff33a6b0cc"><div class="ttname"><a href="group___a_p_r___util___hook.html#ga2500abadaa54b3a9d6ec25ff33a6b0cc">APR_IMPLEMENT_EXTERNAL_HOOK_BASE</a></div><div class="ttdeci">#define APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns, link, name)</div><div class="ttdef"><b>Definition:</b> apr_hooks.h:143</div></div>
</div><!-- fragment --><p>Implement a hook that has no return code, and therefore runs all of the registered functions </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ns</td><td>The namespace prefix of the hook functions </td></tr>
<tr><td class="paramname">link</td><td>The linkage declaration prefix of the hook </td></tr>
<tr><td class="paramname">name</td><td>The name of the hook </td></tr>
<tr><td class="paramname">args_decl</td><td>The declaration of the arguments for the hook </td></tr>
<tr><td class="paramname">args_use</td><td>The names for the arguments for the hook </td></tr>
</table>
</dd>
</dl>
<dl class="section note"><dt>Note</dt><dd>The link prefix FOO corresponds to FOO_DECLARE() macros, which provide export linkage from the module that IMPLEMENTs the hook, and import linkage from external modules that link to the hook's module. </dd></dl>
</div>
</div>
<a class="anchor" id="ga832a6d3b73a43b3f7c58c5702ddccce9"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_IMPLEMENT_HOOK_GET_PROTO</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ns, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">link, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">name </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   link##_DECLARE(apr_array_header_t *) ns##_hook_get_##name(void)</td>
</tr>
</table>
</div><div class="memdoc">
<p>macro to return the prototype of the hook function </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="ga1de31557683f53c2a07f73990962c585"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_hook_debug_show </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>szName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *const * </td>
<td class="paramname"><em>aszPre</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char *const * </td>
<td class="paramname"><em>aszSucc</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Print all of the information about the current hook. This is used for debugging purposes. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">szName</td><td>The name of the hook </td></tr>
<tr><td class="paramname">aszPre</td><td>All of the functions in the predecessor array </td></tr>
<tr><td class="paramname">aszSucc</td><td>All of the functions in the successor array </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga5d20451da75574c8433feb1bd5b2ce10"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_hook_deregister_all </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Remove all currently registered functions. </p>
</div>
</div>
<a class="anchor" id="ga1e0b6cf91dac5417c1b9cbd1b46b8991"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_hook_sort_all </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Sort all of the registered functions for a given hook. </p>
</div>
</div>
<a class="anchor" id="ga04843fe00dc3c08c23130fef3ba1260c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_hook_sort_register </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>szHookName</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_array_header_t ** </td>
<td class="paramname"><em>aHooks</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Register a hook function to be sorted. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">szHookName</td><td>The name of the Hook the function is registered for </td></tr>
<tr><td class="paramname">aHooks</td><td>The array which stores all of the functions for this hook </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<h2 class="groupheader">Variable Documentation</h2>
<a class="anchor" id="ga37be3c217439ceddbda16054b020a658"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_hook_debug_current</td>
</tr>
</table>
</div><div class="memdoc">
<p>The name of the module that is currently registering a function. </p>
</div>
</div>
<a class="anchor" id="ga59309caeb9b47d921727530494f264be"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_hook_debug_enabled</td>
</tr>
</table>
</div><div class="memdoc">
<p>A global variable to determine if debugging information about the hooks functions should be printed. </p>
</div>
</div>
<a class="anchor" id="ga8911bb699a5f03ad3c36d579ca0eca23"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_pool_t* apr_hook_global_pool</td>
</tr>
</table>
</div><div class="memdoc">
<p>The global pool used to allocate any memory needed by the hooks. </p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Mon Feb 13 2023 19:13:22 for Apache Portable Runtime Utility Library by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.6
</small></address>
</body>
</html>