man/systemd-halt.service.8

   1 '\" t
   2 .TH "SYSTEMD\-HALT\&.SERVICE" "8" "" "systemd 208" "systemd-halt.service"
   3 .\" -----------------------------------------------------------------
   4 .\" * Define some portability stuff
   5 .\" -----------------------------------------------------------------
   6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7 .\" http://bugs.debian.org/507673
   8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
   9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10 .ie \n(.g .ds Aq \(aq
  11 .el       .ds Aq '
  12 .\" -----------------------------------------------------------------
  13 .\" * set default formatting
  14 .\" -----------------------------------------------------------------
  15 .\" disable hyphenation
  16 .nh
  17 .\" disable justification (adjust text to left margin only)
  18 .ad l
  19 .\" -----------------------------------------------------------------
  20 .\" * MAIN CONTENT STARTS HERE *
  21 .\" -----------------------------------------------------------------
  22 .SH "NAME"
  23 systemd-halt.service, systemd-poweroff.service, systemd-reboot.service, systemd-kexec.service, systemd-shutdown \- System shutdown logic
  24 .SH "SYNOPSIS"
  25 .PP
  26 systemd\-halt\&.service
  27 .PP
  28 systemd\-poweroff\&.service
  29 .PP
  30 systemd\-reboot\&.service
  31 .PP
  32 systemd\-kexec\&.service
  33 .PP
  34 /usr/lib/systemd/systemd\-shutdown
  35 .SH "DESCRIPTION"
  36 .PP
  37 systemd\-halt\&.service
  38 is a system service that is pulled in by
  39 halt\&.target
  40 and is responsible for the actual system halt\&. Similar,
  41 systemd\-poweroff\&.service
  42 is pulled in by
  43 poweroff\&.target,
  44 systemd\-reboot\&.service
  45 by
  46 reboot\&.target
  47 and
  48 systemd\-kexec\&.service
  49 by
  50 kexec\&.target
  51 to execute the respective actions\&.
  52 .PP
  53 When these services are run they ensure that PID 1 is replaced by the
  54 /usr/lib/systemd/systemd\-shutdown
  55 tool which is then responsible for the actual shutdown\&. Before shutting down this binary will try to unmount all remaining file systems, disable all remaining swap devices, detach all remaining storage devices and kill all remaining processes\&.
  56 .PP
  57 Immediately before executing the actual system halt/poweroff/reboot/kexec
  58 systemd\-shutdown
  59 will run all executables in
  60 /usr/lib/systemd/system\-shutdown/
  61 and pass one arguments to them: either
  62 "halt",
  63 "poweroff",
  64 "reboot"
  65 or
  66 "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\&.
  67 .PP
  68 Note that
  69 systemd\-halt\&.service
  70 (and the related units) should never be executed directly\&. Instead, trigger system shutdown with a command such as
  71 "systemctl halt"
  72 or suchlike\&.
  73 .SH "SEE ALSO"
  74 .PP
  75 \fBsystemd\fR(1),
  76 \fBsystemctl\fR(1),
  77 \fBsystemd.special\fR(7),
  78 \fBreboot\fR(2),
  79 \fBsystemd-suspend.service\fR(8)