diff --git a/man/bootup.xml b/man/bootup.xml index 27619c29b8..565dda93cb 100644 --- a/man/bootup.xml +++ b/man/bootup.xml @@ -298,8 +298,18 @@ systemd-reboot.service systemd-poweroff.service systemd-halt.service syste v v v v reboot.target poweroff.target halt.target kexec.target - Commonly used system shutdown targets are - emphasized. + Commonly used system shutdown targets are emphasized. + + Note that + systemsystemd-halt.service8, + systemd-reboot.service, systemd-poweroff.service and + systemd-kexec.service will transition the system and server manager (PID 1) into the second + phase of system shutdown (implemented in the systemd-shutdown binary), which will unmount any + remaining file systems, kill any remaining processes and release any other remaining resources, in a simple and + robust fashion, without taking any service or unit concept into account anymore. At that point, regular + applications and resources are generally terminated and released already, the second phase hence operates only as + safety net for everything that couldn't be stopped or released for some reason during the primary, unit-based + shutdown phase described above. @@ -309,6 +319,7 @@ systemd-reboot.service systemd-poweroff.service systemd-halt.service syste boot7, systemd.special7, systemd.target5, + systemd-halt.service8, dracut8 diff --git a/man/systemd-halt.service.xml b/man/systemd-halt.service.xml index b58279d828..a381b5c7d9 100644 --- a/man/systemd-halt.service.xml +++ b/man/systemd-halt.service.xml @@ -114,7 +114,8 @@ systemctl1, systemd.special7, reboot2, - systemd-suspend.service8 + systemd-suspend.service8, + bootup7 diff --git a/man/systemd-system.conf.xml b/man/systemd-system.conf.xml index 5a308f275e..74dee3fd6f 100644 --- a/man/systemd-system.conf.xml +++ b/man/systemd-system.conf.xml @@ -157,31 +157,27 @@ RuntimeWatchdogSec= ShutdownWatchdogSec= - Configure the hardware watchdog at runtime and - at reboot. Takes a timeout value in seconds (or in other time - units if suffixed with ms, - min, h, - d, w). If - RuntimeWatchdogSec= is set to a non-zero - value, the watchdog hardware - (/dev/watchdog or the path specified with - WatchdogDevice= or the kernel option - systemd.watchdog-device=) will be programmed - to automatically reboot the system if it is not contacted within - the specified timeout interval. The system manager will ensure - to contact it at least once in half the specified timeout - interval. This feature requires a hardware watchdog device to - be present, as it is commonly the case in embedded and server - systems. Not all hardware watchdogs allow configuration of the - reboot timeout, in which case the closest available timeout is - picked. ShutdownWatchdogSec= may be used to - configure the hardware watchdog when the system is asked to - reboot. It works as a safety net to ensure that the reboot - takes place even if a clean reboot attempt times out. By - default RuntimeWatchdogSec= defaults to 0 - (off), and ShutdownWatchdogSec= to 10min. - These settings have no effect if a hardware watchdog is not - available. + Configure the hardware watchdog at runtime and at reboot. Takes a timeout value in seconds (or + in other time units if suffixed with ms, min, h, + d, w). If RuntimeWatchdogSec= is set to a non-zero + value, the watchdog hardware (/dev/watchdog or the path specified with + WatchdogDevice= or the kernel option systemd.watchdog-device=) will be + programmed to automatically reboot the system if it is not contacted within the specified timeout interval. The + system manager will ensure to contact it at least once in half the specified timeout interval. This feature + requires a hardware watchdog device to be present, as it is commonly the case in embedded and server + systems. Not all hardware watchdogs allow configuration of all possible reboot timeout values, in which case + the closest available timeout is picked. ShutdownWatchdogSec= may be used to configure the + hardware watchdog when the system is asked to reboot. It works as a safety net to ensure that the reboot takes + place even if a clean reboot attempt times out. Note that the ShutdownWatchdogSec= timeout + applies only to the second phase of the reboot, i.e. after all regular services are already terminated, and + after the system and service manager process (PID 1) got replaced by the systemd-shutdown + binary, see system bootup7 + for details. During the first phase of the shutdown operation the system and service manager remains running + and hence RuntimeWatchdogSec= is still honoured. In order to define a timeout on this first + phase of system shutdown, configure JobTimeoutSec= and JobTimeoutAction= + in the [Unit] section of the shutdown.target unit. By default + RuntimeWatchdogSec= defaults to 0 (off), and ShutdownWatchdogSec= to + 10min. These settings have no effect if a hardware watchdog is not available.