picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

man: do not encourgage starting of poweroff/halt/reboot/kexec targets directly

Browse source 
Going through logind and systemd allows polkit to be used,
the job mode will be set properly, and is generally easier
to get correct.

Fixes #6452.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2017-07-26 15:53:30 -04:00
parent 26adf7741d
commit cb1c2d174c
1 changed files with 24 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
man/systemd.special.xml
View file

@ -305,8 +305,12 @@
really just halts the system rather than powering it
down.</para>
<para>Applications wanting to halt the system should start
this unit.</para>
<para>Applications wanting to halt the system should not start this unit
directly, but should instead execute <command>systemctl halt</command>
(possibly with the <option>--no-block</option> option) or call
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s
<command>org.freedesktop.systemd1.Manager.Halt</command> D-Bus method
directly.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -336,8 +340,12 @@
<para>A special target unit for shutting down and rebooting
the system via kexec.</para>
<para>Applications wanting to reboot the system with kexec
should start this unit.</para>
<para>Applications wanting to reboot the system should not start this unit
directly, but should instead execute <command>systemctl kexec</command>
(possibly with the <option>--no-block</option> option) or call
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s
<command>org.freedesktop.systemd1.Manager.KExec</command> D-Bus method
directly.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -430,8 +438,12 @@
<para>A special target unit for shutting down and powering
off the system.</para>
<para>Applications wanting to power off the system should
start this unit.</para>
<para>Applications wanting to reboot the system should not start this unit
directly, but should instead execute <command>systemctl poweroff</command>
(possibly with the <option>--no-block</option> option) or call
<citerefentry><refentrytitle>systemd-logind</refentrytitle><manvolnum>8</manvolnum></citerefentry>'s
<command>org.freedesktop.login1.Manager.PowerOff</command> D-Bus method
directly.</para>
<para><filename>runlevel0.target</filename> is an alias for
this target unit, for compatibility with SysV.</para>
@ -443,8 +455,12 @@
<para>A special target unit for shutting down and rebooting
the system.</para>
<para>Applications wanting to reboot the system should start
this unit.</para>
<para>Applications wanting to reboot the system should not start this unit
directly, but should instead execute <command>systemctl reboot</command>
(possibly with the <option>--no-block</option> option) or call
<citerefentry><refentrytitle>systemd-logind</refentrytitle><manvolnum>8</manvolnum></citerefentry>'s
<command>org.freedesktop.login1.Manager.Reboot</command> D-Bus method
directly.</para>
<para><filename>runlevel6.target</filename> is an alias for
this target unit, for compatibility with SysV.</para>