[gentoo-commits] proj/genkernel:master commit in: doc/

[Thomas Deutschmann]

commit:     3c86ab829d04a3c7637f63091f3416b5015acd6d
Author:     Thomas Deutschmann <whissi <AT> gentoo <DOT> org>
AuthorDate: Tue Aug  6 21:52:11 2019 +0000
Commit:     Thomas Deutschmann <whissi <AT> gentoo <DOT> org>
CommitDate: Wed Aug  7 15:03:45 2019 +0000
URL:        https://gitweb.gentoo.org/proj/genkernel.git/commit/?id=3c86ab82

manpage: Add documentation about initramfs.mounts file

Bug: https://bugs.gentoo.org/560710
Signed-off-by: Thomas Deutschmann <whissi <AT> gentoo.org>

 doc/genkernel.8.txt | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/genkernel.8.txt b/doc/genkernel.8.txt
index 3ebd320..82da1e1 100644
--- a/doc/genkernel.8.txt
+++ b/doc/genkernel.8.txt
@@ -877,6 +877,18 @@ make sure that this mountpoint is accessible, see *initramfs.mounts*.
     Loop-mount an ISO file from the boot device to get the filesystem image.
     Useful with chain-loading environments and USB keys.
 
+initramfs.mounts
+----------------
+By default, genkernel's initramfs will only mount *root* device. But
+sometimes additional mounts are required before initramfs can switch to
+real root (for example on systems with a seperate '/usr' mount).
+
+Therefore genkernel package contains '/etc/initramfs.mounts' file which
+will allow you to specify additional mounts which should be mounted before
+initramfs will switch to real root.
+
+NOTE: This file will not be included in initramfs. Instead, booted initramfs
+will check for this file on specified *root* device.
 
 NETBOOTING
 ----------
@@ -930,6 +942,8 @@ AUTHORS
 
 SEE ALSO
 --------
+'/etc/initramfs.mounts' - additional required mounts before switching to real root
+
 '/etc/genkernel.conf' - genkernel configuration file
 
 // vim: ft=asciidoc et tw=72 sts=4 ts=4 :