diff options
| author | Lennart Poettering <lennart@poettering.net> | 2023-05-03 10:33:01 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2023-06-02 18:43:10 +0200 |
| commit | 4de665812aa83fffcdf7395eccc7e0b1d74ef4c2 (patch) | |
| tree | 25ced01a62bf3e81cf17a77706f2e786788360c0 /man/systemd.special.xml | |
| parent | fstab-util: consider /run/nextroot/ among extrinsic mounts (diff) | |
| download | systemd-4de665812aa83fffcdf7395eccc7e0b1d74ef4c2.tar.xz systemd-4de665812aa83fffcdf7395eccc7e0b1d74ef4c2.zip | |
man: document the soft reboot operation
Diffstat (limited to 'man/systemd.special.xml')
| -rw-r--r-- | man/systemd.special.xml | 56 |
1 files changed, 40 insertions, 16 deletions
diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 1620895511..c90e7156ed 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -81,6 +81,7 @@ <filename>slices.target</filename>, <filename>smartcard.target</filename>, <filename>sockets.target</filename>, + <filename>soft-reboot.target</filename>, <filename>sound.target</filename>, <filename>suspend.target</filename>, <filename>swap.target</filename>, @@ -442,15 +443,18 @@ <varlistentry> <term><filename>kexec.target</filename></term> <listitem> - <para>A special target unit for shutting down and rebooting - the system via kexec.</para> + <para>A special target unit for shutting down and rebooting the system via kexec.</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 + <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-logind</refentrytitle><manvolnum>8</manvolnum></citerefentry>'s + <function>org.freedesktop.login1.Manager.RebootWithFlags()</function> D-Bus method directly.</para> + + <para>See + <citerefentry><refentrytitle>systemd-kexec.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + for further details of the operation this target pulls in.</para> </listitem> </varlistentry> <varlistentry> @@ -559,18 +563,20 @@ <varlistentry> <term><filename>reboot.target</filename></term> <listitem> - <para>A special target unit for shutting down and rebooting - the system.</para> + <para>A special target unit for shutting down and rebooting the system.</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 + <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> + <function>org.freedesktop.login1.Manager.Reboot()</function> D-Bus method directly.</para> - <para><filename>runlevel6.target</filename> is an alias for - this target unit, for compatibility with SysV.</para> + <para>See + <citerefentry><refentrytitle>systemd-reboot.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + for further details of the operation this target pulls in.</para> + + <para><filename>runlevel6.target</filename> is an alias for this target unit, for compatibility + with SysV.</para> </listitem> </varlistentry> <varlistentry> @@ -704,6 +710,24 @@ </listitem> </varlistentry> <varlistentry> + <term><filename>soft-reboot.target</filename></term> + <listitem> + <para>A special target unit for shutting down and rebooting the userspace of the system (leaving + the kernel running).</para> + + <para>Applications wanting to reboot the system should not start this unit directly, but should + instead execute <command>systemctl soft-reboot</command> (possibly with the + <option>--no-block</option> option) or call + <citerefentry><refentrytitle>systemd-logind</refentrytitle><manvolnum>8</manvolnum></citerefentry>'s + <function>org.freedesktop.login1.Manager.RebootWithFlags()</function> D-Bus method + directly.</para> + + <para>See + <citerefentry><refentrytitle>systemd-soft-reboot.service</refentrytitle><manvolnum>8</manvolnum></citerefentry> + for further details of the operation this target pulls in.</para> + </listitem> + </varlistentry> + <varlistentry> <term><filename>suspend.target</filename></term> <listitem> <para>A special target unit for suspending the system. This |