1 <html><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8"><title>systemd-halt.service
</title><meta name=
"generator" content=
"DocBook XSL Stylesheets V1.78.1"></head><body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF"><style>
11 background-color: #c60f0f;
15 h1:hover
> a.headerlink, h2:hover
> a.headerlink, h3:hover
> a.headerlink, dt:hover
> a.headerlink {
18 </style><a href=
"index.html">Index
</a>·
19 <a href=
"systemd.directives.html">Directives
</a>·
20 <a href=
"../python-systemd/index.html">Python
</a>·
21 <a href=
"../libudev/index.html">libudev
</a>·
22 <a href=
"../libudev/index.html">gudev
</a><span style=
"float:right">systemd
208</span><hr><div class=
"refentry"><a name=
"systemd-halt.service"></a><div class=
"titlepage"></div><div class=
"refnamediv"><h2>Name
</h2><p>systemd-halt.service, systemd-poweroff.service, systemd-reboot.service, systemd-kexec.service, systemd-shutdown — System shutdown logic
</p></div><div class=
"refsynopsisdiv"><h2>Synopsis
</h2><p><code class=
"filename">systemd-halt.service
</code></p><p><code class=
"filename">systemd-poweroff.service
</code></p><p><code class=
"filename">systemd-reboot.service
</code></p><p><code class=
"filename">systemd-kexec.service
</code></p><p><code class=
"filename">/usr/lib/systemd/systemd-shutdown
</code></p></div><div class=
"refsect1"><a name=
"idm274689319632"></a><h2 id=
"Description">Description
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#Description">¶
</a></h2><p><code class=
"filename">systemd-halt.service
</code> is a
23 system service that is pulled in by
24 <code class=
"filename">halt.target
</code> and is responsible
25 for the actual system halt. Similar,
26 <code class=
"filename">systemd-poweroff.service
</code> is
27 pulled in by
<code class=
"filename">poweroff.target
</code>,
28 <code class=
"filename">systemd-reboot.service
</code> by
29 <code class=
"filename">reboot.target
</code> and
30 <code class=
"filename">systemd-kexec.service
</code> by
31 <code class=
"filename">kexec.target
</code> to execute the
32 respective actions.
</p><p>When these services are run they ensure that PID
34 <code class=
"filename">/usr/lib/systemd/systemd-shutdown
</code>
35 tool which is then responsible for the actual
36 shutdown. Before shutting down this binary will try to
37 unmount all remaining file systems, disable all
38 remaining swap devices, detach all remaining storage
39 devices and kill all remaining processes.
</p><p>Immediately before executing the actual system
40 halt/poweroff/reboot/kexec
41 <code class=
"filename">systemd-shutdown
</code> will run all
43 <code class=
"filename">/usr/lib/systemd/system-shutdown/
</code>
44 and pass one arguments to them: either
45 "<code class="literal
">halt</code>",
46 "<code class="literal
">poweroff</code>",
47 "<code class="literal
">reboot</code>" or
48 "<code class="literal
">kexec</code>", depending on the chosen
49 action. All executables in this directory are executed
50 in parallel, and execution of the action is not
51 continued before all executables finished.
</p><p>Note that
52 <code class=
"filename">systemd-halt.service
</code> (and the
53 related units) should never be executed
54 directly. Instead, trigger system shutdown with a
55 command such as
"<code class="literal
">systemctl halt</code>" or
56 suchlike.
</p></div><div class=
"refsect1"><a name=
"idm274693257936"></a><h2 id=
"See Also">See Also
<a class=
"headerlink" title=
"Permalink to this headline" href=
"#See%20Also">¶
</a></h2><p>
57 <a href=
"systemd.html"><span class=
"citerefentry"><span class=
"refentrytitle">systemd
</span>(
1)
</span></a>,
58 <a href=
"systemctl.html"><span class=
"citerefentry"><span class=
"refentrytitle">systemctl
</span>(
1)
</span></a>,
59 <a href=
"systemd.special.html"><span class=
"citerefentry"><span class=
"refentrytitle">systemd.special
</span>(
7)
</span></a>,
60 <a href=
"reboot.html"><span class=
"citerefentry"><span class=
"refentrytitle">reboot
</span>(
2)
</span></a>,
61 <a href=
"systemd-suspend.service.html"><span class=
"citerefentry"><span class=
"refentrytitle">systemd-suspend.service
</span>(
8)
</span></a>
62 </p></div></div></body></html>