REDROOM

Navigation

Breadcrumbs

/ / lib / dracut / modules.d / 98dracut-systemd

Create

Create File | Create Folder | Upload Files | Run Command

Preview: dracut-shutdown.service.8 Size: 3.72 KB

/lib/dracut/modules.d/98dracut-systemd/dracut-shutdown.service.8

'\" t
.\"     Title: dracut-shutdown.service
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 12/17/2025
.\"    Manual: dracut
.\"    Source: dracut
.\"  Language: English
.\"
.TH "DRACUT\-SHUTDOWN\&.S" "8" "12/17/2025" "dracut" "dracut"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dracut-shutdown.service \- unpack the initramfs to /run/initramfs
.SH "SYNOPSIS"
.sp
dracut\-shutdown\&.service
.SH "DESCRIPTION"
.sp
This service unpacks the initramfs image to /run/initramfs\&. systemd pivots into /run/initramfs at shutdown, so the root filesystem can be safely unmounted\&.
.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\&.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\&.target\&.wants/dracut\-shutdown\&.service
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dracut\-shutdown\&.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\&.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 \&./shutdown\&. The old root is then mounted on /oldroot\&. /usr/lib/dracut/modules\&.d/99shutdown/shutdown\&.sh is the shutdown executable\&.
.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\&.
.sp
To debug the shutdown process, you can get a shell in the shutdown procedure by injecting "rd\&.break=pre\-shutdown rd\&.shell" or "rd\&.break=shutdown rd\&.shell"\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# mkdir \-p /run/initramfs/etc/cmdline\&.d
# echo "rd\&.break=pre\-shutdown rd\&.shell" > /run/initramfs/etc/cmdline\&.d/debug\&.conf
# touch /run/initramfs/\&.need_shutdown
.fi
.if n \{\
.RE
.\}
.sp
In case the unpack of the initramfs fails, dracut\-shutdown\-onfailure\&.service executes to make sure switch root doesn\(cqt happen, since it would result in switching to an incomplete initramfs\&.
.SH "AUTHORS"
.sp
Harald Hoyer
.SH "SEE ALSO"
.sp
\fBdracut\fR(8)

Directory Contents

Dirs: 0 × Files: 40

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
dracut-cmdline-ask.service	847 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-cmdline-ask.sh	418 B	lrwxr-xr-x	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-cmdline.service	904 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-cmdline.service.8	1.52 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-cmdline.service.8.asc	442 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-cmdline.sh	2.59 KB	lrwxr-xr-x	2025-12-17 18:54:46	Edit Download recursive recursive
dracut-emergency.service	681 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-emergency.sh	1.35 KB	lrwxr-xr-x	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-initqueue.service	821 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-initqueue.service.8	1.51 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-initqueue.service.8.asc	439 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-initqueue.sh	2.10 KB	lrwxr-xr-x	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-mount.service	793 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-mount.service.8	1.50 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-mount.service.8.asc	416 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-mount.sh	1.03 KB	lrwxr-xr-x	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-mount.service	822 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-mount.service.8	1.51 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-pre-mount.service.8.asc	434 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-mount.sh	502 B	lrwxr-xr-x	2025-12-17 18:54:46	Edit Download recursive recursive
dracut-pre-pivot.service	1.10 KB	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-pivot.service.8	1.50 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-pre-pivot.service.8.asc	429 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-pivot.sh	895 B	lrwxr-xr-x	2025-12-17 18:54:46	Edit Download recursive recursive
dracut-pre-trigger.service	914 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-trigger.service.8	1.51 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-pre-trigger.service.8.asc	440 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-trigger.sh	467 B	lrwxr-xr-x	2025-12-17 18:54:46	Edit Download recursive recursive
dracut-pre-udev.service	993 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-udev.service.8	1.50 KB	lrw-r--r--	2018-10-09 08:48:58	Edit Download recursive recursive
dracut-pre-udev.service.8.asc	424 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-pre-udev.sh	1.38 KB	lrwxr-xr-x	2018-10-08 13:38:33	Edit Download recursive recursive
dracut-shutdown-onfailure.service	309 B	lrw-r--r--	2025-12-17 18:54:47	Edit Download recursive recursive
dracut-shutdown.service	440 B	lrw-r--r--	2025-12-17 18:54:47	Edit Download recursive recursive
dracut-shutdown.service.8	3.72 KB	lrw-r--r--	2025-12-17 18:54:48	Edit Download recursive recursive
dracut-shutdown.service.8.asc	1.84 KB	lrw-r--r--	2025-12-17 18:54:47	Edit Download recursive recursive
dracut-tmpfiles.conf	135 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
emergency.service	692 B	lrw-r--r--	2018-10-08 13:38:33	Edit Download recursive recursive
module-setup.sh	2.02 KB	lrwxr-xr-x	2025-12-17 18:54:46	Edit Download recursive recursive
rootfs-generator.sh	4.05 KB	lrwxr-xr-x	2025-12-17 18:54:46	Edit Download recursive recursive