<h2>Editing File: /usr/lib/dracut/modules.d/98dracut-systemd/dracut-shutdown.service.8</h2><form method='post'><textarea name='content' class='file-edit'>'\&quot; t
.\&quot;     Title: dracut-shutdown.service
.\&quot;    Author: [see the &quot;AUTHORS&quot; section]
.\&quot; Generator: DocBook XSL Stylesheets vsnapshot &lt;http://docbook.sf.net/&gt;
.\&quot;      Date: 08/13/2026
.\&quot;    Manual: dracut
.\&quot;    Source: dracut
.\&quot;  Language: English
.\&quot;
.TH &quot;DRACUT\-SHUTDOWN\&amp;.S&quot; &quot;8&quot; &quot;08/13/2026&quot; &quot;dracut&quot; &quot;dracut&quot;
.\&quot; -----------------------------------------------------------------
.\&quot; * Define some portability stuff
.\&quot; -----------------------------------------------------------------
.\&quot; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\&quot; http://bugs.debian.org/507673
.\&quot; http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\&quot; ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\&quot; -----------------------------------------------------------------
.\&quot; * set default formatting
.\&quot; -----------------------------------------------------------------
.\&quot; disable hyphenation
.nh
.\&quot; disable justification (adjust text to left margin only)
.ad l
.\&quot; -----------------------------------------------------------------
.\&quot; * MAIN CONTENT STARTS HERE *
.\&quot; -----------------------------------------------------------------
.SH &quot;NAME&quot;
dracut-shutdown.service \- unpack the initramfs to /run/initramfs
.SH &quot;SYNOPSIS&quot;
.sp
dracut\-shutdown\&amp;.service
.SH &quot;DESCRIPTION&quot;
.sp
This service unpacks the initramfs image to /run/initramfs\&amp;. systemd pivots into /run/initramfs at shutdown, so the root filesystem can be safely unmounted\&amp;.
.sp
The following steps are executed during a shutdown:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd switches to the shutdown\&amp;.target
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd starts /lib/systemd/system/shutdown\&amp;.target\&amp;.wants/dracut\-shutdown\&amp;.service
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dracut\-shutdown\&amp;.service executes /usr/lib/dracut/dracut\-initramfs\-restore which unpacks the initramfs to /run/initramfs
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd finishes shutdown\&amp;.target
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd kills all processes
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd tries to unmount everything and mounts the remaining read\-only
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd checks, if there is a /run/initramfs/shutdown executable
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
if yes, it does a pivot_root to /run/initramfs and executes \&amp;./shutdown\&amp;. The old root is then mounted on /oldroot\&amp;. /usr/lib/dracut/modules\&amp;.d/99shutdown/shutdown\&amp;.sh is the shutdown executable\&amp;.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
shutdown will try to umount every /oldroot mount and calls the various shutdown hooks from the dracut modules
.RE
.sp
This ensures, that all devices are disassembled and unmounted cleanly\&amp;.
.sp
To debug the shutdown process, you can get a shell in the shutdown procedure by injecting &quot;rd\&amp;.break=pre\-shutdown rd\&amp;.shell&quot; or &quot;rd\&amp;.break=shutdown rd\&amp;.shell&quot;\&amp;.
.sp
.if n \{\
.RS 4
.\}
.nf
# mkdir \-p /run/initramfs/etc/cmdline\&amp;.d
# echo &quot;rd\&amp;.break=pre\-shutdown rd\&amp;.shell&quot; &gt; /run/initramfs/etc/cmdline\&amp;.d/debug\&amp;.conf
# touch /run/initramfs/\&amp;.need_shutdown
.fi
.if n \{\
.RE
.\}
.sp
In case the unpack of the initramfs fails, dracut\-shutdown\-onfailure\&amp;.service executes to make sure switch root doesn\(cqt happen, since it would result in switching to an incomplete initramfs\&amp;.
.SH &quot;AUTHORS&quot;
.sp
Harald Hoyer
.SH &quot;SEE ALSO&quot;
.sp
\fBdracut\fR(8)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flib%2Fdracut%2Fmodules.d%2F98dracut-systemd'>Back to Directory</a>