From af080967bad2524d2fa2fef6ba5e9fcf18d3017e Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 13:12:20 +0100 Subject: [PATCH 01/10] man: document the timeout applied to /usr/lib/systemd/system-shutdown/ drop-in binaries Fixes: #34949 --- man/systemd-poweroff.service.xml | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/man/systemd-poweroff.service.xml b/man/systemd-poweroff.service.xml index ec7ffdeb0d..c55260d380 100644 --- a/man/systemd-poweroff.service.xml +++ b/man/systemd-poweroff.service.xml @@ -44,7 +44,7 @@ kexec.target to execute the respective actions. When these services are run, they ensure that PID 1 is replaced by the - /usr/lib/systemd/systemd-shutdown tool which is then responsible for the actual + /usr/lib/systemd/systemd-shutdown binary which is then responsible for the actual shutdown. Before shutting down, this binary will try to unmount all remaining file systems (or at least remount them read-only), disable all remaining swap devices, detach all remaining storage devices and kill all remaining processes. @@ -58,12 +58,12 @@ /usr/lib/systemd/system-shutdown/ and pass one arguments to them: either poweroff, halt, reboot, or kexec, depending on the chosen action. All executables in this directory are executed - in parallel, and execution of the action is not continued before all executables finished. Note that - these executables are run after all services have been shut down, and after most - mounts have been unmounted (the root file system as well as /run/ and various API - file systems are still around though). This means any programs dropped into this directory must be - prepared to run in such a limited execution environment and not rely on external services or hierarchies - such as /var/ to be around (or writable). + in parallel, and execution of the action is not continued before all executables finished. (A safety + timeout of 90s is applied however.) Note that these executables are run after all + services have been shut down, and after most mounts have been unmounted (the root file system as well as + /run/ and various API file systems are still around though). This means any programs + dropped into this directory must be prepared to run in such a limited execution environment and not rely + on external services or hierarchies such as /var/ to be around (or writable). Note that systemd-poweroff.service (and the related units) should never be executed directly. Instead, trigger system shutdown with a command such as systemctl From ecbe9ae5a0952d968c57e59dda4a42b72e5b5e6d Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 13:15:36 +0100 Subject: [PATCH 02/10] man: don't claim SELinuxContext= only worked in the system service manager Fixes: #34840 --- man/systemd.exec.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index b50f70ff42..ac17ab65a4 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -893,8 +893,6 @@ CapabilityBoundingSet=~CAP_B CAP_C Mandatory Access Control - - @@ -921,6 +919,8 @@ CapabilityBoundingSet=~CAP_B CAP_C prefixed by -, all errors will be ignored. This setting has no effect if AppArmor is not enabled. This setting does not affect commands prefixed with +. + + @@ -939,6 +939,8 @@ CapabilityBoundingSet=~CAP_B CAP_C value may be specified to unset previous assignments. This does not affect commands prefixed with +. + + From 172ac39fc8e8786c6c3bf86daa8fe8798af9540b Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 13:27:23 +0100 Subject: [PATCH 03/10] man: highlight the privilege issues around the LogControl1 more Let's emphasize the privilege thing with a section. Let's also point out that other D-Bus libraries are less restrictive than sd-bus by default regarding permission access. Fixes: #34735 --- man/org.freedesktop.LogControl1.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/man/org.freedesktop.LogControl1.xml b/man/org.freedesktop.LogControl1.xml index 5738a3dda6..135e8bc8de 100644 --- a/man/org.freedesktop.LogControl1.xml +++ b/man/org.freedesktop.LogControl1.xml @@ -89,7 +89,9 @@ node /org/freedesktop/LogControl1 { syslog3 call). - Those two properties are writable, so they may be set by sufficiently privileged users. + Write AccessThe LogLevel and + LogTarget properties are supposed to be writable. Care should be taken to ensure + that only appropriately privileged clients can modify them. SyslogIdentifier is a read-only property that shows the "syslog identifier". It is a short string that identifies the program that is the source of log messages that is passed to @@ -127,6 +129,11 @@ node /org/freedesktop/LogControl1 { This creates a simple server on the bus. It implements the LogControl1 interface by providing the required properties and allowing to set the writable ones. It logs at the configured log level using sd_journal_print3. + + Note that when porting this example to other D-Bus libraries it might be necessary to add manual + client privilege checks, as they typically do not default to the restrictive defaults of sd-bus, where + unprivileged access to properties is controlled via the SD_BUS_VTABLE_UNPRIVILEGED + flag that is opt-in rather than opt-out. From b71173709651102081c9d8c6d6e3d2a6ef5cf17e Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 13:33:53 +0100 Subject: [PATCH 04/10] man: document that PrivateTmp= is unaffected by ProtectSystem=strict Fixes: #33130 --- man/systemd.exec.xml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index ac17ab65a4..a955f767e4 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -1433,6 +1433,10 @@ CapabilityBoundingSet=~CAP_B CAP_C set. This setting cannot ensure protection in all cases. In general it has the same limitations as ReadOnlyPaths=, see below. Defaults to off. + Note that if ProtectSystem= is set to strict and + PrivateTmp= is enabled, then /tmp/ and + /var/tmp/ will be writable. + From 5adc4337996f561df43c617e37ef4b157073b2e6 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 13:36:19 +0100 Subject: [PATCH 05/10] man: document that .path units don't care for hidden files Fixes: #32751 --- man/systemd.path.xml | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/man/systemd.path.xml b/man/systemd.path.xml index 6281c3d847..1ef5db0a73 100644 --- a/man/systemd.path.xml +++ b/man/systemd.path.xml @@ -153,11 +153,14 @@ not apply to PathChanged= and PathModified=. - If the path itself or any of the containing directories - are not accessible, systemd will watch for - permission changes and notice that conditions are satisfied - when permissions allow that. + If the path itself or any of the containing directories are not accessible, + systemd will watch for permission changes and notice that conditions are satisfied + when permissions allow that. + + Note that files whose name starts with a dot (i.e. hidden files) are generally ignored when + monitoring these paths. + Unit= From ac804bc2f8d814d2afcdccd88f7469ac320da1c8 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 13:51:00 +0100 Subject: [PATCH 06/10] man: tone down claims on processes having exited already in ExecStop= Processes can easily survive the first kill operation we execute, hence we shouldn't make strong claims about them having exited already. Let's just say "likely" hence. Fixes: #15032 --- man/systemd.service.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/man/systemd.service.xml b/man/systemd.service.xml index a5c0dc84e1..7929f86528 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -551,11 +551,11 @@ ExecStop= – commands specified with this setting are invoked when a service failed to start up correctly and is shut down again. - It is recommended to use this setting for clean-up operations that shall be executed even when the - service failed to start up correctly. Commands configured with this setting need to be able to operate even if - the service failed starting up half-way and left incompletely initialized data around. As the service's - processes have been terminated already when the commands specified with this setting are executed they should - not attempt to communicate with them. + It is recommended to use this setting for clean-up operations that shall be executed even when + the service failed to start up correctly. Commands configured with this setting need to be able to + operate even if the service failed starting up half-way and left incompletely initialized data + around. As the service's processes have likely exited already when the commands specified with this + setting are executed they should not attempt to communicate with them. Note that all commands that are configured with this setting are invoked with the result code of the service, as well as the main process' exit code and status, set in the $SERVICE_RESULT, From 4f5fabe7a39f046e0456eba07472df061e85c94e Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 14:07:31 +0100 Subject: [PATCH 07/10] man: add brief entrypoint man page for sd-varlink We have this in a similar fashion for the other APIs libsystemd provides. Add the same for sd-varlink. There isn't too much on it for now, but at least it's a start. Also link it up everywhere. --- man/libsystemd.xml | 4 ++- man/rules/meson.build | 1 + man/sd-bus.xml | 1 + man/sd-json.xml | 3 +- man/sd-varlink.xml | 64 +++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 71 insertions(+), 2 deletions(-) create mode 100644 man/sd-varlink.xml diff --git a/man/libsystemd.xml b/man/libsystemd.xml index d3d9798d6b..ef34571dd6 100644 --- a/man/libsystemd.xml +++ b/man/libsystemd.xml @@ -35,6 +35,7 @@ #include <systemd/sd-login.h> #include <systemd/sd-messages.h> #include <systemd/sd-path.h> +#include <systemd/sd-varlink.h> @@ -61,8 +62,9 @@ sd-id1283, sd-journal3, sd-json3, - and sd-login3 + and + sd-varlink3 for information about different parts of the library interface. diff --git a/man/rules/meson.build b/man/rules/meson.build index eb4300386d..ce587efb21 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -155,6 +155,7 @@ manpages = [ ['sd-journal', '3', [], ''], ['sd-json', '3', [], ''], ['sd-login', '3', [], 'HAVE_PAM'], + ['sd-varlink', '3', [], ''], ['sd_booted', '3', [], ''], ['sd_bus_add_match', '3', diff --git a/man/sd-bus.xml b/man/sd-bus.xml index 26392d7a31..238c5a68c9 100644 --- a/man/sd-bus.xml +++ b/man/sd-bus.xml @@ -189,6 +189,7 @@ systemd1 sd-event3 busctl1 + sd-varlink3 dbus-daemon1 dbus-send1 diff --git a/man/sd-json.xml b/man/sd-json.xml index e10ef0d953..95a1985d6f 100644 --- a/man/sd-json.xml +++ b/man/sd-json.xml @@ -84,7 +84,8 @@ See Also - systemd1, + systemd1 + sd-varlink3 pkg-config1 diff --git a/man/sd-varlink.xml b/man/sd-varlink.xml new file mode 100644 index 0000000000..b28d100b31 --- /dev/null +++ b/man/sd-varlink.xml @@ -0,0 +1,64 @@ + + + + + + + + sd-varlink + systemd + + + + sd-varlink + 3 + + + + sd-varlink + APIs for Varlink IPC + + + + + #include <systemd/sd-varlink.h> + + + + pkg-config --cflags --libs libsystemd + + + + + Description + + sd-varlink.h is part of + libsystemd3 and + provides APIs for implementing Varlink IPC clients and services. See + for more information about Varlink IPC. + + Varlink IPC uses JSON as marshalling format. The sd-varlink + API relies on the + sd-json3 API for JSON + seralization, deserialization and manipulation. + + The varlinkctl1 tool + makes the functionality implemented by sd-varlink available from the command line. + + + + + + See Also + + systemd1 + sd-event3 + sd-json3 + varlinkctl1 + sd-bus3 + pkg-config1 + + + From 2f69ad26ca21d4da7f875bdea77594a115e2deee Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 14:08:16 +0100 Subject: [PATCH 08/10] man: point people from sd-bus man page to busctl --- man/sd-bus.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/man/sd-bus.xml b/man/sd-bus.xml index 238c5a68c9..7392c2b4b0 100644 --- a/man/sd-bus.xml +++ b/man/sd-bus.xml @@ -179,6 +179,9 @@ sd_bus_track_new3 for more information about the functions available. + + The busctl1 tool + makes the functionality implemented by sd-bus available from the command line. @@ -192,7 +195,7 @@ sd-varlink3 dbus-daemon1 dbus-send1 + pkg-config1 - From 607d2974870e9769f44ee179dcaf26cbec64cb20 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 14:20:01 +0100 Subject: [PATCH 09/10] man: link up D-Bus API docs from daemon man pages Let's systematically make sure that we link up the D-Bus interfaces from the daemon man pages once in prose and once in short form at the bottom ("See Also"), for all daemons. Also, add reverse links at the bottom of the D-Bus API docs. Fixes: #34996 --- man/org.freedesktop.hostname1.xml | 21 +++++++++++++-------- man/org.freedesktop.import1.xml | 10 ++++++++++ man/org.freedesktop.locale1.xml | 10 ++++++++++ man/org.freedesktop.login1.xml | 9 +++++++++ man/org.freedesktop.machine1.xml | 9 +++++++++ man/org.freedesktop.network1.xml | 9 +++++++++ man/org.freedesktop.oom1.xml | 10 ++++++++++ man/org.freedesktop.portable1.xml | 9 +++++++++ man/org.freedesktop.resolve1.xml | 9 +++++++++ man/org.freedesktop.systemd1.xml | 9 +++++++++ man/org.freedesktop.sysupdate1.xml | 9 +++++++++ man/org.freedesktop.timedate1.xml | 8 ++++++-- man/org.freedesktop.timesync1.xml | 7 +++++++ man/systemd-hostnamed.service.xml | 1 + man/systemd-importd.service.xml | 1 + man/systemd-localed.service.xml | 1 + man/systemd-logind.service.xml | 1 + man/systemd-machined.service.xml | 1 + man/systemd-networkd.service.xml | 7 +++++++ man/systemd-oomd.service.xml | 7 +++++++ man/systemd-portabled.service.xml | 6 ++++++ man/systemd-resolved.service.xml | 1 + man/systemd-sysupdated.service.xml | 11 ++++++----- man/systemd-timedated.service.xml | 1 + man/systemd.xml | 1 + 25 files changed, 153 insertions(+), 15 deletions(-) diff --git a/man/org.freedesktop.hostname1.xml b/man/org.freedesktop.hostname1.xml index d16ae9ab1c..6c329cbd2c 100644 --- a/man/org.freedesktop.hostname1.xml +++ b/man/org.freedesktop.hostname1.xml @@ -427,8 +427,6 @@ node /org/freedesktop/hostname1 { name. - - Examples @@ -442,12 +440,7 @@ node /org/freedesktop/hostname1 { - - See Also - - David Zeuthen's original Fedora - Feature page about xdg-hostname - + History @@ -462,4 +455,16 @@ node /org/freedesktop/hostname1 { VSockCID were added in version 256. + + + See Also + + + systemd1 + systemd-hostnamed.service8 + hostnamectl1 + David Zeuthen's original Fedora + Feature page about xdg-hostname + + diff --git a/man/org.freedesktop.import1.xml b/man/org.freedesktop.import1.xml index 2486eea4b3..cfcf133975 100644 --- a/man/org.freedesktop.import1.xml +++ b/man/org.freedesktop.import1.xml @@ -453,6 +453,7 @@ node /org/freedesktop/import1/transfer/_1 { + History @@ -469,4 +470,13 @@ node /org/freedesktop/import1/transfer/_1 { + + See Also + + systemd1 + systemd-importd.service8 + importctl1 + + + diff --git a/man/org.freedesktop.locale1.xml b/man/org.freedesktop.locale1.xml index 6e0d118e25..0fd8876ca8 100644 --- a/man/org.freedesktop.locale1.xml +++ b/man/org.freedesktop.locale1.xml @@ -185,4 +185,14 @@ $ gdbus introspect --system \ These D-Bus interfaces follow the usual interface versioning guidelines. + + + See Also + + systemd1 + systemd-localed.service8 + localectl1 + + + diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml index 00ca82487a..750d68518e 100644 --- a/man/org.freedesktop.login1.xml +++ b/man/org.freedesktop.login1.xml @@ -1648,4 +1648,13 @@ node /org/freedesktop/login1/session/1 { SetClass() was added in version 256. + + + See Also + + systemd1 + systemd-logind.service8 + loginctl1 + + diff --git a/man/org.freedesktop.machine1.xml b/man/org.freedesktop.machine1.xml index 602c04bf4f..50d9aa6792 100644 --- a/man/org.freedesktop.machine1.xml +++ b/man/org.freedesktop.machine1.xml @@ -719,4 +719,13 @@ $ gdbus introspect --system \ and SSHPrivateKeyPath were added in version 256. + + + See Also + + systemd1 + systemd-machined.service8 + machinectl1 + + diff --git a/man/org.freedesktop.network1.xml b/man/org.freedesktop.network1.xml index 1d8ce0de81..c7f1a68798 100644 --- a/man/org.freedesktop.network1.xml +++ b/man/org.freedesktop.network1.xml @@ -602,4 +602,13 @@ $ gdbus introspect --system \ NamespaceNSID was added in version 256. + + + See Also + + systemd1 + systemd-networkd.service8 + networkctl1 + + diff --git a/man/org.freedesktop.oom1.xml b/man/org.freedesktop.oom1.xml index 1b549c347c..4b61119d6b 100644 --- a/man/org.freedesktop.oom1.xml +++ b/man/org.freedesktop.oom1.xml @@ -103,4 +103,14 @@ node /org/freedesktop/oom1 { Killed() was added in version 252. + + + See Also + + systemd1 + systemd-oomd.service8 + oomctl1 + + + diff --git a/man/org.freedesktop.portable1.xml b/man/org.freedesktop.portable1.xml index 4de3da2905..af5e303e6e 100644 --- a/man/org.freedesktop.portable1.xml +++ b/man/org.freedesktop.portable1.xml @@ -591,4 +591,13 @@ node /org/freedesktop/portable1 { ReattachWithExtensions() was added in version 254. + + + See Also + + systemd1 + systemd-portabled.service8 + portablectl1 + + diff --git a/man/org.freedesktop.resolve1.xml b/man/org.freedesktop.resolve1.xml index f6b70d6e4f..07c0528b5c 100644 --- a/man/org.freedesktop.resolve1.xml +++ b/man/org.freedesktop.resolve1.xml @@ -935,4 +935,13 @@ $ gdbus introspect --system \ + + + See Also + + systemd1 + systemd-resolved.service8 + resolvectl1 + + diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml index 05afb93f9b..e554e860ca 100644 --- a/man/org.freedesktop.systemd1.xml +++ b/man/org.freedesktop.systemd1.xml @@ -12489,4 +12489,13 @@ $ gdbus introspect --system --dest org.freedesktop.systemd1 \ DeferReactivation was added in version 257. + + + See Also + + systemd1 + systemctl1 + + + diff --git a/man/org.freedesktop.sysupdate1.xml b/man/org.freedesktop.sysupdate1.xml index 29b938f1a6..a109cef04a 100644 --- a/man/org.freedesktop.sysupdate1.xml +++ b/man/org.freedesktop.sysupdate1.xml @@ -582,4 +582,13 @@ node /org/freedesktop/sysupdate1/job/_1 { Progress were added in version 257. + + + See Also + + systemd1 + systemd-sysupdated.service8 + updatectl1 + + diff --git a/man/org.freedesktop.timedate1.xml b/man/org.freedesktop.timedate1.xml index 1dfb630545..d0271145f9 100644 --- a/man/org.freedesktop.timedate1.xml +++ b/man/org.freedesktop.timedate1.xml @@ -194,7 +194,11 @@ $ gdbus introspect --system \ See Also - - More information on how the system clock and RTC interact + + systemd1 + systemd-timedate.service8 + timedatectl.service1 + More information on how the system clock and RTC interact + diff --git a/man/org.freedesktop.timesync1.xml b/man/org.freedesktop.timesync1.xml index 22bf73103d..70f8b70b3a 100644 --- a/man/org.freedesktop.timesync1.xml +++ b/man/org.freedesktop.timesync1.xml @@ -153,4 +153,11 @@ $ gdbus introspect --system \ + + See Also + + systemd1 + systemd-timesync.service8 + + diff --git a/man/systemd-hostnamed.service.xml b/man/systemd-hostnamed.service.xml index c2a4015ff0..e7dc879201 100644 --- a/man/systemd-hostnamed.service.xml +++ b/man/systemd-hostnamed.service.xml @@ -76,6 +76,7 @@ machine-info5 hostnamectl1 sethostname2 + org.freedesktop.hostname15 diff --git a/man/systemd-importd.service.xml b/man/systemd-importd.service.xml index dfeaff4fd7..cc5ac6af22 100644 --- a/man/systemd-importd.service.xml +++ b/man/systemd-importd.service.xml @@ -50,6 +50,7 @@ importctl1 systemd-machined.service8 systemd-nspawn1 + org.freedesktop.import15 diff --git a/man/systemd-localed.service.xml b/man/systemd-localed.service.xml index ef597de278..43a4f66b5a 100644 --- a/man/systemd-localed.service.xml +++ b/man/systemd-localed.service.xml @@ -55,6 +55,7 @@ vconsole.conf5 localectl1 loadkeys1 + org.freedesktop.locale15 diff --git a/man/systemd-logind.service.xml b/man/systemd-logind.service.xml index 4ecd700f8b..93bcd6bc8f 100644 --- a/man/systemd-logind.service.xml +++ b/man/systemd-logind.service.xml @@ -104,6 +104,7 @@ logind.conf5 pam_systemd8 sd-login3 + org.freedesktop.login15 diff --git a/man/systemd-machined.service.xml b/man/systemd-machined.service.xml index bb931ac50b..7ad35c8584 100644 --- a/man/systemd-machined.service.xml +++ b/man/systemd-machined.service.xml @@ -135,6 +135,7 @@ systemd-nspawn1 nss-mymachines8 systemd.special7 + org.freedesktop.machine15 diff --git a/man/systemd-networkd.service.xml b/man/systemd-networkd.service.xml index b33a7f6510..2ded90f0f3 100644 --- a/man/systemd-networkd.service.xml +++ b/man/systemd-networkd.service.xml @@ -63,6 +63,12 @@ systemd-networkd may be introspected and controlled at runtime using networkctl1. + + See + org.freedesktop.network15 + and + org.freedesktop.LogControl15 + for a description of the D-Bus API. Configuration Files @@ -91,6 +97,7 @@ systemd.netdev5 systemd-networkd-wait-online.service8 systemd-network-generator.service8 + org.freedesktop.network15 diff --git a/man/systemd-oomd.service.xml b/man/systemd-oomd.service.xml index 51a9377ea0..53a9250983 100644 --- a/man/systemd-oomd.service.xml +++ b/man/systemd-oomd.service.xml @@ -57,6 +57,12 @@ See oomd.conf5 for more information about the configuration of this service. + + See + org.freedesktop.oom15 + and + org.freedesktop.LogControl15 + for a description of the D-Bus API. @@ -129,6 +135,7 @@ systemd.resource-control5 oomd.conf5 oomctl1 + org.freedesktop.oom15 diff --git a/man/systemd-portabled.service.xml b/man/systemd-portabled.service.xml index abf42cff2f..894b47bf27 100644 --- a/man/systemd-portabled.service.xml +++ b/man/systemd-portabled.service.xml @@ -37,6 +37,12 @@ See the Portable Services page for details about the concepts this service implements. + + See + org.freedesktop.portable15 + and + org.freedesktop.LogControl15 + for a description of the D-Bus API. diff --git a/man/systemd-resolved.service.xml b/man/systemd-resolved.service.xml index 210a843233..b7673dc6c4 100644 --- a/man/systemd-resolved.service.xml +++ b/man/systemd-resolved.service.xml @@ -516,6 +516,7 @@ search foobar.com barbar.com hosts5 systemd.network5 systemd-networkd.service8 + org.freedesktop.resolve15 diff --git a/man/systemd-sysupdated.service.xml b/man/systemd-sysupdated.service.xml index 30a9bd8d69..768b19ef8d 100644 --- a/man/systemd-sysupdated.service.xml +++ b/man/systemd-sysupdated.service.xml @@ -45,11 +45,12 @@ See Also - - systemd1, - systemd-sysupdate8 - updatectl1 - + + systemd1 + systemd-sysupdate8 + updatectl1 + org.freedesktop.sysupdate15 + diff --git a/man/systemd-timedated.service.xml b/man/systemd-timedated.service.xml index eb4fc18096..9f119189d2 100644 --- a/man/systemd-timedated.service.xml +++ b/man/systemd-timedated.service.xml @@ -99,6 +99,7 @@ systemd-timesyncd.service localtime5 hwclock8 systemd-timesyncd8 + org.freedesktop.timedate15 diff --git a/man/systemd.xml b/man/systemd.xml index 71da1ec8f1..e4eac906b3 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -1590,6 +1590,7 @@ kernel-command-line7 bootup7 systemd.directives7 + org.freedesktop.systemd15 For more information about the concepts and From df8f9b88bd41320653fe1c51ea515a2d03a349df Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 5 Nov 2024 14:47:32 +0100 Subject: [PATCH 10/10] man: convert multiple left-over "See Also" sections to These were forgotten during the initial conversion, probably because most of them consisted only of a single entry. Fix that. --- man/capsule@.service.xml | 24 ++++++++++++------------ man/hwdb.xml | 8 +++----- man/pstore.conf.xml | 6 +++--- man/sd_device_get_syspath.xml | 7 ++++--- man/sd_journal_has_runtime_files.xml | 7 ++++--- man/sd_path_lookup.xml | 9 +++++---- man/systemd-ac-power.xml | 6 +++--- man/systemd-backlight@.service.xml | 6 +++--- man/systemd-battery-check.service.xml | 6 +++--- man/systemd-bsod.service.xml | 6 +++--- man/systemd-hwdb.xml | 7 ++++--- man/systemd-initctl.service.xml | 6 +++--- man/systemd-mountfsd.service.xml | 8 ++++---- man/systemd-nsresourced.service.xml | 16 ++++++++-------- man/systemd-pstore.service.xml | 6 +++--- man/systemd-rfkill.service.xml | 6 +++--- man/systemd-tpm2-setup.service.xml | 6 +++--- man/systemd.syntax.xml | 7 ++++--- man/udev_new.xml | 7 ++++--- 19 files changed, 79 insertions(+), 75 deletions(-) diff --git a/man/capsule@.service.xml b/man/capsule@.service.xml index f9c5455f3b..ea210533d4 100644 --- a/man/capsule@.service.xml +++ b/man/capsule@.service.xml @@ -106,17 +106,17 @@ See Also - - systemd1, - user@.service5, - systemd.service5, - systemd.slice5, - systemd.exec5, - systemd.special7, - systemctl1, - systemd-run1, - busctl1, - pam8 - + + systemd1 + user@.service5 + systemd.service5 + systemd.slice5 + systemd.exec5 + systemd.special7 + systemctl1 + systemd-run1 + busctl1 + pam8 + diff --git a/man/hwdb.xml b/man/hwdb.xml index 382255267d..6dd72c67b4 100644 --- a/man/hwdb.xml +++ b/man/hwdb.xml @@ -145,10 +145,8 @@ PROPERTY_WITH_SPACES=some string See Also - - - systemd-hwdb8 - - + + systemd-hwdb8 + diff --git a/man/pstore.conf.xml b/man/pstore.conf.xml index 6173765130..ef431c8a6c 100644 --- a/man/pstore.conf.xml +++ b/man/pstore.conf.xml @@ -91,9 +91,9 @@ See Also - - systemd-journald.service8 - + + systemd-pstore.service8 + diff --git a/man/sd_device_get_syspath.xml b/man/sd_device_get_syspath.xml index 8856c38644..36e9194620 100644 --- a/man/sd_device_get_syspath.xml +++ b/man/sd_device_get_syspath.xml @@ -250,9 +250,10 @@ See Also - - systemd1 - + + systemd1 + sd-device3 + diff --git a/man/sd_journal_has_runtime_files.xml b/man/sd_journal_has_runtime_files.xml index 12870d72cb..dd6fc02d58 100644 --- a/man/sd_journal_has_runtime_files.xml +++ b/man/sd_journal_has_runtime_files.xml @@ -77,9 +77,10 @@ See Also - - sd-journal3 - + + systemd1 + sd-journal3 + diff --git a/man/sd_path_lookup.xml b/man/sd_path_lookup.xml index f557e4f6bf..fc6bac640c 100644 --- a/man/sd_path_lookup.xml +++ b/man/sd_path_lookup.xml @@ -226,10 +226,11 @@ See Also - - - systemd-path1 - + + systemd1 + sd-path3 + systemd-path1 + diff --git a/man/systemd-ac-power.xml b/man/systemd-ac-power.xml index cbf7279f51..a693187864 100644 --- a/man/systemd-ac-power.xml +++ b/man/systemd-ac-power.xml @@ -75,9 +75,9 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd-backlight@.service.xml b/man/systemd-backlight@.service.xml index bb7f2b6b3e..0021aec971 100644 --- a/man/systemd-backlight@.service.xml +++ b/man/systemd-backlight@.service.xml @@ -71,9 +71,9 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd-battery-check.service.xml b/man/systemd-battery-check.service.xml index a5f564b888..2824797c04 100644 --- a/man/systemd-battery-check.service.xml +++ b/man/systemd-battery-check.service.xml @@ -83,9 +83,9 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd-bsod.service.xml b/man/systemd-bsod.service.xml index 5ef10c2c07..29a08710c2 100644 --- a/man/systemd-bsod.service.xml +++ b/man/systemd-bsod.service.xml @@ -79,9 +79,9 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd-hwdb.xml b/man/systemd-hwdb.xml index 3c6feb2a4a..ab27643e6e 100644 --- a/man/systemd-hwdb.xml +++ b/man/systemd-hwdb.xml @@ -83,8 +83,9 @@ See Also - - hwdb7 - + + systemd1 + hwdb7 + diff --git a/man/systemd-initctl.service.xml b/man/systemd-initctl.service.xml index af092b88b3..ad0d49de48 100644 --- a/man/systemd-initctl.service.xml +++ b/man/systemd-initctl.service.xml @@ -41,9 +41,9 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd-mountfsd.service.xml b/man/systemd-mountfsd.service.xml index 25c1568f33..a8f48365b0 100644 --- a/man/systemd-mountfsd.service.xml +++ b/man/systemd-mountfsd.service.xml @@ -62,9 +62,9 @@ See Also - - systemd1, - systemd-nsresourced.service8 - + + systemd1 + systemd-nsresourced.service8 + diff --git a/man/systemd-nsresourced.service.xml b/man/systemd-nsresourced.service.xml index de43eacdd5..787312d858 100644 --- a/man/systemd-nsresourced.service.xml +++ b/man/systemd-nsresourced.service.xml @@ -69,13 +69,13 @@ See Also - - systemd1, - systemd-mountfsd.service8, - systemd-nspawn1, - systemd.exec5, - systemd-dissect1, - user_namespaces7 - + + systemd1 + systemd-mountfsd.service8 + systemd-nspawn1 + systemd.exec5 + systemd-dissect1 + user_namespaces7 + diff --git a/man/systemd-pstore.service.xml b/man/systemd-pstore.service.xml index 12c5459597..f3a879625f 100644 --- a/man/systemd-pstore.service.xml +++ b/man/systemd-pstore.service.xml @@ -107,8 +107,8 @@ See Also - - pstore.conf5 - + + pstore.conf5 + diff --git a/man/systemd-rfkill.service.xml b/man/systemd-rfkill.service.xml index 9449a048e3..9074ddcf17 100644 --- a/man/systemd-rfkill.service.xml +++ b/man/systemd-rfkill.service.xml @@ -60,9 +60,9 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd-tpm2-setup.service.xml b/man/systemd-tpm2-setup.service.xml index 3fa3490995..71b5de387c 100644 --- a/man/systemd-tpm2-setup.service.xml +++ b/man/systemd-tpm2-setup.service.xml @@ -75,8 +75,8 @@ See Also - - systemd1 - + + systemd1 + diff --git a/man/systemd.syntax.xml b/man/systemd.syntax.xml index 1dc46255ef..48b0a64c5c 100644 --- a/man/systemd.syntax.xml +++ b/man/systemd.syntax.xml @@ -224,9 +224,10 @@ KeyThree=value 3\ See Also - - systemd.time7 - + + systemd1 + systemd.time7 + diff --git a/man/udev_new.xml b/man/udev_new.xml index 7b13081fb1..4650cbecf3 100644 --- a/man/udev_new.xml +++ b/man/udev_new.xml @@ -82,9 +82,10 @@ See Also - - systemd1, - + + systemd1 + systemd-udevd.sevice8 +