apr-util/include/apr_hooks.h

65  * @param name The name of the hook
69 #define APR_HOOK_PROBE_ENTRY(ud,ns,name,args)
76  * @param name The name of the hook
81 #define APR_HOOK_PROBE_RETURN(ud,ns,name,rv,args)
88  * @param name The name of the hook
94 #define APR_HOOK_PROBE_INVOKE(ud,ns,name,src,args)
101  * @param name The name of the hook
108 #define APR_HOOK_PROBE_COMPLETE(ud,ns,name,src,rv,args)
114 #define APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name) \
115 link##_DECLARE(apr_array_header_t *) ns##_hook_get_##name(void)
118 #define APR_DECLARE_EXTERNAL_HOOK(ns,link,ret,name,args) \
119 typedef ret ns##_HOOK_##name##_t args; \
120 link##_DECLARE(void) ns##_hook_##name(ns##_HOOK_##name##_t *pf, \
123 link##_DECLARE(ret) ns##_run_##name args; \
124 APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name); \
125 typedef struct ns##_LINK_##name##_t \
127     ns##_HOOK_##name##_t *pFunc; \
132     } ns##_LINK_##name##_t;
139 #define APR_HOOK_LINK(name) \
140     apr_array_header_t *link_##name;
143 #define APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
144 link##_DECLARE(void) ns##_hook_##name(ns##_HOOK_##name##_t *pf,const char * const *aszPre, \
147     ns##_LINK_##name##_t *pHook; \
148     if(!_hooks.link_##name) \
150 	_hooks.link_##name=apr_array_make(apr_hook_global_pool,1,sizeof(ns##_LINK_##name##_t)); \
151 	apr_hook_sort_register(#name,&_hooks.link_##name); \
153     pHook=apr_array_push(_hooks.link_##name); \
160 	apr_hook_debug_show(#name,aszPre,aszSucc); \
162     APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name) \
164         return _hooks.link_##name; \
172  * @param name The name of the hook
179 #define APR_IMPLEMENT_EXTERNAL_HOOK_VOID(ns,link,name,args_decl,args_use) \
180 APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
181 link##_DECLARE(void) ns##_run_##name args_decl \
183     ns##_LINK_##name##_t *pHook; \
187     APR_HOOK_PROBE_ENTRY(ud, ns, name, args_use); \
189     if(_hooks.link_##name) \
191         pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \
192         for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \
194             APR_HOOK_PROBE_INVOKE(ud, ns, name, (char *)pHook[n].szName, args_use); \
196             APR_HOOK_PROBE_COMPLETE(ud, ns, name, (char *)pHook[n].szName, 0, args_use); \
200     APR_HOOK_PROBE_RETURN(ud, ns, name, 0, args_use); \
213  * @param name The name of the hook
222 #define APR_IMPLEMENT_EXTERNAL_HOOK_RUN_ALL(ns,link,ret,name,args_decl,args_use,ok,decline) \
223 APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
224 link##_DECLARE(ret) ns##_run_##name args_decl \
226     ns##_LINK_##name##_t *pHook; \
231     APR_HOOK_PROBE_ENTRY(ud, ns, name, args_use); \
233     if(_hooks.link_##name) \
235         pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \
236         for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \
238             APR_HOOK_PROBE_INVOKE(ud, ns, name, (char *)pHook[n].szName, args_use); \
240             APR_HOOK_PROBE_COMPLETE(ud, ns, name, (char *)pHook[n].szName, rv, args_use); \
247     APR_HOOK_PROBE_RETURN(ud, ns, name, rv, args_use); \
258  * @param name The name of the hook
267 #define APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST(ns,link,ret,name,args_decl,args_use,decline) \
268 APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
269 link##_DECLARE(ret) ns##_run_##name args_decl \
271     ns##_LINK_##name##_t *pHook; \
276     APR_HOOK_PROBE_ENTRY(ud, ns, name, args_use); \
278     if(_hooks.link_##name) \
280         pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \
281         for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \
283             APR_HOOK_PROBE_INVOKE(ud, ns, name, (char *)pHook[n].szName, args_use); \
285             APR_HOOK_PROBE_COMPLETE(ud, ns, name, (char *)pHook[n].szName, rv, args_use); \
292     APR_HOOK_PROBE_RETURN(ud, ns, name, rv, args_use); \
321  * The name of the module that is currently registering a function.
327  * @param szHookName The name of the Hook the function is registered for
340  * @param szName The name of the hook