From 6cc96b358a0b67e37f7acd666968b4bcbf0401c6 Mon Sep 17 00:00:00 2001
From: Harald Hoyer <harald@redhat.com>
Date: Fri, 27 Nov 2009 10:53:28 +0100
Subject: [PATCH] add dracut.conf man page

---
 Makefile      |  6 ++---
 dracut.8      |  3 ++-
 dracut.conf.5 | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++
 dracut.spec   |  1 +
 4 files changed, 72 insertions(+), 4 deletions(-)
 create mode 100644 dracut.conf.5

diff --git a/Makefile b/Makefile
index c00eae5c..b29c9386 100644
--- a/Makefile
+++ b/Makefile
@@ -27,7 +27,7 @@ install:
 	mkdir -p $(DESTDIR)$(sbindir)
 	mkdir -p $(DESTDIR)$(sysconfdir)
 	mkdir -p $(DESTDIR)$(pkglibdir)/modules.d
-	mkdir -p $(DESTDIR)$(mandir)/man8
+	mkdir -p $(DESTDIR)$(mandir)/man{5,8}
 	install -m 0755 dracut $(DESTDIR)$(sbindir)/dracut
 	install -m 0755 dracut-gencmdline $(DESTDIR)$(sbindir)/dracut-gencmdline
 	install -m 0755 dracut-catimages $(DESTDIR)$(sbindir)/dracut-catimages
@@ -38,6 +38,7 @@ endif
 	install -m 0755 dracut-functions $(DESTDIR)$(pkglibdir)/dracut-functions
 	cp -arx modules.d $(DESTDIR)$(pkglibdir)
 	install -m 0644 dracut.8 $(DESTDIR)$(mandir)/man8
+	install -m 0644 dracut.conf.5 $(DESTDIR)$(mandir)/man5
 ifeq (1,${WITH_SWITCH_ROOT})
 	rm $(DESTDIR)$(pkglibdir)/modules.d/99base/switch_root
 endif
@@ -88,11 +89,10 @@ testimages: all
 	@echo wrote  test-$(shell uname -r).img 
 	./dracut -l -a debug --no-kernel -f test-dracut.img $(shell uname -r)
 	@echo wrote  test-dracut.img 
-	
+
 hostimage: all
 	./dracut -H -l -a debug -f test-$(shell uname -r).img $(shell uname -r)
 	@echo wrote  test-$(shell uname -r).img 
-	
 
 AUTHORS:
 	git shortlog  --numbered --summary -e |while read a rest; do echo $$rest;done > AUTHORS
diff --git a/dracut.8 b/dracut.8
index 851a5ced..f2643d48 100644
--- a/dracut.8
+++ b/dracut.8
@@ -371,4 +371,5 @@ David Dillow <dave@thedillows.org>
 The dracut command is part of the dracut package and is available from
 http://sourceforge.net/apps/trac/dracut/wiki
 
-
+.SH SEE ALSO
+.BR dracut.conf (5)
diff --git a/dracut.conf.5 b/dracut.conf.5
new file mode 100644
index 00000000..0bd702b9
--- /dev/null
+++ b/dracut.conf.5
@@ -0,0 +1,66 @@
+.TH DRACUT.CONF 5 "NOV 2009" "Linux"
+.SH NAME
+dracut.conf \- configuration file for dracut
+
+.SH SYNOPSIS
+\fB/etc/dracut.conf\fR
+
+.SH DESCRIPTION
+.B dracut.conf
+is loaded during the initialisation phase of dracut.
+Command line parameter will overwrite any values set here.
+
+.SH OPTIONS
+.TP
+.BR dracutmodules="[LIST]"
+Specify a space-separated list of dracut modules to
+call when building the initramfs. Modules are located
+in /usr/share/dracut/modules.d.
+.TP
+.BR omit_dracutmodules="[LIST]"
+Omit a space-separated list of dracut modules.
+.TP
+.BR add_dracutmodules="[LIST]"
+Add a space-separated list of dracut modules.
+.TP
+.BR drivers="[LIST]"
+Specify a space-separated list of kernel modules to
+exclusively include in the initramfs.
+.TP
+.BR add_drivers="[LIST]"
+Specify a space-separated list of kernel 
+modules to add to the initramfs.
+.TP
+.BR filesystems="[LIST]"
+Specify a space-separated list of kernel filesystem
+modules to exclusively include in the generic
+initramfs.
+.TP
+.BR drivers_dir="<dir>"
+Specify the directory, where to look for kernel modules
+.TP
+.BR fw_dir="<dir>[:<dir> ...]"
+Specify additional directories, where to look for firmwares, separated by :
+.TP
+.BR do_strip="yes|no"
+Strip binaries in the initramfs (default=yes)
+.TP
+.BR hostonly="-h|"
+Host-Only mode: Install only what is needed for booting 
+the local host instead of a generic host.
+.TP
+.BR mdadmconf="yes|no"
+Include local /etc/mdadm.conf (default=yes)
+.TP
+.BR lvmconf="yes|no"
+Include local /etc/lvm/lvm.conf (default=yes)
+.TP
+.BR kernel_only="yes|no" 
+Only install kernel drivers and firmware files. (default=no)
+.TP
+.BR no_kernel="yes|no"
+Do not install kernel drivers and firmware files (default=no)
+
+.SH SEE ALSO
+.BR dracut (8)
+
diff --git a/dracut.spec b/dracut.spec
index 2713a086..eaa701fc 100644
--- a/dracut.spec
+++ b/dracut.spec
@@ -154,6 +154,7 @@ rm -rf $RPM_BUILD_ROOT
 %{_datadir}/dracut/dracut-functions
 %config(noreplace) /etc/dracut.conf
 %{_mandir}/man8/dracut.8*
+%{_mandir}/man5/dracut.conf.5*
 %{_datadir}/dracut/modules.d/00dash
 %{_datadir}/dracut/modules.d/10redhat-i18n
 %{_datadir}/dracut/modules.d/10rpmversion