GLib ConnMan interface library ---------------------------- Derived from AGL network binding source at [https://git.automotivelinux.org/apps/agl-service-network/] Source refactoring from the binding (not necessarily exhaustive): * network-api.c -> api.c, call_work.c * network-connman.c -> connman-call.c * network-common.h -> common.h, connman-call.h, call_work.h * network-util.c -> mostly redundant, required things moved to api.c, connman-call.c Copyright dates in files reflect their original creation dates and include revisions made in agl-service-network before December 2021. Building -------- The build requirements are: * glib 2.0 headers and libraries (from e.g. glib2-devel on Fedora or CentOS, libglib2.0-dev on Debian or Ubuntu). * meson To build: ``` meson build/ ninja -C build/ ``` Usage Notes ----------- * Users only need include `connman-glib.h` and link to the library. * API calls generally return a gboolean, with `FALSE` indicating failure. * `connman_init` must be called before any other API calls except `connman_set_log_level` or one of the callback registration functions (e.g. `connman_add_manager_event_callback`). * A return code of `TRUE` from `connman_init` indicates D-Bus connection to **ConnMan** has succeeded. * Callbacks may be registered after calling `connman_init`, but note that there is a possibility that registration calls may briefly block if they occur during processing of an associated event. * It is advised that only one primary user of the library enable agent support to avoid conflicts. Contributing ------------ Questions can be sent to the agl-dev-community mailing list at . Bugs can be filed on the AGL JIRA instance at . Source contributions need to go through the AGL Gerrit instance, see .