Go to file
Alessandro Astone aa6bf8d637 Merge tag '1.1.42' into bullseye
[gbinder] JB#42956
2025-01-23 20:20:43 +01:00
debian Merge tag '1.1.42' into bullseye 2025-01-23 20:20:43 +01:00
include [gbinder] Added gbinder_reader_read_nullable_string8 2024-09-24 18:48:39 +03:00
misc [gbinder] Add model file for Coverity. JB#61912 2024-04-11 12:59:39 +02:00
rpm Version 1.1.42 2024-12-11 06:40:35 +02:00
src Merge pull request #133 from peat-psuwit/for-upstream/libgbinder-stability-android-rs 2024-12-10 18:47:26 +02:00
test [build] Support pkg-config cross-compilation 2023-11-30 20:54:40 +02:00
unit Merge pull request #133 from peat-psuwit/for-upstream/libgbinder-stability-android-rs 2024-12-10 18:47:26 +02:00
.abstruse.yml CI: add support for ubuntu mantic 2023-06-09 19:13:18 +02:00
.gitignore [packaging] Package binder-list and binder-ping tools. JB#42956 2020-07-31 01:28:51 +03:00
AUTHORS Acknowledge Ratchanan's contribution 2024-10-28 02:46:34 +02:00
LICENSE [license] Freshened up the license 2024-02-10 04:54:52 +02:00
Makefile Version 1.1.42 2024-12-11 06:40:35 +02:00
README [gbinder] Updated README 2021-12-27 15:12:46 +02:00
libgbinder.pc.in [gbinder] Respect arch specific lib dir. JB#49681 2020-06-03 01:47:58 +03:00

README

GLib-style interface to binder (Android IPC mechanism)

Key features:

1. Integration with GLib event loop
2. Detection of 32 vs 64 bit kernel at runtime
3. Asynchronous transactions that don't block the event thread
4. Stable service manager and low-level transaction APIs

Android keeps changing both low-level RPC and service manager
protocols from version to version. To counter that, libgbinder
implements configirable backends for different variants of those,
and yet keeping its own API unchanged.

Configuration is loaded from [Protocol] and [ServiceManager] sections
of /etc/gbinder.conf file. The keys are binder device names or the
special Default value, the value is the identifier of the protocol
or service manager variant, respectively.

In addition to reading /etc/gbinder.conf if it exists, /etc/gbinder.d
directory is scanned for .conf files, the file list is sorted, files are
loaded one by one, overwriting the entries loaded from /etc/gbinder.conf
or from the previously processed file.

Known protocol and service manager variants are aidl, aidl2, aidl3 and
hidl. This list is expected to expand further in the future. The default
configuration is as follows:

  [Protocol]
  Default = aidl
  /dev/binder = aidl
  /dev/hwbinder = hidl

  [ServiceManager]
  Default = aidl
  /dev/binder = aidl
  /dev/hwbinder = hidl

Alternatively and preferably, one can specify the desired Android API
level:

  [General]
  ApiLevel = 29

and let libgbinder pick the appropriate preset. Full list of presets can
be found in src/gbinder_config.c