From a1ebd7717957e1e89f5245541c5d2bf308fa5582 Mon Sep 17 00:00:00 2001

From: Harald Hoyer <harald@redhat.com>

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 <<dracutbootup7>>.

+

 == 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 <<all-bug-reports>> 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 <<all-bug-reports>>, 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 <<all-bug-reports>>).

@@ -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