From d918804408801bf46a49018e374ebdfbeae08805 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Wed, 5 Jun 2024 11:28:21 +0200 Subject: [PATCH] man/systemd: reorder content a bit Section "Description" didn't actually say what systemd does. And we had a giant "Concepts" section that actually described units types and other details about them. So let's move the basic description of functionality to "Description" and rename the following section to "Units". The link to the Original Design Document is moved to "See Also", it is of historical interest mostly at this point. The only actual change is that when talking about API filesystems, /dev is also mentioned. (I think /sys+/proc+/dev are the canonical set and should be always listed on one breath.) (cherry picked from commit f11aaf7dfb295de429b1567282b19caaba036bba) --- man/systemd.xml | 49 ++++++++++++++++++++++++------------------------- 1 file changed, 24 insertions(+), 25 deletions(-) diff --git a/man/systemd.xml b/man/systemd.xml index 66db5bbf25..f4aa7e06ca 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -62,10 +62,29 @@ user.conf.d directories. See systemd-system.conf5 for more information. + + systemd contains native implementations of various tasks that need to be + executed as part of the boot process. For example, it sets the hostname or configures the loopback + network device. It also sets up and mounts various API file systems, such as /sys/, + /proc/, and /dev/. + + Note that some but not all interfaces provided by systemd are covered by the + Interface Portability and Stability Promise. + + The D-Bus API of systemd is described in + org.freedesktop.systemd15 + and + org.freedesktop.LogControl15. + + + Systems which invoke systemd in a container or initrd environment should implement the Container Interface or + initrd Interface + specifications, respectively. - Concepts + Units systemd provides a dependency system between various entities called "units" of 11 different types. Units encapsulate @@ -261,34 +280,10 @@ example, start jobs for any of those inactive units getting queued as well. - systemd contains native implementations of various tasks - that need to be executed as part of the boot process. For example, - it sets the hostname or configures the loopback network device. It - also sets up and mounts various API file systems, such as - /sys/ or /proc/. - - For more information about the concepts and - ideas behind systemd, please refer to the - Original Design Document. - - Note that some but not all interfaces provided by systemd are covered by the - Interface Portability and Stability Promise. - Units may be generated dynamically at boot and system manager reload time, for example based on other configuration files or parameters passed on the kernel command line. For details, see systemd.generator7. - - The D-Bus API of systemd is described in - org.freedesktop.systemd15 - and - org.freedesktop.LogControl15. - - - Systems which invoke systemd in a container or initrd environment should implement the Container Interface or - initrd Interface - specifications, respectively. @@ -1558,6 +1553,10 @@ bootup7 systemd.directives7 + + For more information about the concepts and + ideas behind systemd, please refer to the + Original Design Document.