summaryrefslogtreecommitdiffstats
path: root/builder/readme.md
diff options
context:
space:
mode:
authortorben2016-03-11 11:30:09 +0100
committertorben2016-03-11 11:30:09 +0100
commit10d670d5da02bf569660478e6ac5c82f3e04f65c (patch)
tree15d586ef74e589f50676ae4bcf90b3b27a7c73b8 /builder/readme.md
parentMerge branch 'master' of git.openslx.org:openslx-ng/systemd-init (diff)
downloadsystemd-init-10d670d5da02bf569660478e6ac5c82f3e04f65c.tar.gz
systemd-init-10d670d5da02bf569660478e6ac5c82f3e04f65c.tar.xz
systemd-init-10d670d5da02bf569660478e6ac5c82f3e04f65c.zip
Tidy up readme.
Diffstat (limited to 'builder/readme.md')
-rw-r--r--builder/readme.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/builder/readme.md b/builder/readme.md
new file mode 100644
index 00000000..113d30c2
--- /dev/null
+++ b/builder/readme.md
@@ -0,0 +1,21 @@
+This subfolder is dedicated to dracut related files.
+
+The folder 'dnbd3-rootfs' is a dracut module used to setup
+a client's rootfs based on a (read-only) dnbd3 export made writable
+through the kernel device mapper features.
+
+To use this module within dracut, you simply need to copy/link/mount
+the above mentioned folder to '/usr/lib/dracut/modules.d' prefixed
+with a numerical priority. We used '90' so far, so the module was linked
+to '/usr/lib/dracut/modules.d/90dnbd3-rootfs'.
+
+Once the module has been integrated in dracut's modules, you can build
+the initramfs with the following command:
+
+ dracut --no-hostonly --modules "dnbd3-rootfs" <target_path>
+
+Note that the '--no-hostonly' is critical if the machine dracut is
+executed on and the clients supposed to boot the resulting initramfs
+differ.
+
+For more informations see: https://lab.ks.uni-freiburg.de/projects/dracut-praktikum/wiki