You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Harald Hoyer 3817c2f138 rootfs-block/mount-root.sh: default rootfs to auto, even without fstab 14 years ago
debian
dracut.conf.d dracut.conf.d/suse.conf.example: remove hostonly mode 15 years ago
modules.d rootfs-block/mount-root.sh: default rootfs to auto, even without fstab 14 years ago
test TEST-50-MULTINIC/test.sh: only set hdc for no cdrom 15 years ago
.gitignore documentation: moved to docbook man pages 15 years ago
.mailmap AUTHORS: update 15 years ago
AUTHORS AUTHORS: update 15 years ago
COPYING
HACKING
Makefile Makefile: use xhtml instead of xhtml-1_1 for the docbook.xsl 15 years ago
NEWS Revert "add option --ignore-kernel-modules" 15 years ago
PKGBUILD Add a PKGBUILD file to make building on Arch Linux from a git checkout easy. 15 years ago
README
README.generic
README.kernel Version 006 15 years ago
README.modules
TODO
dracut Revert "add option --ignore-kernel-modules" 15 years ago
dracut-catimages reformat source code 15 years ago
dracut-catimages.8.xml manpage xml: changed DTD to docbook 4.5 15 years ago
dracut-functions dracut-functions:find_block_device() workaround for btrfs 15 years ago
dracut-gencmdline dracut-gencmdline: strip also _rnetdev 15 years ago
dracut-gencmdline.8.xml manpage xml: changed DTD to docbook 4.5 15 years ago
dracut-update-initramfs reformat source code 15 years ago
dracut.8.xml documentation update 15 years ago
dracut.conf dracut.conf: use "+=" as default for config variables 15 years ago
dracut.conf.5.xml manpage corrections 15 years ago
dracut.kernel.7.xml i18n: move to vconfig.* and locale.* namespace 15 years ago
dracut.spec dracut.spec: bump release 15 years ago
dracut.xml new parameter option names with "rd.*" namespace 15 years ago
lsinitrd lsinitrd: add "catinitrd" functionality 15 years ago
mkinitrd-dracut.sh reformat source 15 years ago
switch_root.c

README

Dracut
------
Dracut is a new initramfs infrastructure.

Information about the initial goals and aims can be found at
https://fedoraproject.org/wiki/Initrdrewrite

Unlike existing initramfs's, this is an attempt at having as little as
possible hard-coded into the initramfs as possible. 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. It's likely that
we'll grow some hooks for running arbitrary commands in the flow of
the script, but it's worth trying to resist the urge as much as we can
as hooks are guaranteed to be the path to slow-down.

Most of the initrd 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 initrd. They live in the modules.d
subdirectory, and use functionality provided by dracut-functions to do their
work.

Some general rules for writing modules:
* Use one of the inst family of functions to actually install files
on to the initrd. They handle mangling the pathnames and (for binaries,
scripts, and kernel modules) installing dependencies as appropriate so
you do not have to.
* Scripts that end up on the initrd should be POSIX compliant. dracut
will try to use /bin/dash as /bin/sh for the initrd if it is available,
so you should install it on your system -- dash aims for strict POSIX
compliance to the extent possible.
* Hooks MUST be POSIX compliant -- they are sourced by the init script,
and having a bashism break your user's ability to boot really sucks.
* Generator modules should have a two digit numeric prefix -- they run in
ascending sort order. Anything in the 90-99 range is stuff that dracut
relies on, so try not to break those hooks.
* Hooks must have a .sh extension.
* Generator modules are described in more detail in README.modules.
* We have some breakpoints for debugging your hooks. If you pass 'rdbreak'
as a kernel parameter, the initramfs will drop to a shell just before
switching to a new root. You can pass 'rdbreak=hookpoint', and the initramfs
will break just before hooks in that hookpoint run.

Also, there is an attempt to keep things as distribution-agnostic as
possible. Every distribution has their own tool here and it's not
something which is really interesting to have separate across them.
So contributions to help decrease the distro-dependencies are welcome.

Currently dracut lives on sourceforge.

Project Page:
https://sourceforge.net/projects/dracut/

Drop Harald Hoyer <harald@redhat.com> a mail, if you want to help with
the documentation, git access, etc.

Git Repository:
http://dracut.git.sourceforge.net/
git://dracut.git.sourceforge.net/gitroot/dracut/dracut

Trac Instance:
http://apps.sourceforge.net/trac/dracut/

The git tree can be found at
git://dracut.git.sourceforge.net/gitroot/dracut/dracut for now. See the TODO
file for things which still need to be done and HACKING 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