src/afb-hook.h

   1 /*
   2  * Copyright (C) 2016, 2017 "IoT.bzh"
   3  * Author José Bollo <jose.bollo@iot.bzh>
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *   http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 #pragma once
  19
  20 #include <stdarg.h>
  21 #include <time.h>
  22
  23 struct req;
  24 struct afb_context;
  25 struct json_object;
  26 struct afb_arg;
  27 struct afb_eventid;
  28 struct afb_session;
  29 struct afb_xreq;
  30 struct afb_export;
  31 struct afb_stored_req;
  32 struct sd_bus;
  33 struct sd_event;
  34 struct afb_hook_xreq;
  35 struct afb_hook_ditf;
  36 struct afb_hook_svc;
  37 struct afb_hook_evt;
  38 struct afb_hook_session;
  39 struct afb_hook_global;
  40
  41 /*********************************************************
  42 * section hookid
  43 *********************************************************/
  44 struct afb_hookid
  45 {
  46         unsigned id;            /* id of the hook event */
  47         struct timespec time;   /* time of the hook event */
  48 };
  49
  50 /*********************************************************
  51 * section hooking xreq
  52 *********************************************************/
  53
  54 /* individual flags */
  55 #define afb_hook_flag_req_begin                 0x00000001
  56 #define afb_hook_flag_req_end                   0x00000002
  57 #define afb_hook_flag_req_json                  0x00000004
  58 #define afb_hook_flag_req_get                   0x00000008
  59 #define afb_hook_flag_req_success               0x00000010
  60 #define afb_hook_flag_req_fail                  0x00000020
  61 #define afb_hook_flag_req_context_get           0x00000040
  62 #define afb_hook_flag_req_context_set           0x00000080
  63 #define afb_hook_flag_req_addref                0x00000100
  64 #define afb_hook_flag_req_unref                 0x00000200
  65 #define afb_hook_flag_req_session_close         0x00000400
  66 #define afb_hook_flag_req_session_set_LOA       0x00000800
  67 #define afb_hook_flag_req_subscribe             0x00001000
  68 #define afb_hook_flag_req_unsubscribe           0x00002000
  69 #define afb_hook_flag_req_subcall               0x00004000
  70 #define afb_hook_flag_req_subcall_result        0x00008000
  71 #define afb_hook_flag_req_subcallsync           0x00010000
  72 #define afb_hook_flag_req_subcallsync_result    0x00020000
  73 #define afb_hook_flag_req_vverbose              0x00040000
  74 #define afb_hook_flag_req_store                 0x00080000
  75 #define afb_hook_flag_req_unstore               0x00100000
  76 #define afb_hook_flag_req_subcall_req           0x00200000
  77 #define afb_hook_flag_req_subcall_req_result    0x00400000
  78 #define afb_hook_flag_req_has_permission        0x00800000
  79 #define afb_hook_flag_req_get_application_id    0x01000000
  80 #define afb_hook_flag_req_context_make          0x02000000
  81 #define afb_hook_flag_req_get_uid               0x04000000
  82
  83 /* common flags */
  84 #define afb_hook_flags_req_life         (afb_hook_flag_req_begin|afb_hook_flag_req_end)
  85 #define afb_hook_flags_req_args         (afb_hook_flag_req_json|afb_hook_flag_req_get)
  86 #define afb_hook_flags_req_result       (afb_hook_flag_req_success|afb_hook_flag_req_fail)
  87 #define afb_hook_flags_req_session      (afb_hook_flag_req_session_close|afb_hook_flag_req_session_set_LOA)
  88 #define afb_hook_flags_req_event        (afb_hook_flag_req_subscribe|afb_hook_flag_req_unsubscribe)
  89 #define afb_hook_flags_req_subcalls     (afb_hook_flag_req_subcall|afb_hook_flag_req_subcall_result\
  90                                         |afb_hook_flag_req_subcall_req|afb_hook_flag_req_subcall_req_result\
  91                                         |afb_hook_flag_req_subcallsync|afb_hook_flag_req_subcallsync_result)
  92 #define afb_hook_flags_req_security     (afb_hook_flag_req_has_permission|afb_hook_flag_req_get_application_id\
  93                                         |afb_hook_flag_req_get_uid)
  94
  95 /* extra flags */
  96 #define afb_hook_flags_req_ref          (afb_hook_flag_req_addref|afb_hook_flag_req_unref)
  97 #define afb_hook_flags_req_context      (afb_hook_flag_req_context_get|afb_hook_flag_req_context_set\
  98                                         |afb_hook_flag_req_context_make)
  99 #define afb_hook_flags_req_stores       (afb_hook_flag_req_store|afb_hook_flag_req_unstore)
 100
 101 /* predefined groups */
 102 #define afb_hook_flags_req_common       (afb_hook_flags_req_life|afb_hook_flags_req_args|afb_hook_flags_req_result\
 103                                         |afb_hook_flags_req_session|afb_hook_flags_req_event|afb_hook_flags_req_subcalls\
 104                                         |afb_hook_flag_req_vverbose|afb_hook_flags_req_security)
 105 #define afb_hook_flags_req_extra        (afb_hook_flags_req_common|afb_hook_flags_req_ref|afb_hook_flags_req_context\
 106                                         |afb_hook_flags_req_stores)
 107 #define afb_hook_flags_req_all          (afb_hook_flags_req_extra)
 108
 109 struct afb_hook_xreq_itf {
 110         void (*hook_xreq_begin)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
 111         void (*hook_xreq_end)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
 112         void (*hook_xreq_json)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct json_object *obj);
 113         void (*hook_xreq_get)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *name, struct afb_arg arg);
 114         void (*hook_xreq_success)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct json_object *obj, const char *info);
 115         void (*hook_xreq_fail)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *status, const char *info);
 116         void (*hook_xreq_context_get)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, void *value);
 117         void (*hook_xreq_context_set)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, void *value, void (*free_value)(void*));
 118         void (*hook_xreq_addref)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
 119         void (*hook_xreq_unref)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
 120         void (*hook_xreq_session_close)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
 121         void (*hook_xreq_session_set_LOA)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, unsigned level, int result);
 122         void (*hook_xreq_subscribe)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct afb_eventid *eventid, int result);
 123         void (*hook_xreq_unsubscribe)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct afb_eventid *eventid, int result);
 124         void (*hook_xreq_subcall)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
 125         void (*hook_xreq_subcall_result)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int status, struct json_object *result);
 126         void (*hook_xreq_subcallsync)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
 127         void (*hook_xreq_subcallsync_result)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int status, struct json_object *result);
 128         void (*hook_xreq_vverbose)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int level, const char *file, int line, const char *func, const char *fmt, va_list args);
 129         void (*hook_xreq_store)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct afb_stored_req *sreq);
 130         void (*hook_xreq_unstore)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
 131         void (*hook_xreq_subcall_req)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
 132         void (*hook_xreq_subcall_req_result)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int status, struct json_object *result);
 133         void (*hook_xreq_has_permission)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *permission, int result);
 134         void (*hook_xreq_get_application_id)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, char *result);
 135         void (*hook_xreq_context_make)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int replace, void *(*create_value)(void*), void (*free_value)(void*), void *create_closure, void *result);
 136         void (*hook_xreq_get_uid)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int result);
 137 };
 138
 139 extern void afb_hook_init_xreq(struct afb_xreq *xreq);
 140
 141 extern struct afb_hook_xreq *afb_hook_create_xreq(const char *api, const char *verb, struct afb_session *session, int flags, struct afb_hook_xreq_itf *itf, void *closure);
 142 extern struct afb_hook_xreq *afb_hook_addref_xreq(struct afb_hook_xreq *spec);
 143 extern void afb_hook_unref_xreq(struct afb_hook_xreq *spec);
 144
 145 /* hooks for xreq */
 146 extern void afb_hook_xreq_begin(const struct afb_xreq *xreq);
 147 extern void afb_hook_xreq_end(const struct afb_xreq *xreq);
 148 extern struct json_object *afb_hook_xreq_json(const struct afb_xreq *xreq, struct json_object *obj);
 149 extern struct afb_arg afb_hook_xreq_get(const struct afb_xreq *xreq, const char *name, struct afb_arg arg);
 150 extern void afb_hook_xreq_success(const struct afb_xreq *xreq, struct json_object *obj, const char *info);
 151 extern void afb_hook_xreq_fail(const struct afb_xreq *xreq, const char *status, const char *info);
 152 extern void *afb_hook_xreq_context_get(const struct afb_xreq *xreq, void *value);
 153 extern void afb_hook_xreq_context_set(const struct afb_xreq *xreq, void *value, void (*free_value)(void*));
 154 extern void afb_hook_xreq_addref(const struct afb_xreq *xreq);
 155 extern void afb_hook_xreq_unref(const struct afb_xreq *xreq);
 156 extern void afb_hook_xreq_session_close(const struct afb_xreq *xreq);
 157 extern int afb_hook_xreq_session_set_LOA(const struct afb_xreq *xreq, unsigned level, int result);
 158 extern int afb_hook_xreq_subscribe(const struct afb_xreq *xreq, struct afb_eventid *eventid, int result);
 159 extern int afb_hook_xreq_unsubscribe(const struct afb_xreq *xreq, struct afb_eventid *eventid, int result);
 160 extern void afb_hook_xreq_subcall(const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
 161 extern void afb_hook_xreq_subcall_result(const struct afb_xreq *xreq, int status, struct json_object *result);
 162 extern void afb_hook_xreq_subcallsync(const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
 163 extern int afb_hook_xreq_subcallsync_result(const struct afb_xreq *xreq, int status, struct json_object *result);
 164 extern void afb_hook_xreq_vverbose(const struct afb_xreq *xreq, int level, const char *file, int line, const char *func, const char *fmt, va_list args);
 165 extern void afb_hook_xreq_store(const struct afb_xreq *xreq, struct afb_stored_req *sreq);
 166 extern void afb_hook_xreq_unstore(const struct afb_xreq *xreq);
 167 extern void afb_hook_xreq_subcall_req(const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
 168 extern void afb_hook_xreq_subcall_req_result(const struct afb_xreq *xreq, int status, struct json_object *result);
 169 extern int afb_hook_xreq_has_permission(const struct afb_xreq *xreq, const char *permission, int result);
 170 extern char *afb_hook_xreq_get_application_id(const struct afb_xreq *xreq, char *result);
 171 extern void *afb_hook_xreq_context_make(const struct afb_xreq *xreq, int replace, void *(*create_value)(void*), void (*free_value)(void*), void *create_closure, void *result);
 172 extern int afb_hook_xreq_get_uid(const struct afb_xreq *xreq, int result);
 173
 174 /*********************************************************
 175 * section hooking export (daemon interface)
 176 *********************************************************/
 177
 178 #define afb_hook_flag_ditf_vverbose                     0x000001
 179 #define afb_hook_flag_ditf_event_make                   0x000002
 180 #define afb_hook_flag_ditf_event_broadcast_before       0x000004
 181 #define afb_hook_flag_ditf_event_broadcast_after        0x000008
 182 #define afb_hook_flag_ditf_get_event_loop               0x000010
 183 #define afb_hook_flag_ditf_get_user_bus                 0x000020
 184 #define afb_hook_flag_ditf_get_system_bus               0x000040
 185 #define afb_hook_flag_ditf_rootdir_get_fd               0x000080
 186 #define afb_hook_flag_ditf_rootdir_open_locale          0x000100
 187 #define afb_hook_flag_ditf_queue_job                    0x000200
 188 #define afb_hook_flag_ditf_unstore_req                  0x000400
 189 #define afb_hook_flag_ditf_require_api                  0x000800
 190 #define afb_hook_flag_ditf_require_api_result           0x001000
 191 #define afb_hook_flag_ditf_rename_api                   0x002000
 192
 193 #define afb_hook_flags_ditf_common      (afb_hook_flag_ditf_vverbose\
 194                                         |afb_hook_flag_ditf_event_make\
 195                                         |afb_hook_flag_ditf_event_broadcast_before\
 196                                         |afb_hook_flag_ditf_event_broadcast_after\
 197                                         |afb_hook_flag_ditf_rename_api)
 198 #define afb_hook_flags_ditf_extra       (afb_hook_flag_ditf_get_event_loop\
 199                                         |afb_hook_flag_ditf_get_user_bus\
 200                                         |afb_hook_flag_ditf_get_system_bus\
 201                                         |afb_hook_flag_ditf_rootdir_get_fd\
 202                                         |afb_hook_flag_ditf_rootdir_open_locale\
 203                                         |afb_hook_flag_ditf_queue_job\
 204                                         |afb_hook_flag_ditf_unstore_req\
 205                                         |afb_hook_flag_ditf_require_api\
 206                                         |afb_hook_flag_ditf_require_api_result)
 207
 208 #define afb_hook_flags_ditf_all         (afb_hook_flags_ditf_common|afb_hook_flags_ditf_extra)
 209
 210 struct afb_hook_ditf_itf {
 211         void (*hook_ditf_event_broadcast_before)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *name, struct json_object *object);
 212         void (*hook_ditf_event_broadcast_after)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *name, struct json_object *object, int result);
 213         void (*hook_ditf_get_event_loop)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, struct sd_event *result);
 214         void (*hook_ditf_get_user_bus)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, struct sd_bus *result);
 215         void (*hook_ditf_get_system_bus)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, struct sd_bus *result);
 216         void (*hook_ditf_vverbose)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, int level, const char *file, int line, const char *function, const char *fmt, va_list args);
 217         void (*hook_ditf_event_make)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *name, struct afb_eventid *result);
 218         void (*hook_ditf_rootdir_get_fd)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, int result);
 219         void (*hook_ditf_rootdir_open_locale)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *filename, int flags, const char *locale, int result);
 220         void (*hook_ditf_queue_job)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, void (*callback)(int signum, void *arg), void *argument, void *group, int timeout, int result);
 221         void (*hook_ditf_unstore_req)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, struct afb_stored_req *sreq);
 222         void (*hook_ditf_require_api)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *name, int initialized);
 223         void (*hook_ditf_require_api_result)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *name, int initialized, int result);
 224         void (*hook_ditf_rename_api)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *oldname, const char *newname, int result);
 225 };
 226
 227 extern void afb_hook_ditf_event_broadcast_before(const struct afb_export *export, const char *name, struct json_object *object);
 228 extern int afb_hook_ditf_event_broadcast_after(const struct afb_export *export, const char *name, struct json_object *object, int result);
 229 extern struct sd_event *afb_hook_ditf_get_event_loop(const struct afb_export *export, struct sd_event *result);
 230 extern struct sd_bus *afb_hook_ditf_get_user_bus(const struct afb_export *export, struct sd_bus *result);
 231 extern struct sd_bus *afb_hook_ditf_get_system_bus(const struct afb_export *export, struct sd_bus *result);
 232 extern void afb_hook_ditf_vverbose(const struct afb_export *export, int level, const char *file, int line, const char *function, const char *fmt, va_list args);
 233 extern struct afb_eventid *afb_hook_ditf_event_make(const struct afb_export *export, const char *name, struct afb_eventid *result);
 234 extern int afb_hook_ditf_rootdir_get_fd(const struct afb_export *export, int result);
 235 extern int afb_hook_ditf_rootdir_open_locale(const struct afb_export *export, const char *filename, int flags, const char *locale, int result);
 236 extern int afb_hook_ditf_queue_job(const struct afb_export *export, void (*callback)(int signum, void *arg), void *argument, void *group, int timeout, int result);
 237 extern void afb_hook_ditf_unstore_req(const struct afb_export *export, struct afb_stored_req *sreq);
 238 extern void afb_hook_ditf_require_api(const struct afb_export *export, const char *name, int initialized);
 239 extern int afb_hook_ditf_require_api_result(const struct afb_export *export, const char *name, int initialized, int result);
 240 extern int afb_hook_ditf_rename_api(const struct afb_export *export, const char *oldname, const char *newname, int result);
 241
 242 extern int afb_hook_flags_ditf(const char *api);
 243 extern struct afb_hook_ditf *afb_hook_create_ditf(const char *api, int flags, struct afb_hook_ditf_itf *itf, void *closure);
 244 extern struct afb_hook_ditf *afb_hook_addref_ditf(struct afb_hook_ditf *hook);
 245 extern void afb_hook_unref_ditf(struct afb_hook_ditf *hook);
 246
 247 /*********************************************************
 248 * section hooking export (service interface)
 249 *********************************************************/
 250
 251 #define afb_hook_flag_svc_start_before                  0x000001
 252 #define afb_hook_flag_svc_start_after                   0x000002
 253 #define afb_hook_flag_svc_on_event_before               0x000004
 254 #define afb_hook_flag_svc_on_event_after                0x000008
 255 #define afb_hook_flag_svc_call                          0x000010
 256 #define afb_hook_flag_svc_call_result                   0x000020
 257 #define afb_hook_flag_svc_callsync                      0x000040
 258 #define afb_hook_flag_svc_callsync_result               0x000080
 259
 260 #define afb_hook_flags_svc_all          (afb_hook_flag_svc_start_before|afb_hook_flag_svc_start_after\
 261                                         |afb_hook_flag_svc_on_event_before|afb_hook_flag_svc_on_event_after\
 262                                         |afb_hook_flag_svc_call|afb_hook_flag_svc_call_result\
 263                                         |afb_hook_flag_svc_callsync|afb_hook_flag_svc_callsync_result)
 264
 265 struct afb_hook_svc_itf {
 266         void (*hook_svc_start_before)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export);
 267         void (*hook_svc_start_after)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, int status);
 268         void (*hook_svc_on_event_before)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *event, int eventid, struct json_object *object);
 269         void (*hook_svc_on_event_after)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *event, int eventid, struct json_object *object);
 270         void (*hook_svc_call)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *api, const char *verb, struct json_object *args);
 271         void (*hook_svc_call_result)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, int status, struct json_object *result);
 272         void (*hook_svc_callsync)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, const char *api, const char *verb, struct json_object *args);
 273         void (*hook_svc_callsync_result)(void *closure, const struct afb_hookid *hookid, const struct afb_export *export, int status, struct json_object *result);
 274 };
 275
 276 extern void afb_hook_svc_start_before(const struct afb_export *export);
 277 extern int afb_hook_svc_start_after(const struct afb_export *export, int status);
 278 extern void afb_hook_svc_on_event_before(const struct afb_export *export, const char *event, int eventid, struct json_object *object);
 279 extern void afb_hook_svc_on_event_after(const struct afb_export *export, const char *event, int eventid, struct json_object *object);
 280 extern void afb_hook_svc_call(const struct afb_export *export, const char *api, const char *verb, struct json_object *args);
 281 extern void afb_hook_svc_call_result(const struct afb_export *export, int status, struct json_object *result);
 282 extern void afb_hook_svc_callsync(const struct afb_export *export, const char *api, const char *verb, struct json_object *args);
 283 extern int afb_hook_svc_callsync_result(const struct afb_export *export, int status, struct json_object *result);
 284
 285 extern int afb_hook_flags_svc(const char *api);
 286 extern struct afb_hook_svc *afb_hook_create_svc(const char *api, int flags, struct afb_hook_svc_itf *itf, void *closure);
 287 extern struct afb_hook_svc *afb_hook_addref_svc(struct afb_hook_svc *hook);
 288 extern void afb_hook_unref_svc(struct afb_hook_svc *hook);
 289
 290 /*********************************************************
 291 * section hooking evt (event interface)
 292 *********************************************************/
 293
 294 #define afb_hook_flag_evt_create                        0x000001
 295 #define afb_hook_flag_evt_push_before                   0x000002
 296 #define afb_hook_flag_evt_push_after                    0x000004
 297 #define afb_hook_flag_evt_broadcast_before              0x000008
 298 #define afb_hook_flag_evt_broadcast_after               0x000010
 299 #define afb_hook_flag_evt_name                          0x000020
 300 #define afb_hook_flag_evt_addref                        0x000040
 301 #define afb_hook_flag_evt_unref                         0x000080
 302
 303 #define afb_hook_flags_evt_common       (afb_hook_flag_evt_push_before|afb_hook_flag_evt_broadcast_before)
 304 #define afb_hook_flags_evt_extra        (afb_hook_flags_evt_common\
 305                                         |afb_hook_flag_evt_push_after|afb_hook_flag_evt_broadcast_after\
 306                                         |afb_hook_flag_evt_create\
 307                                         |afb_hook_flag_evt_addref|afb_hook_flag_evt_unref)
 308 #define afb_hook_flags_evt_all          (afb_hook_flags_evt_extra|afb_hook_flag_evt_name)
 309
 310 struct afb_hook_evt_itf {
 311         void (*hook_evt_create)(void *closure, const struct afb_hookid *hookid, const char *evt, int id);
 312         void (*hook_evt_push_before)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj);
 313         void (*hook_evt_push_after)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj, int result);
 314         void (*hook_evt_broadcast_before)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj);
 315         void (*hook_evt_broadcast_after)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj, int result);
 316         void (*hook_evt_name)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, const char *result);
 317         void (*hook_evt_addref)(void *closure, const struct afb_hookid *hookid, const char *evt, int id);
 318         void (*hook_evt_unref)(void *closure, const struct afb_hookid *hookid, const char *evt, int id);
 319 };
 320
 321 extern void afb_hook_evt_create(const char *evt, int id);
 322 extern void afb_hook_evt_push_before(const char *evt, int id, struct json_object *obj);
 323 extern int afb_hook_evt_push_after(const char *evt, int id, struct json_object *obj, int result);
 324 extern void afb_hook_evt_broadcast_before(const char *evt, int id, struct json_object *obj);
 325 extern int afb_hook_evt_broadcast_after(const char *evt, int id, struct json_object *obj, int result);
 326 extern void afb_hook_evt_name(const char *evt, int id, const char *result);
 327 extern void afb_hook_evt_addref(const char *evt, int id);
 328 extern void afb_hook_evt_unref(const char *evt, int id);
 329
 330 extern int afb_hook_flags_evt(const char *name);
 331 extern struct afb_hook_evt *afb_hook_create_evt(const char *pattern, int flags, struct afb_hook_evt_itf *itf, void *closure);
 332 extern struct afb_hook_evt *afb_hook_addref_evt(struct afb_hook_evt *hook);
 333 extern void afb_hook_unref_evt(struct afb_hook_evt *hook);
 334
 335 /*********************************************************
 336 * section hooking session (session interface)
 337 *********************************************************/
 338
 339 #define afb_hook_flag_session_create                    0x000001
 340 #define afb_hook_flag_session_close                     0x000002
 341 #define afb_hook_flag_session_destroy                   0x000004
 342 #define afb_hook_flag_session_renew                     0x000008
 343 #define afb_hook_flag_session_addref                    0x000010
 344 #define afb_hook_flag_session_unref                     0x000020
 345
 346 #define afb_hook_flags_session_common   (afb_hook_flag_session_create|afb_hook_flag_session_close\
 347                                         |afb_hook_flag_session_renew)
 348 #define afb_hook_flags_session_all      (afb_hook_flags_session_common|afb_hook_flag_session_destroy\
 349                                         |afb_hook_flag_session_addref|afb_hook_flag_session_unref)
 350
 351 struct afb_hook_session_itf {
 352         void (*hook_session_create)(void *closure, const struct afb_hookid *hookid, struct afb_session *session);
 353         void (*hook_session_close)(void *closure, const struct afb_hookid *hookid, struct afb_session *session);
 354         void (*hook_session_destroy)(void *closure, const struct afb_hookid *hookid, struct afb_session *session);
 355         void (*hook_session_renew)(void *closure, const struct afb_hookid *hookid, struct afb_session *session);
 356         void (*hook_session_addref)(void *closure, const struct afb_hookid *hookid, struct afb_session *session);
 357         void (*hook_session_unref)(void *closure, const struct afb_hookid *hookid, struct afb_session *session);
 358 };
 359
 360 extern void afb_hook_session_create(struct afb_session *session);
 361 extern void afb_hook_session_close(struct afb_session *session);
 362 extern void afb_hook_session_destroy(struct afb_session *session);
 363 extern void afb_hook_session_renew(struct afb_session *session);
 364 extern void afb_hook_session_addref(struct afb_session *session);
 365 extern void afb_hook_session_unref(struct afb_session *session);
 366
 367 extern struct afb_hook_session *afb_hook_create_session(const char *pattern, int flags, struct afb_hook_session_itf *itf, void *closure);
 368 extern struct afb_hook_session *afb_hook_addref_session(struct afb_hook_session *hook);
 369 extern void afb_hook_unref_session(struct afb_hook_session *hook);
 370
 371 /*********************************************************
 372 * section hooking global (global interface)
 373 *********************************************************/
 374
 375 #define afb_hook_flag_global_vverbose                   0x000001
 376
 377 #define afb_hook_flags_global_all       (afb_hook_flag_global_vverbose)
 378
 379 struct afb_hook_global_itf {
 380         void (*hook_global_vverbose)(void *closure, const struct afb_hookid *hookid, int level, const char *file, int line, const char *function, const char *fmt, va_list args);
 381 };
 382
 383 extern struct afb_hook_global *afb_hook_create_global(int flags, struct afb_hook_global_itf *itf, void *closure);
 384 extern struct afb_hook_global *afb_hook_addref_global(struct afb_hook_global *hook);
 385 extern void afb_hook_unref_global(struct afb_hook_global *hook);
 386