libkirmes

A Rust and C implementation of the IPC protocol for the systemd userdb Varlink interface. kirmes provides a safe, async Rust API talking to systemd's userdb. In addition it provides a C API to communicate over Varlink or just parse JSON records for users and groups.

The Varlink communication is handled by zlink.

[!WARNING] This software is alpha stage, the API still have breaking changes.

Overview

The User/Group Record Lookup API via Varlink allows applications to query user and group records from local services such as systemd-userdbd. It replaces the role of getpwnam(3) and the glibc NSS interface with a JSON-based protocol that supports extensible user/group records and streaming enumeration.

Features

Async Rust API (works with any async runtime, e.g. tokio)
Client tool to query systemd-userdbd
Blocking C API with support for querying and enumerating records
JSON parsing for user records and group records in both Rust and C

Documentation

JSON User Records -- field reference for user records
JSON Group Records -- field reference for group records
User/Group Lookup API via Varlink -- the Varlink protocol

License

LGPL-2.1-or-later

Contributing