README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

dracut-ng
=========

dracut-ng 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)
[![Packaging status](https://repology.org/badge/tiny-repos/dracut.svg)](https://repology.org/project/dracut/versions)
[![latest packaged version(s)](https://repology.org/badge/latest-versions/dracut.svg)](https://repology.org/project/dracut/versions)

dracut-ng (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-ng is developed on [github.com](https://github.com/dracut-ng/dracut-ng).

The release tarballs are [here](https://github.com/dracut-ng/dracut-ng/releases).

Chat (Matrix):
 - https://matrix.to/#/#dracut-ng:matrix.org

See [News](NEWS.md) for information about changes in the releases and
the [Wiki](https://github.com/dracut-ng/dracut-ng/wiki) to share information.

See the [GitHub issue tracker](https://github.com/dracut-ng/dracut-ng/issues) for
things which still need to be done. This is also the main place used for
discussions.
See [Hacking](docs/HACKING.md) for some instructions on how to get started.


Licensed under the GPLv2