2 * Copyright (C) 2016-2019 "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.
26 #ifndef AFB_BINDING_VERSION
27 # define AFB_BINDING_VERSION 3
30 /* check the version */
31 #if AFB_BINDING_VERSION < 3
32 # error "AFB_BINDING_VERSION must be at least 3"
35 /* get C definitions of bindings */
37 #include <afb/afb-binding.h>
41 /*************************************************************************/
42 /* pre-declaration of classes */
43 /*************************************************************************/
50 /*************************************************************************/
51 /* declaration of functions */
52 /*************************************************************************/
54 int broadcast_event(const char *name, json_object *object = nullptr);
56 event make_event(const char *name);
58 void verbose(int level, const char *file, int line, const char * func, const char *fmt, va_list args);
60 void verbose(int level, const char *file, int line, const char * func, const char *fmt, ...);
64 int rootdir_open_locale_fd(const char *filename, int flags, const char *locale = nullptr);
66 int queue_job(void (*callback)(int signum, void *arg), void *argument, void *group, int timeout);
68 int require_api(const char *apiname, bool initialized = true);
70 int add_alias(const char *apiname, const char *aliasname);
75 bool wants_warnings();
80 void call(const char *api, const char *verb, struct json_object *args, void (*callback)(void*closure, int iserror, struct json_object *result, afb_api_t api), void *closure);
82 template <class T> void call(const char *api, const char *verb, struct json_object *args, void (*callback)(T*closure, int iserror, struct json_object *result, afb_api_t api), T *closure);
84 bool callsync(const char *api, const char *verb, struct json_object *args, struct json_object *&result);
86 /*************************************************************************/
87 /* effective declaration of classes */
88 /*************************************************************************/
96 using call_cb = void (*)(void *closure, struct json_object *object, const char *error, const char *info, afb_api_t api);
97 using queue_cb = void (*)(int signum, void *arg);
98 using event_cb = void (*)(void *, const char *, struct json_object *, afb_api_t);
99 using preinit_cb = int (*)(void *, afb_api_t);
100 using verb_cb = void (*)(afb_req_t req);
101 using onevent_cb = void (*)(afb_api_t api, const char *event, struct json_object *object);
102 using oninit_cb = int (*)(afb_api_t api);
106 api(const api &other) = delete;
109 api &operator=(const api &other) = delete;
110 api &operator=(api &&other);
112 operator afb_api_t() const;
113 afb_api_t operator->() const;
115 /* General functions */
116 const char *name() const;
117 void *get_userdata() const;
118 void set_userdata(void *value) const;
119 int require_api(const char *name, int initialized) const;
120 int require_api(const std::string &name, int initialized) const;
122 /* Verbosity functions */
123 int wants_log_level(int level) const;
124 void vverbose(int level, const char *file, int line, const char *func, const char *fmt, va_list args) const;
125 void verbose(int level, const char *file, int line, const char *func, const char *fmt, ...) const;
127 /* Data retrieval functions */
128 int rootdir_get_fd() const;
129 int rootdir_open_locale(const char *filename, int flags, const char *locale) const;
130 int rootdir_open_locale(const std::string &filename, int flags, const std::string &locale) const;
131 struct json_object *settings() const;
133 /* Calls and job functions */
134 void call(const char *apiname, const char *verb, struct json_object *args, call_cb callback, void *closure) const;
135 void call(const std::string &apiname, const std::string &verb, struct json_object *args, call_cb callback, void *closure) const;
136 int call_sync(const char *apiname, const char *verb, struct json_object *args, struct json_object **object, char **error, char **info) const;
137 int call_sync(const std::string &apiname, const std::string &verb, struct json_object *args, struct json_object **object, std::string &error, std::string &info) const;
138 int queue_job(queue_cb callback, void *argument, void *group, int timeout) const;
140 /* Event functions */
141 int broadcast_event(const char *name, struct json_object *object) const;
142 int broadcast_event(const std::string &name, struct json_object *object) const;
143 event make_event(const char *name) const;
144 event make_event(const std::string &name) const;
145 int event_handler_add(const char *pattern, event_cb callback, void *closure) const;
146 int event_handler_add(const std::string &pattern, event_cb callback, void *closure) const;
147 int event_handler_del(const char *pattern, void **closure) const;
148 int event_handler_del(const std::string &pattern, void **closure) const;
150 /* Systemd functions */
151 struct sd_event *get_event_loop() const;
152 struct sd_bus *get_user_bus() const;
153 struct sd_bus *get_system_bus() const;
155 /* Dynamic api functions */
156 api new_api(const char *apiname, const char *info, int noconcurrency, preinit_cb preinit, void *closure) const;
157 api new_api(const std::string &apiname, const std::string &info, int noconcurrency, preinit_cb preinit, void *closure) const;
158 int set_verbs(const struct afb_verb_v2 *verbs) const;
159 int set_verbs(const struct afb_verb_v3 *verbs) const;
160 int add_verb(const char *verb, const char *info, verb_cb callback, void *vcbdata, const struct afb_auth *auth, uint32_t session, int glob) const;
161 int add_verb(const std::string &verb, const std::string &info, verb_cb callback, void *vcbdata, const struct afb_auth *auth, uint32_t session, int glob) const;
162 int del_verb(const char *verb, void **vcbdata) const;
163 int del_verb(const std::string &verb, void **vcbdata) const;
164 int on_event(onevent_cb onevent) const;
165 int on_init(oninit_cb oninit) const;
166 int provide_class(const char *name) const;
167 int provide_class(const std::string &name) const;
168 int require_class(const char *name) const;
169 int require_class(const std::string &name) const;
171 int delete_api() const;
172 int add_alias(const char *name, const char *as_name) const;
173 int add_alias(const std::string &name, const std::string &as_name) const;
182 event(afb_event_t e);
183 event(const event &other);
184 event(event &&other);
186 event &operator=(const event &other);
187 event &operator=(event &&other);
189 operator afb_event_t() const;
190 afb_event_t operator->() const;
192 operator bool() const;
193 bool is_valid() const;
195 int broadcast(json_object *object) const;
196 int push(json_object *object) const;
200 const char *name() const;
209 arg(const struct afb_arg &a);
210 arg(const arg &other);
211 arg &operator=(const arg &other);
213 operator const struct afb_arg&() const;
215 bool has_name() const;
216 bool has_value() const;
217 bool has_path() const;
219 const char *name() const;
220 const char *value() const;
221 const char *path() const;
232 req(const req &other);
233 req &operator=(const req &other);
235 operator afb_req_t() const;
236 afb_req_t operator->() const;
238 operator bool() const;
239 bool is_valid() const;
241 arg get(const char *name) const;
243 const char *value(const char *name) const;
245 const char *path(const char *name) const;
247 json_object *json() const;
249 void reply(json_object *obj = nullptr, const char *error = nullptr, const char *info = nullptr) const;
250 void replyf(json_object *obj, const char *error, const char *info, ...) const;
251 void replyv(json_object *obj, const char *error, const char *info, va_list args) const;
253 void success(json_object *obj = nullptr, const char *info = nullptr) const;
254 void successf(json_object *obj, const char *info, ...) const;
255 void successv(json_object *obj, const char *info, va_list args) const;
257 void fail(const char *error = "failed", const char *info = nullptr) const;
258 void failf(const char *error, const char *info, ...) const;
259 void failv(const char *error, const char *info, va_list args) const;
265 void session_close() const;
267 bool session_set_LOA(unsigned level) const;
269 bool subscribe(const event &event) const;
271 bool unsubscribe(const event &event) const;
273 void subcall(const char *api, const char *verb, json_object *args, void (*callback)(void *closure, int iserror, json_object *result, afb_req_t req), void *closure) const;
274 template <class T> void subcall(const char *api, const char *verb, json_object *args, void (*callback)(T *closure, int iserror, json_object *result, afb_req_t req), T *closure) const;
276 bool subcallsync(const char *api, const char *verb, json_object *args, struct json_object *&result) const;
278 void subcall(const char *api, const char *verb, json_object *args, int flags, void (*callback)(void *closure, json_object *object, const char *error, const char *info, afb_req_t req), void *closure) const;
280 template <class T> void subcall(const char *api, const char *verb, json_object *args, int flags, void (*callback)(T *closure, json_object *object, const char *error, const char *info, afb_req_t req), T *closure) const;
282 bool subcallsync(const char *api, const char *verb, json_object *args, int flags, struct json_object *&object, char *&error, char *&info) const;
284 void verbose(int level, const char *file, int line, const char * func, const char *fmt, va_list args) const;
286 void verbose(int level, const char *file, int line, const char * func, const char *fmt, ...) const;
288 bool has_permission(const char *permission) const;
290 char *get_application_id() const;
294 json_object *get_client_info() const;
296 template < class T = void >
301 contextclass(afb_req_t r) : req_(r) {}
304 inline operator T *() const { return get(); }
305 inline operator T &() const { return *get(); }
306 inline T* get() const {
307 return reinterpret_cast<T*>(
308 afb_req_context(req_, 0,
314 inline void set(T *value, void (*destroyer)(T*) = [](T*t){delete t;}) const {
315 afb_req_context(req_, 1,
317 reinterpret_cast<void(*)(void*)>(destroyer),
318 reinterpret_cast<void*>(value));
321 inline void unset() { set(nullptr); }
322 inline void clear() { set(nullptr); }
324 inline T *lazy(T *(*allocator)() = []()->T*{return new T();}, void (*destroyer)(T*) = [](T*t){delete t;}) const {
325 return reinterpret_cast<T*>(
326 afb_req_context(req_, 0,
327 [allocator](void*)->T*{return allocator();},
328 reinterpret_cast<void(*)(void*)>(destroyer),
333 inline T *lazy(I *i, T *(*allocator)(I*) = [](I*i)->T*{return new T(i);}, void (*destroyer)(T*) = [](T*t){delete t;}) const {
334 return reinterpret_cast<T*>(
335 afb_req_context(req_, 0,
336 [allocator](void*i)->T*{return allocator(reinterpret_cast<I*>(i));},
337 reinterpret_cast<void(*)(void*)>(destroyer),
338 reinterpret_cast<void*>(i)));
342 template < class T > contextclass<T> context() const { return contextclass<T>(req_); }
345 /*************************************************************************/
346 /* effective declaration of classes */
347 /*************************************************************************/
348 /////////////////////////////////////////////////////////////////////////////////////////////////////
349 /////////////////////////////////////////////////////////////////////////////////////////////////////
350 /////////////////////////////////////////////////////////////////////////////////////////////////////
351 /////////////////////////////////////////////////////////////////////////////////////////////////////
352 /////////////////////////////////////////////////////////////////////////////////////////////////////
353 /////////////////////////////////////////////////////////////////////////////////////////////////////
354 /////////////////////////////////////////////////////////////////////////////////////////////////////
355 /////////////////////////////////////////////////////////////////////////////////////////////////////
356 /////////////////////////////////////////////////////////////////////////////////////////////////////
357 /////////////////////////////////////////////////////////////////////////////////////////////////////
358 /////////////////////////////////////////////////////////////////////////////////////////////////////
359 /////////////////////////////////////////////////////////////////////////////////////////////////////
360 /////////////////////////////////////////////////////////////////////////////////////////////////////
361 /////////////////////////////////////////////////////////////////////////////////////////////////////
362 /////////////////////////////////////////////////////////////////////////////////////////////////////
363 /////////////////////////////////////////////////////////////////////////////////////////////////////
366 /*************************************************************************/
367 /* effective declaration of classes */
368 /*************************************************************************/
371 inline api::api() : api_{nullptr} { }
372 inline api::api(afb_api_t a) : api_{a} { }
373 inline api::api(api &&other) : api_{other.api_} { other.api_ = nullptr; }
374 inline api::~api() { api_ = nullptr; }
375 inline api &api::operator=(api &&other) { api_ = other.api_; other.api_ = nullptr; return *this;}
376 inline api::operator afb_api_t() const { return api_; }
377 inline afb_api_t api::operator->() const { return api_; }
378 inline const char *api::name() const { return afb_api_name(api_); }
379 inline void *api::get_userdata() const { return afb_api_get_userdata(api_); }
380 inline void api::set_userdata(void *value) const { afb_api_set_userdata(api_, value); }
381 inline int api::require_api(const char *name, int initialized) const { return afb_api_require_api(api_, name, initialized); }
382 inline int api::require_api(const std::string& name, int initialized) const { return afb_api_require_api(api_, name.c_str(), initialized); }
383 inline int api::wants_log_level(int level) const { return afb_api_wants_log_level(api_, level); }
384 inline void api::vverbose(int level, const char *file, int line, const char *func, const char *fmt, va_list args) const { afb_api_vverbose(api_, level, file, line, func, fmt, args); }
385 inline void api::verbose(int level, const char *file, int line, const char *func, const char *fmt, ...) const
389 vverbose(level, file, line, func, fmt, args);
392 inline int api::rootdir_get_fd() const { return afb_api_rootdir_get_fd(api_); }
393 inline int api::rootdir_open_locale(const char *filename, int flags, const char *locale) const { return afb_api_rootdir_open_locale(api_, filename, flags, locale); }
394 inline int api::rootdir_open_locale(const std::string &filename, int flags, const std::string &locale) const { return afb_api_rootdir_open_locale(api_, filename.c_str(), flags, locale.c_str()); }
395 inline struct json_object *api::settings() const { return afb_api_settings(api_); }
396 inline void api::call(const char *apiname, const char *verb, struct json_object *args, call_cb callback, void *closure) const { afb_api_call(api_, apiname, verb, args, callback, closure); }
397 inline void api::call(const std::string &apiname, const std::string &verb, struct json_object *args, call_cb callback, void *closure) const { afb_api_call(api_, apiname.c_str(), verb.c_str(), args, callback, closure); }
398 inline int api::call_sync(const char *apiname, const char *verb, struct json_object *args, struct json_object **object, char **error, char **info) const { return afb_api_call_sync(api_, apiname, verb, args, object, error, info); }
399 inline int api::call_sync(const std::string &apiname, const std::string &verb, struct json_object *args, struct json_object **object, std::string &error, std::string& info) const
402 int ret = afb_api_call_sync(api_, apiname.c_str(), verb.c_str(), args, object, &err, &inf);
407 inline int api::queue_job(queue_cb callback, void *argument, void *group, int timeout) const { return afb_api_queue_job(api_, callback, argument, group, timeout); }
408 inline int api::broadcast_event(const char *name, struct json_object *object) const { return afb_api_broadcast_event(api_, name, object); }
409 inline int api::broadcast_event(const std::string &name, struct json_object *object) const { return afb_api_broadcast_event(api_, name.c_str(), object); }
410 inline event api::make_event(const char *name) const { return event(afb_api_make_event(api_, name)); }
411 inline event api::make_event(const std::string &name) const { return event(afb_api_make_event(api_, name.c_str())); }
412 inline int api::event_handler_add(const char *pattern, event_cb callback, void *closure) const { return afb_api_event_handler_add(api_, pattern, callback, closure); }
413 inline int api::event_handler_add(const std::string &pattern, event_cb callback, void *closure) const { return afb_api_event_handler_add(api_, pattern.c_str(), callback, closure); }
414 inline int api::event_handler_del(const char *pattern, void **closure) const { return afb_api_event_handler_del(api_, pattern, closure); }
415 inline int api::event_handler_del(const std::string &pattern, void **closure) const { return afb_api_event_handler_del(api_, pattern.c_str(), closure); }
416 inline struct sd_event *api::get_event_loop() const { return afb_api_get_event_loop(api_); }
417 inline struct sd_bus *api::get_user_bus() const { return afb_api_get_user_bus(api_); }
418 inline struct sd_bus *api::get_system_bus() const { return afb_api_get_system_bus(api_); }
419 inline api api::new_api(const char *apiname, const char *info, int noconcurrency, preinit_cb preinit, void *closure) const { return api(afb_api_new_api(api_, apiname, info, noconcurrency, preinit, closure)); }
420 inline api api::new_api(const std::string &apiname, const std::string &info, int noconcurrency, preinit_cb preinit, void *closure) const { return api(afb_api_new_api(api_, apiname.c_str(), info.c_str(), noconcurrency, preinit, closure)); }
421 inline int api::set_verbs(const struct afb_verb_v2 *verbs) const { return afb_api_set_verbs_v2(api_, verbs); }
422 inline int api::set_verbs(const struct afb_verb_v3 *verbs) const { return afb_api_set_verbs_v3(api_, verbs); }
423 inline int api::add_verb(const char *verb, const char *info, verb_cb callback, void *vcbdata, const struct afb_auth *auth, uint32_t session, int glob) const { return afb_api_add_verb(api_, verb, info, callback, vcbdata, auth, session, glob); }
424 inline int api::add_verb(const std::string &verb, const std::string &info, verb_cb callback, void *vcbdata, const struct afb_auth *auth, uint32_t session, int glob) const { return afb_api_add_verb(api_, verb.c_str(), info.c_str(), callback, vcbdata, auth, session, glob); }
425 inline int api::del_verb(const char *verb, void **vcbdata) const { return afb_api_del_verb(api_, verb, vcbdata); }
426 inline int api::del_verb(const std::string &verb, void **vcbdata) const { return afb_api_del_verb(api_, verb.c_str(), vcbdata); }
427 inline int api::on_event(onevent_cb onevent) const { return afb_api_on_event(api_, onevent); }
428 inline int api::on_init(oninit_cb oninit) const { return afb_api_on_init(api_, oninit); }
429 inline int api::provide_class(const char *name) const { return afb_api_provide_class(api_, name); }
430 inline int api::provide_class(const std::string &name) const { return afb_api_provide_class(api_, name.c_str()); }
431 inline int api::require_class(const char *name) const { return afb_api_require_class(api_, name); }
432 inline int api::require_class(const std::string &name) const { return afb_api_require_class(api_, name.c_str()); }
433 inline void api::seal() const { afb_api_seal(api_); }
434 inline int api::delete_api() const { return afb_api_delete_api(api_); }
435 inline int api::add_alias(const char *name, const char *as_name) const { return afb_api_add_alias(api_, name, as_name); }
436 inline int api::add_alias(const std::string &name, const std::string &as_name) const { return afb_api_add_alias(api_, name.c_str(), as_name.c_str()); }
439 inline event::event() : event_{nullptr} { }
440 inline event::event(afb_event_t e) : event_{e} { }
441 inline event::event(event &&other) : event_{other.event_} { other.event_ = nullptr; }
442 inline event::event(const event &other) : event_{other.event_} { addref(); }
443 inline event::~event() { unref(); }
444 inline event &event::operator=(const event &other) { event_ = other.event_; return *this; }
445 inline event &event::operator=(event &&other) { event_ = other.event_; other.event_ = nullptr; return *this;}
447 inline event::operator afb_event_t() const { return event_; }
448 inline afb_event_t event::operator->() const { return event_; }
450 inline event::operator bool() const { return is_valid(); }
451 inline bool event::is_valid() const { return afb_event_is_valid(event_); }
453 inline int event::broadcast(json_object *object) const { return afb_event_broadcast(event_, object); }
454 inline int event::push(json_object *object) const { return afb_event_push(event_, object); }
456 inline void event::unref() { if (event_) { afb_event_unref(event_); } event_ = nullptr; }
457 inline void event::addref() { afb_event_addref(event_); }
458 inline const char *event::name() const { return afb_event_name(event_); }
461 inline arg::arg(const struct afb_arg &a) : arg_(a) {}
462 inline arg::arg(const arg &other) : arg_(other.arg_) {}
463 inline arg &arg::operator=(const arg &other) { arg_ = other.arg_; return *this; }
465 inline arg::operator const struct afb_arg&() const { return arg_; }
467 inline bool arg::has_name() const { return !!arg_.name; }
468 inline bool arg::has_value() const { return !!arg_.value; }
469 inline bool arg::has_path() const { return !!arg_.path; }
471 inline const char *arg::name() const { return arg_.name; }
472 inline const char *arg::value() const { return arg_.value; }
473 inline const char *arg::path() const { return arg_.path; }
477 inline req::req(afb_req_t r) : req_(r) {}
478 inline req::req(const req &other) : req_(other.req_) {}
479 inline req &req::operator=(const req &other) { req_ = other.req_; return *this; }
481 inline req::operator afb_req_t() const { return req_; }
482 inline afb_req_t req::operator->() const { return req_; }
484 inline req::operator bool() const { return is_valid(); }
485 inline bool req::is_valid() const { return afb_req_is_valid(req_); }
487 inline arg req::get(const char *name) const { return arg(afb_req_get(req_, name)); }
489 inline const char *req::value(const char *name) const { return afb_req_value(req_, name); }
491 inline const char *req::path(const char *name) const { return afb_req_path(req_, name); }
493 inline json_object *req::json() const { return afb_req_json(req_); }
495 inline void req::reply(json_object *obj, const char *error, const char *info) const { afb_req_reply(req_, obj, error, info); }
496 inline void req::replyv(json_object *obj, const char *error, const char *info, va_list args) const { afb_req_reply_v(req_, obj, error, info, args); }
497 inline void req::replyf(json_object *obj, const char *error, const char *info, ...) const
500 va_start(args, info);
501 replyv(obj, error, info, args);
505 inline void req::success(json_object *obj, const char *info) const { reply(obj, nullptr, info); }
506 inline void req::successv(json_object *obj, const char *info, va_list args) const { replyv(obj, nullptr, info, args); }
507 inline void req::successf(json_object *obj, const char *info, ...) const
510 va_start(args, info);
511 successv(obj, info, args);
515 inline void req::fail(const char *error, const char *info) const { reply(nullptr, error, info); }
516 inline void req::failv(const char *error, const char *info, va_list args) const { replyv(nullptr, error, info, args); }
517 inline void req::failf(const char *error, const char *info, ...) const
520 va_start(args, info);
521 failv(error, info, args);
525 inline void req::addref() const { afb_req_addref(req_); }
527 inline void req::unref() const { afb_req_unref(req_); }
529 inline void req::session_close() const { afb_req_session_close(req_); }
531 inline bool req::session_set_LOA(unsigned level) const { return !afb_req_session_set_LOA(req_, level); }
533 inline bool req::subscribe(const event &event) const { return !afb_req_subscribe(req_, event); }
535 inline bool req::unsubscribe(const event &event) const { return !afb_req_unsubscribe(req_, event); }
537 inline void req::subcall(const char *api, const char *verb, json_object *args, int flags, void (*callback)(void *closure, json_object *result, const char *error, const char *info, afb_req_t req), void *closure) const
539 afb_req_subcall(req_, api, verb, args, flags, callback, closure);
543 inline void req::subcall(const char *api, const char *verb, json_object *args, int flags, void (*callback)(T *closure, json_object *result, const char *error, const char *info, afb_req_t req), T *closure) const
545 subcall(api, verb, args, flags, reinterpret_cast<void(*)(void*,json_object*,const char*,const char*,afb_req_t)>(callback), reinterpret_cast<void*>(closure));
548 inline bool req::subcallsync(const char *api, const char *verb, json_object *args, int flags, struct json_object *&object, char *&error, char *&info) const
550 return !afb_req_subcall_sync(req_, api, verb, args, flags, &object, &error, &info);
553 inline void req::subcall(const char *api, const char *verb, json_object *args, void (*callback)(void *closure, int iserror, json_object *result, afb_req_t req), void *closure) const
555 afb_req_subcall_legacy(req_, api, verb, args, callback, closure);
559 inline void req::subcall(const char *api, const char *verb, json_object *args, void (*callback)(T *closure, int iserror, json_object *result, afb_req_t req), T *closure) const
561 subcall(api, verb, args, reinterpret_cast<void(*)(void*,int,json_object*,afb_req_t)>(callback), reinterpret_cast<void*>(closure));
564 inline bool req::subcallsync(const char *api, const char *verb, json_object *args, struct json_object *&result) const
566 return !afb_req_subcall_sync_legacy(req_, api, verb, args, &result);
569 inline void req::verbose(int level, const char *file, int line, const char * func, const char *fmt, va_list args) const
571 afb_req_verbose(req_, level, file, line, func, fmt, args);
574 inline void req::verbose(int level, const char *file, int line, const char * func, const char *fmt, ...) const
578 afb_req_verbose(req_, level, file, line, func, fmt, args);
582 inline bool req::has_permission(const char *permission) const
584 return bool(afb_req_has_permission(req_, permission));
587 inline char *req::get_application_id() const
589 return afb_req_get_application_id(req_);
592 inline int req::get_uid() const
594 return afb_req_get_uid(req_);
597 inline json_object *req::get_client_info() const
599 return afb_req_get_client_info(req_);
603 inline int broadcast_event(const char *name, json_object *object)
604 { return afb_daemon_broadcast_event(name, object); }
606 inline event make_event(const char *name)
607 { return afb_daemon_make_event(name); }
609 inline void verbose(int level, const char *file, int line, const char * func, const char *fmt, va_list args)
610 { afb_daemon_verbose(level, file, line, func, fmt, args); }
612 inline void verbose(int level, const char *file, int line, const char * func, const char *fmt, ...)
613 { va_list args; va_start(args, fmt); verbose(level, file, line, func, fmt, args); va_end(args); }
615 inline int rootdir_get_fd()
616 { return afb_daemon_rootdir_get_fd(); }
618 inline int rootdir_open_locale_fd(const char *filename, int flags, const char *locale)
619 { return afb_daemon_rootdir_open_locale(filename, flags, locale); }
621 inline int queue_job(void (*callback)(int signum, void *arg), void *argument, void *group, int timeout)
622 { return afb_daemon_queue_job(callback, argument, group, timeout); }
624 inline int require_api(const char *apiname, bool initialized)
625 { return afb_daemon_require_api(apiname, int(initialized)); }
627 inline int add_alias(const char *apiname, const char *aliasname)
628 { return afb_daemon_add_alias(apiname, aliasname); }
631 { return afb_get_logmask(); }
633 inline bool wants_errors()
634 { return AFB_SYSLOG_MASK_WANT_ERROR(logmask()); }
636 inline bool wants_warnings()
637 { return AFB_SYSLOG_MASK_WANT_WARNING(logmask()); }
639 inline bool wants_notices()
640 { return AFB_SYSLOG_MASK_WANT_NOTICE(logmask()); }
642 inline bool wants_infos()
643 { return AFB_SYSLOG_MASK_WANT_INFO(logmask()); }
645 inline bool wants_debugs()
646 { return AFB_SYSLOG_MASK_WANT_DEBUG(logmask()); }
648 inline void call(const char *api, const char *verb, struct json_object *args, void (*callback)(void*closure, struct json_object *result, const char *error, const char *info, afb_api_t api), void *closure)
650 afb_service_call(api, verb, args, callback, closure);
654 inline void call(const char *api, const char *verb, struct json_object *args, void (*callback)(T*closure, struct json_object *result, const char *error, const char *info, afb_api_t api), T *closure)
656 afb_service_call(api, verb, args, reinterpret_cast<void(*)(void*,json_object*,const char*, const char*,afb_api_t)>(callback), reinterpret_cast<void*>(closure));
659 inline bool callsync(const char *api, const char *verb, struct json_object *args, struct json_object *&result, char *&error, char *&info)
661 return !!afb_service_call_sync(api, verb, args, &result, &error, &info);
664 /*************************************************************************/
665 /* declaration of the binding's authorization s */
666 /*************************************************************************/
668 constexpr afb_auth auth_no()
670 afb_auth r = { afb_auth_No, {0}, nullptr};
671 r.type = afb_auth_No;
675 constexpr afb_auth auth_yes()
677 afb_auth r = { afb_auth_No, {0}, nullptr};
678 r.type = afb_auth_Yes;
682 constexpr afb_auth auth_token()
684 afb_auth r = { afb_auth_No, {0}, nullptr};
685 r.type = afb_auth_Token;
689 constexpr afb_auth auth_LOA(unsigned loa)
691 afb_auth r = { afb_auth_No, {0}, nullptr};
692 r.type = afb_auth_LOA;
697 constexpr afb_auth auth_permission(const char *permission)
699 afb_auth r = { afb_auth_No, {0}, nullptr};
700 r.type = afb_auth_Permission;
705 constexpr afb_auth auth_not(const afb_auth *other)
707 afb_auth r = { afb_auth_No, {0}, nullptr};
708 r.type = afb_auth_Not;
713 constexpr afb_auth auth_not(const afb_auth &other)
715 return auth_not(&other);
718 constexpr afb_auth auth_or(const afb_auth *first, const afb_auth *next)
720 afb_auth r = { afb_auth_No, {0}, nullptr};
721 r.type = afb_auth_Or;
727 constexpr afb_auth auth_or(const afb_auth &first, const afb_auth &next)
729 return auth_or(&first, &next);
732 constexpr afb_auth auth_and(const afb_auth *first, const afb_auth *next)
734 afb_auth r = { afb_auth_No, {0}, nullptr};
735 r.type = afb_auth_And;
741 constexpr afb_auth auth_and(const afb_auth &first, const afb_auth &next)
743 return auth_and(&first, &next);
746 constexpr afb_verb_t verb(
748 void (*callback)(afb_req_t),
749 const char *info = nullptr,
750 uint16_t session = 0,
751 const afb_auth *auth = nullptr,
753 void *vcbdata = nullptr
756 return { name, callback, auth, info, vcbdata, session, glob };
759 void __attribute__((weak)) __afb__verb__cb__for__global__(afb_req_t r)
762 void (*callback)(req);
764 vcbdata = afb_req_get_vcbdata(r);
765 callback = reinterpret_cast<void(*)(req)>(vcbdata);
769 constexpr afb_verb_t verb(
771 void (*callback)(req),
772 const char *info = nullptr,
773 uint16_t session = 0,
774 const afb_auth *auth = nullptr,
780 __afb__verb__cb__for__global__,
789 constexpr afb_verb_t verbend()
791 return { 0, 0, 0, 0, 0, 0, 0 };
794 constexpr afb_binding_t binding(
796 const afb_verb_t *verbs,
797 const char *info = nullptr,
798 int (*init)(afb_api_t) = nullptr,
799 const char *specification = nullptr,
800 void (*onevent)(afb_api_t, const char*, struct json_object*) = nullptr,
801 bool noconcurrency = false,
802 int (*preinit)(afb_api_t) = nullptr,
803 void *userdata = nullptr
807 name, specification, info, verbs, preinit, init, onevent, userdata,
808 nullptr, nullptr, nullptr, static_cast<unsigned int>(noconcurrency) };
811 /*************************************************************************/
813 /*************************************************************************/