FM / 98dracut-systemd

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

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

Name	Size	Mode	Actions
dracut-cmdline-ask.service	847	0644	edit dl rm
dracut-cmdline-ask.sh	418	0755	edit dl rm
dracut-cmdline.service	904	0644	edit dl rm
dracut-cmdline.service.8	1555	0644	edit dl rm
dracut-cmdline.service.8.asc	442	0644	edit dl rm
dracut-cmdline.sh	2651	0755	edit dl rm
dracut-emergency.service	681	0644	edit dl rm
dracut-emergency.sh	1382	0755	edit dl rm
dracut-initqueue.service	821	0644	edit dl rm
dracut-initqueue.service.8	1550	0644	edit dl rm
dracut-initqueue.service.8.asc	439	0644	edit dl rm
dracut-initqueue.sh	2147	0755	edit dl rm
dracut-mount.service	793	0644	edit dl rm
dracut-mount.service.8	1531	0644	edit dl rm
dracut-mount.service.8.asc	416	0644	edit dl rm
dracut-mount.sh	1052	0755	edit dl rm
dracut-pre-mount.service	822	0644	edit dl rm
dracut-pre-mount.service.8	1546	0644	edit dl rm
dracut-pre-mount.service.8.asc	434	0644	edit dl rm
dracut-pre-mount.sh	502	0755	edit dl rm
dracut-pre-pivot.service	1125	0644	edit dl rm
dracut-pre-pivot.service.8	1541	0644	edit dl rm
dracut-pre-pivot.service.8.asc	429	0644	edit dl rm
dracut-pre-pivot.sh	895	0755	edit dl rm
dracut-pre-trigger.service	914	0644	edit dl rm
dracut-pre-trigger.service.8	1550	0644	edit dl rm
dracut-pre-trigger.service.8.asc	440	0644	edit dl rm
dracut-pre-trigger.sh	467	0755	edit dl rm
dracut-pre-udev.service	993	0644	edit dl rm
dracut-pre-udev.service.8	1537	0644	edit dl rm
dracut-pre-udev.service.8.asc	424	0644	edit dl rm
dracut-pre-udev.sh	1413	0755	edit dl rm
dracut-shutdown-onfailure.service	309	0644	edit dl rm
dracut-shutdown.service	440	0644	edit dl rm
dracut-shutdown.service.8	3813	0644	edit dl rm
dracut-shutdown.service.8.asc	1880	0644	edit dl rm
dracut-tmpfiles.conf	135	0644	edit dl rm
emergency.service	692	0644	edit dl rm
module-setup.sh	2072	0755	edit dl rm
rootfs-generator.sh	4152	0755	edit dl rm

Edit: /usr/lib/dracut/modules.d/98dracut-systemd/dracut-shutdown.service.8.asc (1880B)

DRACUT-SHUTDOWN.SERVICE(8)
===========================
:doctype: manpage
:man source:   dracut
:man manual:   dracut

NAME
----
dracut-shutdown.service - unpack the initramfs to /run/initramfs

SYNOPSIS
--------
dracut-shutdown.service

DESCRIPTION
-----------
This service unpacks the initramfs image to /run/initramfs.
systemd pivots into /run/initramfs at shutdown, so the root filesystem
can be safely unmounted.

The following steps are executed during a shutdown:

* systemd switches to the shutdown.target
* systemd starts /lib/systemd/system/shutdown.target.wants/dracut-shutdown.service
* dracut-shutdown.service executes /usr/lib/dracut/dracut-initramfs-restore which unpacks the initramfs to /run/initramfs
* systemd finishes shutdown.target
* systemd kills all processes
* systemd tries to unmount everything and mounts the remaining read-only
* systemd checks, if there is a /run/initramfs/shutdown executable
* 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.
* shutdown will try to umount every /oldroot mount and calls the various shutdown hooks from the dracut modules

This ensures, that all devices are disassembled and unmounted cleanly.

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".
----
# 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
----

In case the unpack of the initramfs fails, dracut-shutdown-onfailure.service
executes to make sure switch root doesn't happen, since it would result in
switching to an incomplete initramfs.

AUTHORS
-------
Harald Hoyer