Google Git
Sign in
kernel / pub / scm / boot / dracut / dracut / d0de58f23252a9da4a8badd71777e7c8418fa4b7
commitd0de58f23252a9da4a8badd71777e7c8418fa4b7[log] [tgz]
authorJonathan Lebon <jonathan@jlebon.com>Tue Jan 21 17:57:31 2020 -0500
committerHarald Hoyer <harald@hoyer.xyz>Thu Jan 23 09:32:25 2020 +0100
tree73ccf4e019a948573003e6ac89ebb09d2d04f9b3
parentf4ad2e5c8964b6c7b50420299a0096bade6a40bd [diff]
network-legacy/ifup: nuke pid and lease files if dhclient failed

Otherwise we won't retry dhclient again on that interface. In
FCOS/RHCOS, we want to bake in `ip=dhcp,dhcp6` so we automatically try
getting a DHCPv6 lease if DHCPv4 failed.

Related: https://bugzilla.redhat.com/show_bug.cgi?id=1793591
1 file changed
tree: 73ccf4e019a948573003e6ac89ebb09d2d04f9b3
  1. dracut.conf.d/
  2. examples/
  3. install/
  4. modules.d/
  5. skipcpio/
  6. test/
  7. .dir-locals.el
  8. .gitignore
  9. .kateconfig
  10. .kateproject
  11. .mailmap
  12. .travis.yml
  13. 50-dracut.install
  14. 51-dracut-rescue-postinst.sh
  15. 51-dracut-rescue.install
  16. AUTHORS
  17. configure
  18. COPYING
  19. dracut-bash-completion.sh
  20. dracut-catimages.8.asc
  21. dracut-catimages.sh
  22. dracut-functions.sh
  23. dracut-init.sh
  24. dracut-initramfs-restore.sh
  25. dracut-logger.sh
  26. dracut.8.asc
  27. dracut.asc
  28. dracut.bootup.7.asc
  29. dracut.cmdline.7.asc
  30. dracut.conf
  31. dracut.conf.5.asc
  32. dracut.css
  33. dracut.logrotate
  34. dracut.modules.7.asc
  35. dracut.png
  36. dracut.sh
  37. dracut.spec
  38. dracut.svg
  39. dracut.usage.asc
  40. fedora-test.sh
  41. git2spec.pl
  42. HACKING
  43. logtee.c
  44. lsinitrd-bash-completion.sh
  45. lsinitrd.1.asc
  46. lsinitrd.sh
  47. Makefile
  48. mkinitrd-dracut.sh
  49. mkinitrd-suse.8.asc
  50. mkinitrd-suse.sh
  51. mkinitrd.8.asc
  52. NEWS
  53. PKGBUILD
  54. profile.py
  55. README.cross
  56. README.generic
  57. README.kernel
  58. README.md
  59. README.modules
  60. README.testsuite
  61. TODO
README.md

dracut

dracut is an event driven initramfs infrastructure.

Build Status

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 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 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.

Some general rules for writing modules:

  • Use one of the inst family of functions to actually install files on to the initramfs. 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 initramfs should be POSIX compliant. dracut will try to use /bin/dash as /bin/sh for the initramfs 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 github.com and kernel.org.

The tarballs can be found here: http://www.kernel.org/pub/linux/utils/boot/dracut/ ftp://ftp.kernel.org/pub/linux/utils/boot/dracut/

Git: git://git.kernel.org/pub/scm/boot/dracut/dracut.git http://git.kernel.org/pub/scm/boot/dracut/dracut.git https://git.kernel.org/pub/scm/boot/dracut/dracut.git

git@github.com:dracutdevs/dracut.git

Git Web: https://github.com/dracutdevs/dracut.git

    http://git.kernel.org/?p=boot/dracut/dracut.git

Project Documentation: http://www.kernel.org/pub/linux/utils/boot/dracut/dracut.html

Project Wiki: http://dracut.wiki.kernel.org

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