diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 66c45e39a3..b31c087c76 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -305,8 +305,12 @@ really just halts the system rather than powering it down. - Applications wanting to halt the system should start - this unit. + Applications wanting to halt the system should not start this unit + directly, but should instead execute systemctl halt + (possibly with the option) or call + systemd1's + org.freedesktop.systemd1.Manager.Halt D-Bus method + directly. @@ -336,8 +340,12 @@ A special target unit for shutting down and rebooting the system via kexec. - Applications wanting to reboot the system with kexec - should start this unit. + Applications wanting to reboot the system should not start this unit + directly, but should instead execute systemctl kexec + (possibly with the option) or call + systemd1's + org.freedesktop.systemd1.Manager.KExec D-Bus method + directly. @@ -430,8 +438,12 @@ A special target unit for shutting down and powering off the system. - Applications wanting to power off the system should - start this unit. + Applications wanting to reboot the system should not start this unit + directly, but should instead execute systemctl poweroff + (possibly with the option) or call + systemd-logind8's + org.freedesktop.login1.Manager.PowerOff D-Bus method + directly. runlevel0.target is an alias for this target unit, for compatibility with SysV. @@ -443,8 +455,12 @@ A special target unit for shutting down and rebooting the system. - Applications wanting to reboot the system should start - this unit. + Applications wanting to reboot the system should not start this unit + directly, but should instead execute systemctl reboot + (possibly with the option) or call + systemd-logind8's + org.freedesktop.login1.Manager.Reboot D-Bus method + directly. runlevel6.target is an alias for this target unit, for compatibility with SysV.