dracut.8.asc

   1 DRACUT(8)
   2 =========
   3 :doctype: manpage
   4 :man source:   dracut
   5 :man manual:   dracut
   6
   7 NAME
   8 ----
   9 dracut - low-level tool for generating an initramfs/initrd image
  10
  11 SYNOPSIS
  12 --------
  13 *dracut* [__OPTION...__] [__<image>__ [__<kernel version>__]]
  14
  15 DESCRIPTION
  16 -----------
  17
  18 Create an initramfs <image> for the kernel with the version <kernel version>.
  19 If <kernel version> is omitted, then the version of the actual running
  20 kernel is used. If <image> is omitted or empty, then the default location
  21 /boot/initramfs-<kernel version>.img is used.
  22
  23 dracut creates an initial image used by the kernel for preloading the block
  24 device modules (such as IDE, SCSI or RAID) which are needed to access the root
  25 filesystem, mounting the root filesystem and booting into the real system.
  26
  27 At boot time, the kernel unpacks that archive into RAM disk, mounts and uses it
  28 as initial root file system. All finding of the root device happens in this
  29 early userspace.
  30
  31 Initramfs images are also called "initrd".
  32
  33 For a complete list of kernel command line options see *dracut.cmdline*(7).
  34
  35 If you are dropped to an emergency shell, while booting your initramfs,
  36 the file _/run/initramfs/rdsosreport.txt_ is created, which can be saved to a
  37 (to be mounted by hand) partition (usually /boot) or a USB stick.
  38 Additional debugging info can be produced by adding **rd.debug** to the kernel
  39 command line. _/run/initramfs/rdsosreport.txt_ contains all logs and the output
  40 of some tools. It should be attached to any report about dracut problems.
  41
  42 USAGE
  43 -----
  44
  45 include::dracut.usage.asc[]
  46
  47 OPTIONS
  48 -------
  49 **--kver** _<kernel version>_::
  50     set the kernel version. This enables to specify the kernel version, without
  51     specifying the location of the initramfs image. For example:
  52 ----
  53 # dracut --kver 3.5.0-0.rc7.git1.2.fc18.x86_64
  54 ----
  55
  56 **-f, --force**::
  57     overwrite existing initramfs file.
  58
  59 **-a, --add** _<list of dracut modules>_::
  60     add a space-separated list of dracut modules to the default set of modules.
  61     This parameter can be specified multiple times.
  62 +
  63 [NOTE]
  64 ===============================
  65 If [LIST] has multiple arguments, then you have to put these in quotes. For
  66 example:
  67 ----
  68 # dracut --add "module1 module2"  ...
  69 ----
  70 ===============================
  71
  72 **--force-add** _<list of dracut modules>_::
  73     force to add a space-separated list of dracut modules to the default set of
  74     modules, when -H is specified. This parameter can be specified multiple
  75     times.
  76 +
  77 [NOTE]
  78 ===============================
  79 If [LIST] has multiple arguments, then you have to put these in quotes. For
  80 example:
  81 ----
  82 # dracut --force-add "module1 module2"  ...
  83 ----
  84 ===============================
  85
  86 **-o, --omit** _<list of dracut modules>_::
  87     omit a space-separated list of dracut modules. This parameter can be
  88     specified multiple times.
  89 +
  90 [NOTE]
  91 ===============================
  92 If [LIST] has multiple arguments, then you have to put these in quotes. For
  93 example:
  94 ----
  95 # dracut --omit "module1 module2"  ...
  96 ----
  97 ===============================
  98
  99 **-m, --modules** _<list of dracut modules>_::
 100     specify a space-separated list of dracut modules to call when building the
 101     initramfs. Modules are located in _/usr/lib/dracut/modules.d_. This
 102     parameter can be specified multiple times.
 103     This option forces dracut to only include the specified dracut modules.
 104     In most cases the "--add" option is what you want to use.
 105 +
 106 [NOTE]
 107 ===============================
 108 If [LIST] has multiple arguments, then you have to put these in quotes. For
 109 example:
 110 ----
 111 # dracut --modules "module1 module2"  ...
 112 ----
 113 ===============================
 114
 115 **-d, --drivers** _<list of kernel modules>_::
 116     specify a space-separated list of kernel modules to exclusively include
 117     in the initramfs. The kernel modules have to be specified without the ".ko"
 118     suffix. This parameter can be specified multiple times.
 119 +
 120 [NOTE]
 121 ===============================
 122 If [LIST] has multiple arguments, then you have to put these in quotes. For
 123 example:
 124 ----
 125 # dracut --drivers "kmodule1 kmodule2"  ...
 126 ----
 127 ===============================
 128
 129 **--add-drivers** _<list of kernel modules>_::
 130     specify a space-separated list of kernel modules to add to the initramfs.
 131     The kernel modules have to be specified without the ".ko" suffix. This
 132     parameter can be specified multiple times.
 133 +
 134 [NOTE]
 135 ===============================
 136 If [LIST] has multiple arguments, then you have to put these in quotes. For
 137 example:
 138 ----
 139 # dracut --add-drivers "kmodule1 kmodule2"  ...
 140 ----
 141 ===============================
 142
 143 **--force-drivers** _<list of kernel modules>_::
 144     See add-drivers above. But in this case it is ensured that the drivers
 145     are tried to be loaded early via modprobe.
 146 +
 147 [NOTE]
 148 ===============================
 149 If [LIST] has multiple arguments, then you have to put these in quotes. For
 150 example:
 151 ----
 152 # dracut --force-drivers "kmodule1 kmodule2"  ...
 153 ----
 154 ===============================
 155
 156 **--omit-drivers** _<list of kernel modules>_::
 157     specify a space-separated list of kernel modules not to add to the
 158     initramfs.
 159     The kernel modules have to be specified without the ".ko" suffix. This
 160     parameter can be specified multiple times.
 161 +
 162 [NOTE]
 163 ===============================
 164 If [LIST] has multiple arguments, then you have to put these in quotes. For
 165 example:
 166 ----
 167 # dracut --omit-drivers "kmodule1 kmodule2"  ...
 168 ----
 169 ===============================
 170
 171 **--filesystems** _<list of filesystems>_::
 172     specify a space-separated list of kernel filesystem modules to exclusively
 173     include in the generic initramfs. This parameter can be specified multiple
 174     times.
 175 +
 176 [NOTE]
 177 ===============================
 178 If [LIST] has multiple arguments, then you have to put these in quotes. For
 179 example:
 180 ----
 181 # dracut --filesystems "filesystem1 filesystem2"  ...
 182 ----
 183 ===============================
 184
 185 **-k, --kmoddir** _<kernel directory>_::
 186     specify the directory, where to look for kernel modules
 187
 188 **--fwdir** _<dir>[:<dir>...]++_::
 189     specify additional directories, where to look for firmwares. This parameter
 190     can be specified multiple times.
 191
 192 **--kernel-cmdline <parameters>**::
 193     specify default kernel command line parameters
 194
 195
 196 **--kernel-only**::
 197     only install kernel drivers and firmware files
 198
 199 **--no-kernel**::
 200     do not install kernel drivers and firmware files
 201
 202 **--early-microcode**::
 203     Combine early microcode with ramdisk
 204
 205 **--no-early-microcode**::
 206     Do not combine early microcode with ramdisk
 207
 208 **--print-cmdline**::
 209     print the kernel command line for the current disk layout
 210
 211 **--mdadmconf**::
 212     include local _/etc/mdadm.conf_
 213
 214 **--nomdadmconf**::
 215     do not include local _/etc/mdadm.conf_
 216
 217 **--lvmconf**::
 218     include local _/etc/lvm/lvm.conf_
 219
 220 **--nolvmconf**::
 221     do not include local _/etc/lvm/lvm.conf_
 222
 223 **--fscks** [LIST]::
 224     add a space-separated list of fsck tools, in addition to _dracut.conf_'s
 225     specification; the installation is opportunistic (non-existing tools are
 226     ignored)
 227 +
 228 [NOTE]
 229 ===============================
 230 If [LIST] has multiple arguments, then you have to put these in quotes. For
 231 example:
 232 ----
 233 # dracut --fscks "fsck.foo barfsck"  ...
 234 ----
 235 ===============================
 236
 237 **--nofscks**::
 238     inhibit installation of any fsck tools
 239
 240 **--strip**::
 241     strip binaries in the initramfs (default)
 242
 243 **--nostrip**::
 244     do not strip binaries in the initramfs
 245
 246 **--prelink**::
 247     prelink binaries in the initramfs (default)
 248
 249 **--noprelink**::
 250     do not prelink binaries in the initramfs
 251
 252 **--hardlink**::
 253     hardlink files in the initramfs (default)
 254
 255 **--nohardlink**::
 256     do not hardlink files in the initramfs
 257
 258 **--prefix** _<dir>_::
 259     prefix initramfs files with the specified directory
 260
 261 **--noprefix**::
 262     do not prefix initramfs files (default)
 263
 264 **-h, --help**::
 265     display help text and exit.
 266
 267 **--debug**::
 268     output debug information of the build process
 269
 270 **-v, --verbose**::
 271     increase verbosity level (default is info(4))
 272
 273 **-q, --quiet**:: decrease verbosity level (default is info(4))
 274
 275 **-c, --conf** _<dracut configuration file>_::
 276     specify configuration file to use.
 277 +
 278 Default:
 279    _/etc/dracut.conf_
 280
 281 **--confdir** _<configuration directory>_::
 282     specify configuration directory to use.
 283 +
 284 Default:
 285    _/etc/dracut.conf.d_
 286
 287 **--tmpdir** _<temporary directory>_::
 288     specify temporary directory to use.
 289 +
 290 Default:
 291    _/var/tmp_
 292
 293 **--sshkey** _<sshkey file>_:: ssh key file used with ssh-client module.
 294
 295 **--logfile** _<logfile>_:: logfile to use; overrides any setting from
 296     the configuration files.
 297 +
 298 Default:
 299     _/var/log/dracut.log_
 300
 301 **-l, --local**::
 302     activates the local mode. dracut will use modules from the current working
 303     directory instead of the system-wide installed modules in
 304     _/usr/lib/dracut/modules.d_.
 305     This is useful when running dracut from a git checkout.
 306
 307 **-H, --hostonly**::
 308     Host-Only mode: Install only what is needed for booting the local host
 309     instead of a generic host and generate host-specific configuration.
 310 +
 311 [WARNING]
 312 ====
 313 If chrooted to another root other than the real root device, use "--fstab" and
 314 provide a valid _/etc/fstab_.
 315 ====
 316
 317 **-N, --no-hostonly**::
 318     Disable Host-Only mode
 319
 320 **--hostonly-cmdline**:
 321     Store kernel command line arguments needed in the initramfs
 322
 323 **--no-hostonly-cmdline**:
 324     Do not store kernel command line arguments needed in the initramfs
 325
 326 **--hostonly-i18n**:
 327     Install only needed keyboard and font files according to the host configuration (default).
 328
 329 **--no-hostonly-i18n**:
 330     Install all keyboard and font files available.
 331
 332 **--persistent-policy** _<policy>_::
 333     Use _<policy>_ to address disks and partitions.
 334     _<policy>_ can be any directory name found in /dev/disk.
 335     E.g. "by-uuid", "by-label"
 336
 337 **--fstab**::
 338     Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
 339
 340 **--add-fstab** _<filename>_::
 341     Add entries of _<filename>_ to the initramfs /etc/fstab.
 342
 343 **--mount** "_<device>_ _<mountpoint>_ _<filesystem type>_ [_<filesystem options>_ [_<dump frequency>_ [_<fsck order>_]]]"::
 344     Mount _<device>_ on _<mountpoint>_ with _<filesystem type>_ in the
 345     initramfs. _<filesystem options>_, _<dump options>_ and _<fsck order>_ can
 346     be specified, see fstab manpage for the details.
 347     The default _<filesystem options>_ is "defaults".
 348     The default _<dump frequency>_ is "0".
 349     the default _<fsck order>_ is "2".
 350
 351 **--mount** "_<mountpoint>_"::
 352     Like above, but _<device>_, _<filesystem type>_ and _<filesystem options>_
 353     are determined by looking at the current mounts.
 354
 355 **--add-device** _<device>_ ::
 356     Bring up _<device>_ in initramfs, _<device>_ should be the device name.
 357     This can be useful in hostonly mode for resume support when your swap is on
 358     LVM or an encrypted partition.
 359     [NB --device can be used for compatibility with earlier releases]
 360
 361 **-i, --include** _<SOURCE>_ _<TARGET>_::
 362     include the files in the SOURCE directory into the
 363     TARGET directory in the final initramfs. If SOURCE is a file, it will be
 364     installed to TARGET in the final initramfs. This parameter can be specified
 365     multiple times.
 366
 367 **-I, --install** _<file list>_::
 368     install the space separated list of files into the initramfs.
 369 +
 370 [NOTE]
 371 ===============================
 372 If [LIST] has multiple arguments, then you have to put these in quotes. For
 373 example:
 374 ----
 375 # dracut --install "/bin/foo /sbin/bar"  ...
 376 ----
 377 ===============================
 378
 379 **--install-optional** _<file list>_::
 380     install the space separated list of files into the initramfs, if they exist.
 381
 382 **--gzip**::
 383     Compress the generated initramfs using gzip. This will be done by default,
 384     unless another compression option or --no-compress is passed. Equivalent to
 385     "--compress=gzip -9"
 386
 387 **--bzip2**::
 388     Compress the generated initramfs using bzip2.
 389 +
 390 [WARNING]
 391 ====
 392 Make sure your kernel has bzip2 decompression support compiled in, otherwise you
 393 will not be able to boot. Equivalent to "--compress=bzip2"
 394 ====
 395
 396 **--lzma**::
 397     Compress the generated initramfs using lzma.
 398 +
 399 [WARNING]
 400 ====
 401 Make sure your kernel has lzma decompression support compiled in, otherwise you
 402 will not be able to boot. Equivalent to "lzma --compress=lzma -9"
 403 ====
 404
 405 **--xz**::
 406     Compress the generated initramfs using xz.
 407 +
 408 [WARNING]
 409 ====
 410 Make sure your kernel has xz decompression support compiled in, otherwise you
 411 will not be able to boot. Equivalent to
 412 "lzma --compress=xz --check=crc32 --lzma2=dict=1MiB"
 413 ====
 414
 415 **--lzo**::
 416     Compress the generated initramfs using lzop.
 417 [WARNING]
 418 ====
 419 Make sure your kernel has lzo decompression support compiled in, otherwise you
 420 will not be able to boot.
 421 ====
 422
 423 **--lz4**::
 424     Compress the generated initramfs using lz4.
 425 [WARNING]
 426 ====
 427 Make sure your kernel has lz4 decompression support compiled in, otherwise you
 428 will not be able to boot.
 429 ====
 430
 431 **--compress** _<compressor>_::
 432     Compress the generated initramfs using the passed compression program. If
 433     you pass it just the name of a compression program, it will call that
 434     program with known-working arguments. If you pass a quoted string with
 435     arguments, it will be called with exactly those arguments. Depending on what
 436     you pass, this may result in an initramfs that the kernel cannot decompress.
 437
 438 **--no-compress**::
 439     Do not compress the generated initramfs. This will override any other
 440     compression options.
 441
 442 **--reproducible**::
 443     Create reproducible images.
 444
 445 **--no-reproducible**::
 446     Do not create reproducible images.
 447
 448 **--list-modules**::
 449     List all available dracut modules.
 450
 451 **-M, --show-modules**::
 452     Print included module's name to standard output during build.
 453
 454 **--keep**::
 455     Keep the initramfs temporary directory for debugging purposes.
 456
 457 **--printsize**::
 458     Print out the module install size
 459
 460 **--profile**:
 461     Output profile information of the build process
 462
 463 **--ro-mnt**:
 464     Mount / and /usr read-only by default.
 465
 466 **-L, --stdlog** _<level>_::
 467     [0-6] Specify logging level (to standard error)
 468 ----
 469           0 - suppress any messages
 470           1 - only fatal errors
 471           2 - all errors
 472           3 - warnings
 473           4 - info
 474           5 - debug info (here starts lots of output)
 475           6 - trace info (and even more)
 476 ----
 477
 478 **--regenerate-all**::
 479     Regenerate all initramfs images at the default location with the kernel
 480     versions found on the system. Additional parameters are passed through.
 481
 482 **--loginstall _<DIR>_**::
 483     Log all files installed from the host to _<DIR>_.
 484
 485 **--uefi**::
 486     Instead of creating an initramfs image, dracut will create an UEFI executable,
 487     which can be executed by an UEFI BIOS.
 488
 489 **--uefi-stub _<FILE>_**::
 490     Specifies the UEFI stub loader, which will load the attached kernel, initramfs and
 491     kernel command line and boots the kernel. The default is
 492     _/lib/systemd/boot/efi/linux<EFI-MACHINE-TYPE-NAME>.efi.stub_
 493     or _/usr/lib/gummiboot/linux<EFI-MACHINE-TYPE-NAME>.efi.stub_
 494
 495 **--kernel-image _<FILE>_**::
 496     Specifies the kernel image, which to include in the UEFI executable. The default is
 497     _/lib/modules/<KERNEL-VERSION>/vmlinuz_ or _/boot/vmlinuz-<KERNEL-VERSION>_
 498
 499 FILES
 500 -----
 501 _/var/log/dracut.log_::
 502     logfile of initramfs image creation
 503
 504 _/tmp/dracut.log_::
 505     logfile of initramfs image creation, if _/var/log/dracut.log_ is not
 506     writable
 507
 508 _/etc/dracut.conf_::
 509     see dracut.conf5
 510
 511 _/etc/dracut.conf.d/*.conf_::
 512     see dracut.conf5
 513
 514 _/usr/lib/dracut/dracut.conf.d/*.conf_::
 515     see dracut.conf5
 516
 517 Configuration in the initramfs
 518 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 519 _/etc/conf.d/_::
 520     Any files found in _/etc/conf.d/_ will be sourced in the initramfs to
 521     set initial values. Command line options will override these values
 522     set in the configuration files.
 523
 524 _/etc/cmdline_::
 525     Can contain additional command line options. Deprecated, better use
 526     /etc/cmdline.d/*.conf.
 527
 528 _/etc/cmdline.d/*.conf_::
 529     Can contain additional command line options.
 530
 531 AVAILABILITY
 532 ------------
 533 The dracut command is part of the dracut package and is available from
 534 link:$$https://dracut.wiki.kernel.org$$[https://dracut.wiki.kernel.org]
 535
 536 AUTHORS
 537 -------
 538 Harald Hoyer
 539
 540 Victor Lowther
 541
 542 Philippe Seewer
 543
 544 Warren Togami
 545
 546 Amadeusz Żołnowski
 547
 548 Jeremy Katz
 549
 550 David Dillow
 551
 552 Will Woods
 553
 554 SEE ALSO
 555 --------
 556 *dracut.cmdline*(7) *dracut.conf*(5) *lsinitrd*(1)