zbus_systemd 0.25901.0

A pure-Rust library to interact with systemd DBus services
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# zbus_systemd

[![crates.io](https://img.shields.io/crates/v/zbus_systemd.svg)](https://crates.io/crates/zbus_systemd)
[![Documentation](https://docs.rs/zbus_systemd/badge.svg)](https://docs.rs/zbus_systemd)

A pure-Rust library to interact with systemd DBus services.

`zbus_systemd` provides support for interacting with the suite of systemd
services over DBus. This crate tries to cover all systemd interfaces,
across all services.

## Auto-generated services

Each service has its own dedicated module, which is auto-generated from current
systemd definitions and can be activated through the corresponding Cargo feature:

 * `home1`: systemd-homed interfaces (org.freedesktop.home1)
 * `hostname1`: systemd-hostnamed interfaces (org.freedesktop.hostname1)
 * `import1`: systemd-importd interfaces (org.freedesktop.import1)
 * `locale1`: systemd-localed interfaces (org.freedesktop.locale1)
 * `login1`: systemd-logind interfaces (org.freedesktop.login1)
 * `machine1`: systemd-machined interfaces (org.freedesktop.machine1)
 * `network1`: systemd-networkd interfaces (org.freedesktop.network1)
 * `oom1`: systemd-oomd interfaces (org.freedesktop.oom1)
 * `portable1`: systemd-portabled interfaces (org.freedesktop.portable1)
 * `resolve1`: systemd-resolved interfaces (org.freedesktop.resolve1)
 * `systemd1`: systemd interfaces (org.freedesktop.systemd1)
 * `sysupdate1`: systemd-sysupdated interfaces (org.freedesktop.sysupdated1)
 * `timedate1`: systemd-timedated interfaces (org.freedesktop.timedate1)
 * `timesync1`: systemd-timesyncd interfaces (org.freedesktop.timesync1)

For a quickstart on how to use those interfaces, see the [examples](https://github.com/lucab/zbus_systemd/tree/main/examples).

## Async executor

This crate internally uses `zbus` without any default Cargo features.
That means that you have to decide which async executor to use, by enabling one of the following Cargo features:
 * `zbus-async-smol`: internally uses the `smol` executor (enabling the `async-io` feature in `zbus`).
 * `zbus-async-tokio`: internally uses the `tokio` executor (enabling the `tokio` feature in `zbus`).

In case that `zbus` is already part of your dependency tree, you may decide to skip this choice and rely on [Cargo features unification mechanism](https://doc.rust-lang.org/cargo/reference/features.html#feature-unification) instead.

Otherwise, if you aren't already depending on `zbus` and you don't enable any of the async features above, you will likely get a build error.

## License

Licensed under either of

 * MIT license - <http://opensource.org/licenses/MIT>
 * Apache License, Version 2.0 - <http://www.apache.org/licenses/LICENSE-2.0>

at your option.