From a1ebd7717957e1e89f5245541c5d2bf308fa5582 Mon Sep 17 00:00:00 2001 From: Harald Hoyer Date: Tue, 19 Mar 2013 12:22:58 +0100 Subject: [PATCH] add dracut.bootup.7 man page --- Makefile | 3 +- dracut.asc | 29 +++++++------ dracut.bootup.7.asc | 122 ++++++++++++++++++++++++++++++++++++++++++++++++++++ dracut.spec | 1 + 4 files changed, 141 insertions(+), 14 deletions(-) create mode 100644 dracut.bootup.7.asc diff --git a/Makefile b/Makefile index ce40647..6268772 100644 --- a/Makefile +++ b/Makefile @@ -18,7 +18,8 @@ man1pages = lsinitrd.1 man5pages = dracut.conf.5 -man7pages = dracut.cmdline.7 +man7pages = dracut.cmdline.7 \ + dracut.bootup.7 man8pages = dracut.8 \ dracut-catimages.8 \ diff --git a/dracut.asc b/dracut.asc index d11e95c..359824f 100644 --- a/dracut.asc +++ b/dracut.asc @@ -120,6 +120,9 @@ final cleanup tasks. On an initramfs, the initial root file system cannot be rotated away. Instead, it is simply emptied and the final root file system mounted over the top. +If the systemd module is used in the initramfs, the ordering of the services +started looks like <>. + == Dracut on shutdown On a systemd driven system, the dracut initramfs is also used for the shutdown procedure. @@ -531,19 +534,19 @@ all files in _/etc/dracut.conf.d/*.conf_ As well as the information from <> include the following information: -* Include physical volume information by running the command: +* Include physical volume information by running the command: + ---- # lvm pvdisplay ---- + -* Include volume group information by running the command: +* Include volume group information by running the command: + ---- # lvm vgdisplay ---- + -* Include logical volume information by running the command: +* Include logical volume information by running the command: + ---- # lvm lvdisplay @@ -554,7 +557,7 @@ information: As well as the information from <>, include the following information: -* If using software RAID disk partitions, please include the output of +* If using software RAID disk partitions, please include the output of + ---- # cat /proc/mdstat @@ -659,7 +662,7 @@ title Fedora (2.6.29.5-191.fc11.x86_64) No root device found Dropping to debug shell. -# +# ---- + . Use this shell prompt to gather the information requested above (see <>). @@ -679,7 +682,7 @@ The exact method for locating and preparing will vary. However, to continue with a successful boot, the objective is to locate your root volume and create a symlink _/dev/root_ which points to the file system. For example, the following example demonstrates accessing and booting a root volume that is an encrypted -LVM Logical volume. +LVM Logical volume. . Inspect your partitions using parted + @@ -695,7 +698,7 @@ Number Start End Size Type File system Flags ---- + . You recall that your root volume was a LVM logical volume. Scan and activate -any logical volumes. +any logical volumes. + ---- # lvm vgscan @@ -721,7 +724,7 @@ Installation Guide, you unlock your encrypted root volume. # UUID=$(cryptsetup luksUUID /dev/mapper/linux-root) # cryptsetup luksOpen /dev/mapper/linux-root luks-$UUID Enter passphrase for /dev/mapper/linux-root: -Key slot 0 unlocked. +Key slot 0 unlocked. ---- + . Next, make a symbolic link to the unlocked root volume @@ -780,7 +783,7 @@ processes, and switches to the real root device for further booting. dracut modules can insert custom script at various points, to control the boot process. These hooks are plain directories containing shell scripts ending with ".sh", which are sourced by init. -Common used functions are in _dracut-lib.sh_, which can be sourced by any script. +Common used functions are in _dracut-lib.sh_, which can be sourced by any script. @@ -829,7 +832,7 @@ udevadm. === Trigger Udev udev is triggered by calling udevadm trigger, which sends add events for all -devices and subsystems. +devices and subsystems. @@ -909,7 +912,6 @@ still running from the initramfs should not have any open file descriptors left. == Network Infrastructure - FIXME @@ -1028,13 +1030,11 @@ instmods === Creation Functions - FIXME === Initramfs Functions - FIXME @@ -1042,6 +1042,9 @@ FIXME FIXME +:leveloffset: 1 +[[dracutbootup7]] +include::dracut.bootup.7.asc[] :leveloffset: 1 [[dracut8]] diff --git a/dracut.bootup.7.asc b/dracut.bootup.7.asc new file mode 100644 index 0000000..c35af19 --- /dev/null +++ b/dracut.bootup.7.asc @@ -0,0 +1,122 @@ +DRACUT.BOOTUP(7) +================ +:doctype: manpage +:man source: dracut +:man manual: dracut + +NAME +---- +dracut.bootup - boot ordering in the initramfs + +DESCRIPTION +----------- + +This flow chart illustrates the ordering of the services, if systemd is used in the dracut initramfs. +---- + + systemd-journal.socket + | + v + dracut-cmdline.service + | + v + dracut-pre-udev.service + | + v + systemd-udevd.service + | + v +local-fs-pre.target dracut-pre-trigger.service + | | + v v + (various mounts) (various swap systemd-udev-trigger.service + | devices...) | (various low-level (various low-level + | | | services: seed, API VFS mounts: + v v v tmpfiles, random mqueue, configfs, + local-fs.target swap.target dracut-initqueue.service sysctl, ...) debugfs, ...) + | | | | | + \_______________|____________________ | ___________________|____________________/ + \|/ + v + sysinit.target + | + _________________/|\___________________ + / | \ + | | | + v | v + (various | rescue.service + sockets...) | | + | | v + v | rescue.target + sockets.target | + | | + \_________________ | emergency.service + \| | + v v + basic.target emergency.target + | + ______________________/| + / | + | v + | dracut-pre-mount.service + | | + | v + | sysroot.mount + | | + | v + | initrd-root-fs.target + (custom initrd services) | + | v + | dracut-mount.service + | | + | v + | initrd-parse-etc.service + | | + | v + | (sysroot-usr.mount and + | various mounts marked + | with fstab option + | x-initrd.mount) + | | + | v + | initrd-fs.target + \______________________ | + \| + v + initrd.target + | + v + dracut-pre-pivot.service + | + v + initrd-cleanup.service + isolates to + initrd-switch-root.target + | + v + ______________________/| + / | + | initrd-udevadm-cleanup-db.service + | | + (custom initrd services) | + | | + \______________________ | + \| + v + initrd-switch-root.target + | + v + initrd-switch-root.service + | + v + switch-root +---- + + +AUTHOR +------ +Harald Hoyer + +SEE ALSO +-------- +*dracut*(8) *bootup*(7) diff --git a/dracut.spec b/dracut.spec index ac4a786..445463f 100644 --- a/dracut.spec +++ b/dracut.spec @@ -304,6 +304,7 @@ rm -rf $RPM_BUILD_ROOT %endif %{_mandir}/man7/dracut.kernel.7* %{_mandir}/man7/dracut.cmdline.7* +%{_mandir}/man7/dracut.bootup.7* %{_mandir}/man5/dracut.conf.5* %if %{defined _unitdir} %{dracutlibdir}/modules.d/00systemd-bootchart