diff --git a/docs/manual/integration-systemd.txt b/docs/manual/integration-systemd.txt new file mode 100644 index 0000000000..44248b43ff --- /dev/null +++ b/docs/manual/integration-systemd.txt @@ -0,0 +1,27 @@ +// -*- mode:doc; -*- +// vim: set syntax=asciidoc: + +[[integration-systemd]] +=== Systemd + +This chapter describes the decisions taken in Buildroot's integration of +systemd, and how various use cases can be implemented. + +==== DBus daemon + +Systemd requires a DBus daemon. There are two options for it: traditional dbus +(+BR2_PACKAGE_DBUS+) and bus1 dbus-broker (+BR2_PACKAGE_DBUS_BROKER+). At +least one of them must be chosen. If both are included in the configuration, +dbus-broker will be used as system bus, but the traditional dbus-daemon is +still installed as well and can be used as session bus. Also its tools (e.g. ++dbus-send+) can be used (systemd itself has +busctl+ as an alternative). In +addition, the traditional dbus package is the only one that provides +libdbus+, +which is used by many packages as dbus integration library. + +Both in the dbus and in the dbus-broker case, the daemon runs as user +dbus+. +The DBus configuration files are also identical for both. + +To make sure that only one of the two daemons is started as system bus, the +systemd activation files of the dbus package (+dbus.socket+ and the ++dbus.service+ symlink in +multi-user.target.wants+) are removed when +dbus-broker is selected. diff --git a/docs/manual/integration.txt b/docs/manual/integration.txt index bdfbfa59de..be56bf6567 100644 --- a/docs/manual/integration.txt +++ b/docs/manual/integration.txt @@ -9,4 +9,6 @@ level. Buildroot is highly configurable, almost everything discussed here can be changed or overridden by xref:rootfs-custom[rootfs overlay or custom skeleton] configuration. +include::integration-systemd.txt[] + include::integration-selinux-support.txt[]