]> git.ipfire.org Git - thirdparty/dracut.git/blobdiff - HACKING
modules.d: Add a module for handling additional depmod kernel module directories
[thirdparty/dracut.git] / HACKING
diff --git a/HACKING b/HACKING
index 77e9939649ad54ae3caa913a507b52995243e1d5..3c3a52da5ab3ff71f6d5f7d0c4f2c4b4e5b0b368 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -1,20 +1,23 @@
-Right now, I'm doing most of my testing using a qemu/kvm guest and
-generating the initramfs on another box.  I then can boot the guest
-using qemu's -kernel and -initrd options.  Currently supported rootfs
-types are regular partitions, root-on-lvm and root-on-lvm-on-encrypted-pv.
+Right now, most of the testing is done using a qemu/kvm guest and
+generating the initramfs on another box but the support is all present
+to build for the "running" machine.  For the former, you can boot the guest
+using qemu's -kernel and -initrd options.
 
-generate.sh exists and will build an image.  Right now, it depends on
-some existing pieces of the Fedora initrd infrastructure, but moving
-those out is a priority now that the basic functionality has been
-proven.
+dracut exists and will build an image.  It is command-line equivalent
+to most mkinitrd implementations and should be pretty straight-forward
+to use.
 
-To use, just run generate.sh with an output file for the initrd.  It
-will copy over some binaries as well as the appropriate shared library
-dependencies.  If you are doing a rootfs type that requires modules
-(on Fedora, this is just encrypted root now), you'll want to have the
-modules tree to copy in in a modules/ sub directory.  
+To use, just run dracut with an output file name and, optionally, a
+kernel version (it defaults to using the current).   The appropriate
+modules will be copied over and things should be good to go.  If you'd
+like to customize the list of modules copied in, edit /etc/dracut.conf
+and set
+  dracutmodules="foo bar baz"
+
+Note that dracut calls functional components in modules.d "modules"
+while kernel modules are called "drivers".
 
 Requirements:
 * udev
-* plymouth > 0.6.0-2 (for encrypted root; otherwise, it should noop out)
-* nash (for switchroot until we get in util-linux)
+* nfs module: nfs daemon and rpc helper
+* iscsi: iscsi