# libxaal
A minimal xAAL library in C
Conforms to xAAL specification v0.5r2
Based on libjson-c (0.12.1), libuuid1 (2.29.1), libsodium (1.0.11)
(e.g. use debian packages: uuid-dev libjson-c-dev libsodium-dev)


The xAAL library is composed of  xaal.h  and  libxaal.c
It provides a minimal set of helpers for developping xAAL applications:

- xAAL_join_bus(): Join the multicast (IPv4 or IPv6) xAAL bus

- xAAL_pass2key(): Build a ciffering key from a passphrase

- xAAL_add_wanted_target() / xAAL_del_wanted_target(): Manage the list of
  wanted targets

- xAAL_read_bus(): Receive a message an parses header

- xAAL_free_msg(): Free data allocated by xAAL_read_bus() in case of success

- xAAL_write_bus() / xAAL_write_busv() / xAAL_write_busl(): Send a message on
  the bus (targets provided as a json array / as a vector  / as a (va_)list)

- xAAL_notify_alive() xAAL_reply_getDescription()
  xAAL_reply_getBusConfig() xAAL_reply_setBusConfig()
  Helpers to send classical replies

- xAAL_targets_match(): Test if an address belongs to the list of targets of a
  message

Note: the xAAL library uses the prefix 'xAAL_' as namesapce.


Copyright
- Christophe Lohr - IMT Atlantique - 2017
- The library is provided according to the termes of the
  GNU Lesser General Public License v3.0 and following
- Dual-licenses are accepted, contact us.