2 * Copyright (C) 2016, 2017 "IoT.bzh"
3 * Author José Bollo <jose.bollo@iot.bzh>
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
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
32 struct afb_stored_req;
39 struct afb_hook_global;
41 /*********************************************************
43 *********************************************************/
46 unsigned id; /* id of the hook event */
47 struct timespec time; /* time of the hook event */
50 /*********************************************************
51 * section hooking xreq
52 *********************************************************/
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
81 #define afb_hook_flags_req_life (afb_hook_flag_req_begin|afb_hook_flag_req_end)
82 #define afb_hook_flags_req_args (afb_hook_flag_req_json|afb_hook_flag_req_get)
83 #define afb_hook_flags_req_result (afb_hook_flag_req_success|afb_hook_flag_req_fail)
84 #define afb_hook_flags_req_session (afb_hook_flag_req_session_close|afb_hook_flag_req_session_set_LOA)
85 #define afb_hook_flags_req_event (afb_hook_flag_req_subscribe|afb_hook_flag_req_unsubscribe)
86 #define afb_hook_flags_req_subcalls (afb_hook_flag_req_subcall|afb_hook_flag_req_subcall_result\
87 |afb_hook_flag_req_subcall_req|afb_hook_flag_req_subcall_req_result\
88 |afb_hook_flag_req_subcallsync|afb_hook_flag_req_subcallsync_result)
91 #define afb_hook_flags_req_ref (afb_hook_flag_req_addref|afb_hook_flag_req_unref)
92 #define afb_hook_flags_req_context (afb_hook_flag_req_context_get|afb_hook_flag_req_context_set)
93 #define afb_hook_flags_req_stores (afb_hook_flag_req_store|afb_hook_flag_req_unstore)
95 /* predefined groups */
96 #define afb_hook_flags_req_common (afb_hook_flags_req_life|afb_hook_flags_req_args|afb_hook_flags_req_result\
97 |afb_hook_flags_req_session|afb_hook_flags_req_event|afb_hook_flags_req_subcalls\
98 |afb_hook_flag_req_vverbose|afb_hook_flag_req_has_permission)
99 #define afb_hook_flags_req_extra (afb_hook_flags_req_common|afb_hook_flags_req_ref|afb_hook_flags_req_context\
100 |afb_hook_flags_req_stores)
101 #define afb_hook_flags_req_all (afb_hook_flags_req_extra)
103 struct afb_hook_xreq_itf {
104 void (*hook_xreq_begin)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
105 void (*hook_xreq_end)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
106 void (*hook_xreq_json)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct json_object *obj);
107 void (*hook_xreq_get)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *name, struct afb_arg arg);
108 void (*hook_xreq_success)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct json_object *obj, const char *info);
109 void (*hook_xreq_fail)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *status, const char *info);
110 void (*hook_xreq_context_get)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, void *value);
111 void (*hook_xreq_context_set)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, void *value, void (*free_value)(void*));
112 void (*hook_xreq_addref)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
113 void (*hook_xreq_unref)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
114 void (*hook_xreq_session_close)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
115 void (*hook_xreq_session_set_LOA)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, unsigned level, int result);
116 void (*hook_xreq_subscribe)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct afb_event event, int result);
117 void (*hook_xreq_unsubscribe)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct afb_event event, int result);
118 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);
119 void (*hook_xreq_subcall_result)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int status, struct json_object *result);
120 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);
121 void (*hook_xreq_subcallsync_result)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int status, struct json_object *result);
122 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);
123 void (*hook_xreq_store)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, struct afb_stored_req *sreq);
124 void (*hook_xreq_unstore)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq);
125 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);
126 void (*hook_xreq_subcall_req_result)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, int status, struct json_object *result);
127 void (*hook_xreq_has_permission)(void *closure, const struct afb_hookid *hookid, const struct afb_xreq *xreq, const char *permission, int result);
130 extern void afb_hook_init_xreq(struct afb_xreq *xreq);
132 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);
133 extern struct afb_hook_xreq *afb_hook_addref_xreq(struct afb_hook_xreq *spec);
134 extern void afb_hook_unref_xreq(struct afb_hook_xreq *spec);
137 extern void afb_hook_xreq_begin(const struct afb_xreq *xreq);
138 extern void afb_hook_xreq_end(const struct afb_xreq *xreq);
139 extern struct json_object *afb_hook_xreq_json(const struct afb_xreq *xreq, struct json_object *obj);
140 extern struct afb_arg afb_hook_xreq_get(const struct afb_xreq *xreq, const char *name, struct afb_arg arg);
141 extern void afb_hook_xreq_success(const struct afb_xreq *xreq, struct json_object *obj, const char *info);
142 extern void afb_hook_xreq_fail(const struct afb_xreq *xreq, const char *status, const char *info);
143 extern void *afb_hook_xreq_context_get(const struct afb_xreq *xreq, void *value);
144 extern void afb_hook_xreq_context_set(const struct afb_xreq *xreq, void *value, void (*free_value)(void*));
145 extern void afb_hook_xreq_addref(const struct afb_xreq *xreq);
146 extern void afb_hook_xreq_unref(const struct afb_xreq *xreq);
147 extern void afb_hook_xreq_session_close(const struct afb_xreq *xreq);
148 extern int afb_hook_xreq_session_set_LOA(const struct afb_xreq *xreq, unsigned level, int result);
149 extern int afb_hook_xreq_subscribe(const struct afb_xreq *xreq, struct afb_event event, int result);
150 extern int afb_hook_xreq_unsubscribe(const struct afb_xreq *xreq, struct afb_event event, int result);
151 extern void afb_hook_xreq_subcall(const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
152 extern void afb_hook_xreq_subcall_result(const struct afb_xreq *xreq, int status, struct json_object *result);
153 extern void afb_hook_xreq_subcallsync(const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
154 extern int afb_hook_xreq_subcallsync_result(const struct afb_xreq *xreq, int status, struct json_object *result);
155 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);
156 extern void afb_hook_xreq_store(const struct afb_xreq *xreq, struct afb_stored_req *sreq);
157 extern void afb_hook_xreq_unstore(const struct afb_xreq *xreq);
158 extern void afb_hook_xreq_subcall_req(const struct afb_xreq *xreq, const char *api, const char *verb, struct json_object *args);
159 extern void afb_hook_xreq_subcall_req_result(const struct afb_xreq *xreq, int status, struct json_object *result);
160 extern int afb_hook_xreq_has_permission(const struct afb_xreq *xreq, const char *permission, int result);
162 /*********************************************************
163 * section hooking ditf (daemon interface)
164 *********************************************************/
166 #define afb_hook_flag_ditf_vverbose 0x000001
167 #define afb_hook_flag_ditf_event_make 0x000002
168 #define afb_hook_flag_ditf_event_broadcast_before 0x000004
169 #define afb_hook_flag_ditf_event_broadcast_after 0x000008
170 #define afb_hook_flag_ditf_get_event_loop 0x000010
171 #define afb_hook_flag_ditf_get_user_bus 0x000020
172 #define afb_hook_flag_ditf_get_system_bus 0x000040
173 #define afb_hook_flag_ditf_rootdir_get_fd 0x000080
174 #define afb_hook_flag_ditf_rootdir_open_locale 0x000100
175 #define afb_hook_flag_ditf_queue_job 0x000200
176 #define afb_hook_flag_ditf_unstore_req 0x000400
177 #define afb_hook_flag_ditf_require_api 0x000800
178 #define afb_hook_flag_ditf_require_api_result 0x001000
179 #define afb_hook_flag_ditf_rename_api 0x002000
181 #define afb_hook_flags_ditf_common (afb_hook_flag_ditf_vverbose\
182 |afb_hook_flag_ditf_event_make\
183 |afb_hook_flag_ditf_event_broadcast_before\
184 |afb_hook_flag_ditf_event_broadcast_after\
185 |afb_hook_flag_ditf_rename_api)
186 #define afb_hook_flags_ditf_extra (afb_hook_flag_ditf_get_event_loop\
187 |afb_hook_flag_ditf_get_user_bus\
188 |afb_hook_flag_ditf_get_system_bus\
189 |afb_hook_flag_ditf_rootdir_get_fd\
190 |afb_hook_flag_ditf_rootdir_open_locale\
191 |afb_hook_flag_ditf_queue_job\
192 |afb_hook_flag_ditf_unstore_req\
193 |afb_hook_flag_ditf_require_api\
194 |afb_hook_flag_ditf_require_api_result)
196 #define afb_hook_flags_ditf_all (afb_hook_flags_ditf_common|afb_hook_flags_ditf_extra)
198 struct afb_hook_ditf_itf {
199 void (*hook_ditf_event_broadcast_before)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *name, struct json_object *object);
200 void (*hook_ditf_event_broadcast_after)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *name, struct json_object *object, int result);
201 void (*hook_ditf_get_event_loop)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, struct sd_event *result);
202 void (*hook_ditf_get_user_bus)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, struct sd_bus *result);
203 void (*hook_ditf_get_system_bus)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, struct sd_bus *result);
204 void (*hook_ditf_vverbose)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, int level, const char *file, int line, const char *function, const char *fmt, va_list args);
205 void (*hook_ditf_event_make)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *name, struct afb_event result);
206 void (*hook_ditf_rootdir_get_fd)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, int result);
207 void (*hook_ditf_rootdir_open_locale)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *filename, int flags, const char *locale, int result);
208 void (*hook_ditf_queue_job)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, void (*callback)(int signum, void *arg), void *argument, void *group, int timeout, int result);
209 void (*hook_ditf_unstore_req)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, struct afb_stored_req *sreq);
210 void (*hook_ditf_require_api)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *name, int initialized);
211 void (*hook_ditf_require_api_result)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *name, int initialized, int result);
212 void (*hook_ditf_rename_api)(void *closure, const struct afb_hookid *hookid, const struct afb_ditf *ditf, const char *oldname, const char *newname, int result);
215 extern void afb_hook_ditf_event_broadcast_before(const struct afb_ditf *ditf, const char *name, struct json_object *object);
216 extern int afb_hook_ditf_event_broadcast_after(const struct afb_ditf *ditf, const char *name, struct json_object *object, int result);
217 extern struct sd_event *afb_hook_ditf_get_event_loop(const struct afb_ditf *ditf, struct sd_event *result);
218 extern struct sd_bus *afb_hook_ditf_get_user_bus(const struct afb_ditf *ditf, struct sd_bus *result);
219 extern struct sd_bus *afb_hook_ditf_get_system_bus(const struct afb_ditf *ditf, struct sd_bus *result);
220 extern void afb_hook_ditf_vverbose(const struct afb_ditf *ditf, int level, const char *file, int line, const char *function, const char *fmt, va_list args);
221 extern struct afb_event afb_hook_ditf_event_make(const struct afb_ditf *ditf, const char *name, struct afb_event result);
222 extern int afb_hook_ditf_rootdir_get_fd(const struct afb_ditf *ditf, int result);
223 extern int afb_hook_ditf_rootdir_open_locale(const struct afb_ditf *ditf, const char *filename, int flags, const char *locale, int result);
224 extern int afb_hook_ditf_queue_job(const struct afb_ditf *ditf, void (*callback)(int signum, void *arg), void *argument, void *group, int timeout, int result);
225 extern void afb_hook_ditf_unstore_req(const struct afb_ditf *ditf, struct afb_stored_req *sreq);
226 extern void afb_hook_ditf_require_api(const struct afb_ditf *ditf, const char *name, int initialized);
227 extern int afb_hook_ditf_require_api_result(const struct afb_ditf *ditf, const char *name, int initialized, int result);
228 extern int afb_hook_ditf_rename_api(const struct afb_ditf *ditf, const char *oldname, const char *newname, int result);
230 extern int afb_hook_flags_ditf(const char *api);
231 extern struct afb_hook_ditf *afb_hook_create_ditf(const char *api, int flags, struct afb_hook_ditf_itf *itf, void *closure);
232 extern struct afb_hook_ditf *afb_hook_addref_ditf(struct afb_hook_ditf *hook);
233 extern void afb_hook_unref_ditf(struct afb_hook_ditf *hook);
235 /*********************************************************
236 * section hooking svc (service interface)
237 *********************************************************/
239 #define afb_hook_flag_svc_start_before 0x000001
240 #define afb_hook_flag_svc_start_after 0x000002
241 #define afb_hook_flag_svc_on_event_before 0x000004
242 #define afb_hook_flag_svc_on_event_after 0x000008
243 #define afb_hook_flag_svc_call 0x000010
244 #define afb_hook_flag_svc_call_result 0x000020
245 #define afb_hook_flag_svc_callsync 0x000040
246 #define afb_hook_flag_svc_callsync_result 0x000080
248 #define afb_hook_flags_svc_all (afb_hook_flag_svc_start_before|afb_hook_flag_svc_start_after\
249 |afb_hook_flag_svc_on_event_before|afb_hook_flag_svc_on_event_after\
250 |afb_hook_flag_svc_call|afb_hook_flag_svc_call_result\
251 |afb_hook_flag_svc_callsync|afb_hook_flag_svc_callsync_result)
253 struct afb_hook_svc_itf {
254 void (*hook_svc_start_before)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc);
255 void (*hook_svc_start_after)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, int status);
256 void (*hook_svc_on_event_before)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, const char *event, int eventid, struct json_object *object);
257 void (*hook_svc_on_event_after)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, const char *event, int eventid, struct json_object *object);
258 void (*hook_svc_call)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, const char *api, const char *verb, struct json_object *args);
259 void (*hook_svc_call_result)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, int status, struct json_object *result);
260 void (*hook_svc_callsync)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, const char *api, const char *verb, struct json_object *args);
261 void (*hook_svc_callsync_result)(void *closure, const struct afb_hookid *hookid, const struct afb_svc *svc, int status, struct json_object *result);
264 extern void afb_hook_svc_start_before(const struct afb_svc *svc);
265 extern int afb_hook_svc_start_after(const struct afb_svc *svc, int status);
266 extern void afb_hook_svc_on_event_before(const struct afb_svc *svc, const char *event, int eventid, struct json_object *object);
267 extern void afb_hook_svc_on_event_after(const struct afb_svc *svc, const char *event, int eventid, struct json_object *object);
268 extern void afb_hook_svc_call(const struct afb_svc *svc, const char *api, const char *verb, struct json_object *args);
269 extern void afb_hook_svc_call_result(const struct afb_svc *svc, int status, struct json_object *result);
270 extern void afb_hook_svc_callsync(const struct afb_svc *svc, const char *api, const char *verb, struct json_object *args);
271 extern int afb_hook_svc_callsync_result(const struct afb_svc *svc, int status, struct json_object *result);
273 extern int afb_hook_flags_svc(const char *api);
274 extern struct afb_hook_svc *afb_hook_create_svc(const char *api, int flags, struct afb_hook_svc_itf *itf, void *closure);
275 extern struct afb_hook_svc *afb_hook_addref_svc(struct afb_hook_svc *hook);
276 extern void afb_hook_unref_svc(struct afb_hook_svc *hook);
278 /*********************************************************
279 * section hooking evt (event interface)
280 *********************************************************/
282 #define afb_hook_flag_evt_create 0x000001
283 #define afb_hook_flag_evt_push_before 0x000002
284 #define afb_hook_flag_evt_push_after 0x000004
285 #define afb_hook_flag_evt_broadcast_before 0x000008
286 #define afb_hook_flag_evt_broadcast_after 0x000010
287 #define afb_hook_flag_evt_name 0x000020
288 #define afb_hook_flag_evt_drop 0x000040
290 #define afb_hook_flags_evt_common (afb_hook_flag_evt_push_before|afb_hook_flag_evt_broadcast_before)
291 #define afb_hook_flags_evt_extra (afb_hook_flags_evt_common\
292 |afb_hook_flag_evt_push_after|afb_hook_flag_evt_broadcast_after\
293 |afb_hook_flag_evt_create|afb_hook_flag_evt_drop)
294 #define afb_hook_flags_evt_all (afb_hook_flags_evt_extra|afb_hook_flag_evt_name)
296 struct afb_hook_evt_itf {
297 void (*hook_evt_create)(void *closure, const struct afb_hookid *hookid, const char *evt, int id);
298 void (*hook_evt_push_before)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj);
299 void (*hook_evt_push_after)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj, int result);
300 void (*hook_evt_broadcast_before)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj);
301 void (*hook_evt_broadcast_after)(void *closure, const struct afb_hookid *hookid, const char *evt, int id, struct json_object *obj, int result);
302 void (*hook_evt_name)(void *closure, const struct afb_hookid *hookid, const char *evt, int id);
303 void (*hook_evt_drop)(void *closure, const struct afb_hookid *hookid, const char *evt, int id);
306 extern void afb_hook_evt_create(const char *evt, int id);
307 extern void afb_hook_evt_push_before(const char *evt, int id, struct json_object *obj);
308 extern int afb_hook_evt_push_after(const char *evt, int id, struct json_object *obj, int result);
309 extern void afb_hook_evt_broadcast_before(const char *evt, int id, struct json_object *obj);
310 extern int afb_hook_evt_broadcast_after(const char *evt, int id, struct json_object *obj, int result);
311 extern void afb_hook_evt_name(const char *evt, int id);
312 extern void afb_hook_evt_drop(const char *evt, int id);
314 extern int afb_hook_flags_evt(const char *name);
315 extern struct afb_hook_evt *afb_hook_create_evt(const char *pattern, int flags, struct afb_hook_evt_itf *itf, void *closure);
316 extern struct afb_hook_evt *afb_hook_addref_evt(struct afb_hook_evt *hook);
317 extern void afb_hook_unref_evt(struct afb_hook_evt *hook);
319 /*********************************************************
320 * section hooking global (global interface)
321 *********************************************************/
323 #define afb_hook_flag_global_vverbose 0x000001
325 #define afb_hook_flags_global_all (afb_hook_flag_global_vverbose)
327 struct afb_hook_global_itf {
328 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);
331 extern struct afb_hook_global *afb_hook_create_global(int flags, struct afb_hook_global_itf *itf, void *closure);
332 extern struct afb_hook_global *afb_hook_addref_global(struct afb_hook_global *hook);
333 extern void afb_hook_unref_global(struct afb_hook_global *hook);