summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md50
1 files changed, 50 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c584e90
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+dracut
+====
+
+dracut is an event driven initramfs infrastructure.
+
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](docs/CODE_OF_CONDUCT.md)
+
+dracut (the tool) is used to create an initramfs image by copying tools
+and files from an installed system and combining it with the
+dracut framework, usually found in /usr/lib/dracut/modules.d.
+
+Unlike other implementations, dracut hard-codes as little
+as possible into the initramfs. The initramfs has
+(basically) one purpose in life -- getting the rootfs mounted so that
+we can transition to the real rootfs. This is all driven off of
+device availability. Therefore, instead of scripts hard-coded to do
+various things, we depend on udev to create device nodes for us and
+then when we have the rootfs's device node, we mount and carry on.
+This helps to keep the time required in the initramfs as little as
+possible so that things like a 5 second boot aren't made impossible as
+a result of the very existence of an initramfs.
+
+Most of the initramfs generation functionality in dracut is provided by a bunch
+of generator modules that are sourced by the main dracut script to install
+specific functionality into the initramfs. They live in the modules.d
+subdirectory, and use functionality provided by dracut-functions to do their
+work.
+
+Documentation:
+ - [Introduction](man/dracut.asc)
+ - [User Manual](man/dracut.usage.asc)
+
+Currently dracut is developed on [github.com](https://github.com/dracutdevs/dracut).
+
+The release tarballs are [here](https://github.com/dracutdevs/dracut/releases).
+
+Gitter (chat):
+ - https://gitter.im/dracutdevs/Lobby
+
+See [News](NEWS.md) for information about changes in the releases and
+the [Wiki](https://github.com/dracutdevs/dracut/wiki) to share information.
+
+See the github issue tracker for things which still need to be done and [Hacking](docs/HACKING.md)
+for some instructions on how to get started. There is also a mailing list
+that is being used for the discussion -- initramfs@vger.kernel.org.
+It is a typical vger list, send mail to majordomo@vger.kernel.org with body
+of 'subscribe initramfs email@host.com'
+
+
+Licensed under the GPLv2