projects / thirdparty / dracut.git / blame
| Commit | Line | Data |
|---|---|---|
| 609d00c4 | 1 | <?xml version='1.0' encoding='UTF-8'?> |
| d350ae69 | 2 | <!-- This document was created with Syntext Serna Free. --><!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" []> |
| cdc8d9c4 HH |
3 | <refentry> |
| 4 | <refentryinfo> | |
| 5 | <title>dracut.kernel</title> | |
| 6 | <productname>dracut</productname> | |
| 7 | <authorgroup> | |
| 8 | <author> | |
| 3eccdb52 HH |
9 | <contrib>Developer</contrib> |
| 10 | <firstname>Harald</firstname> | |
| 11 | <surname>Hoyer</surname> | |
| 12 | <email>harald@redhat.com</email> | |
| cdc8d9c4 HH |
13 | </author> |
| 14 | </authorgroup> | |
| 15 | </refentryinfo> | |
| 16 | <refmeta> | |
| 17 | <refentrytitle>dracut.kernel</refentrytitle> | |
| 18 | <manvolnum>7</manvolnum> | |
| 19 | <refmiscinfo class="version"/> | |
| 20 | </refmeta> | |
| 21 | <refnamediv> | |
| 22 | <refname>dracut.kernel</refname> | |
| 23 | <refpurpose>dracut kernel command line options</refpurpose> | |
| 24 | </refnamediv> | |
| 25 | <refsect1> | |
| 26 | <title>Description</title> | |
| 27 | <para>The root filesystem used by the kernel is specified in the boot configuration | |
| 28 | file, as always. The traditional <emphasis remap="B">root=/dev/hda1</emphasis> style device | |
| 29 | specification is allowed. If a label is used, as in <emphasis remap="B">root=LABEL=rootPart</emphasis> | |
| 30 | the initramfs will search all available devices for an ext2 or ext3 filesystem | |
| 31 | with the appropriate label, and mount that device as the root filesystem. | |
| 32 | <emphasis remap="B">root=UUID=uuidnumber</emphasis> will mount the partition with that UUID as the | |
| 33 | root filesystem.</para> | |
| 34 | <refsect2> | |
| 35 | <title>Standard</title> | |
| 36 | <variablelist> | |
| 37 | <varlistentry> | |
| 38 | <term> | |
| 3eccdb52 | 39 | <envar>init=<replaceable><path to real init></replaceable></envar> |
| cdc8d9c4 HH |
40 | </term> |
| 41 | <listitem> | |
| 42 | <para> </para> | |
| 43 | </listitem> | |
| 44 | </varlistentry> | |
| 45 | <varlistentry> | |
| 46 | <term> | |
| 47 | <envar>root=<replaceable><path to blockdevice></replaceable></envar> | |
| 48 | </term> | |
| 49 | <listitem> | |
| 50 | <para>specify blockdevice to use as root filesystem. | |
| 3eccdb52 HH |
51 | e.g. |
| 52 | <programlisting> | |
| 53 | root=/dev/sda1 | |
| 54 | root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1 | |
| 55 | </programlisting></para> | |
| cdc8d9c4 HH |
56 | </listitem> |
| 57 | </varlistentry> | |
| 58 | <varlistentry> | |
| 59 | <term> | |
| 60 | <envar>rootfstype=<replaceable><filesystem type></replaceable></envar> | |
| 61 | </term> | |
| 62 | <listitem> | |
| 63 | <para>"auto" if not specified, e.g. rootfstype=ext3</para> | |
| 64 | </listitem> | |
| 65 | </varlistentry> | |
| 66 | <varlistentry> | |
| 67 | <term> | |
| 68 | <envar>rootflags=<replaceable><mount options></replaceable></envar> | |
| 69 | </term> | |
| 70 | <listitem> | |
| 71 | <para>specify additional mount options for the root filesystem. If not set, /etc/fstab | |
| 72 | of the real root will be parsed for special mount options and mounted | |
| 73 | accordingly.</para> | |
| 74 | </listitem> | |
| 75 | </varlistentry> | |
| 76 | <varlistentry> | |
| 77 | <term> | |
| 78 | <envar>rd_NO_FSTAB</envar> | |
| 79 | </term> | |
| 80 | <listitem> | |
| 81 | <para>do not honor special mount options for the root filesystem found in | |
| 82 | /etc/fstab of the real root.</para> | |
| 83 | </listitem> | |
| 84 | </varlistentry> | |
| 85 | </variablelist> | |
| 86 | </refsect2> | |
| 87 | <refsect2> | |
| 88 | <title>Misc</title> | |
| 89 | <variablelist> | |
| 90 | <varlistentry> | |
| 91 | <term> | |
| 92 | <envar>rdblacklist=<replaceable><drivername></replaceable></envar> | |
| 93 | </term> | |
| 94 | <listitem> | |
| 95 | <para>do not load kernel module <drivername> | |
| 96 | This parameter can be specified multiple times.</para> | |
| 97 | </listitem> | |
| 98 | </varlistentry> | |
| 99 | <varlistentry> | |
| 100 | <term> | |
| 101 | <envar>rdloaddriver=<replaceable><drivername></replaceable></envar> | |
| 102 | </term> | |
| 103 | <listitem> | |
| 104 | <para>force loading kernel module <drivername> | |
| 105 | This parameter can be specified multiple times.</para> | |
| 106 | </listitem> | |
| 107 | </varlistentry> | |
| 108 | </variablelist> | |
| 109 | </refsect2> | |
| 110 | <refsect2> | |
| 111 | <title>Debug</title> | |
| 112 | <variablelist> | |
| 113 | <varlistentry> | |
| 114 | <term> | |
| 115 | <envar>rdinfo</envar> | |
| 116 | </term> | |
| 117 | <listitem> | |
| 118 | <para>print informational output though "quiet" is set</para> | |
| 119 | </listitem> | |
| 120 | </varlistentry> | |
| 121 | <varlistentry> | |
| 122 | <term> | |
| 123 | <envar>rdshell</envar> | |
| 124 | </term> | |
| 125 | <listitem> | |
| 126 | <para>allow dropping to a shell, if root mounting fails</para> | |
| 127 | </listitem> | |
| 128 | </varlistentry> | |
| 129 | <varlistentry> | |
| 130 | <term> | |
| 131 | <envar>rdinitdebug</envar> | |
| 132 | </term> | |
| 133 | <listitem> | |
| 134 | <para>set -x for the dracut shell and logs to dmesg, console and /init.log</para> | |
| 135 | </listitem> | |
| 136 | </varlistentry> | |
| 137 | <varlistentry> | |
| 138 | <term> | |
| 139 | <envar>rdbreak</envar> | |
| 140 | </term> | |
| 141 | <listitem> | |
| 142 | <para>drop to a shell at the end</para> | |
| 143 | </listitem> | |
| 144 | </varlistentry> | |
| 145 | <varlistentry> | |
| 3eccdb52 | 146 | <term><envar>rdbreak=</envar>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot} </term> |
| cdc8d9c4 HH |
147 | <listitem> |
| 148 | <para>drop to a shell on defined breakpoint</para> | |
| 149 | </listitem> | |
| 150 | </varlistentry> | |
| 151 | <varlistentry> | |
| 152 | <term> | |
| 153 | <envar>rdudevinfo</envar> | |
| 154 | </term> | |
| 155 | <listitem> | |
| 156 | <para>set udev to loglevel info</para> | |
| 157 | </listitem> | |
| 158 | </varlistentry> | |
| 159 | <varlistentry> | |
| 160 | <term> | |
| 161 | <envar>rdudevdebug</envar> | |
| 162 | </term> | |
| 163 | <listitem> | |
| 164 | <para>set udev to loglevel debug</para> | |
| 165 | </listitem> | |
| 166 | </varlistentry> | |
| 167 | </variablelist> | |
| 168 | </refsect2> | |
| 169 | <refsect2> | |
| 170 | <title>I18N</title> | |
| cdc8d9c4 HH |
171 | <variablelist> |
| 172 | <varlistentry> | |
| 173 | <term> | |
| 9b3d462b AŻ |
174 | <envar>KEYMAP=</envar> |
| 175 | <replaceable><keymap base file name></replaceable> | |
| cdc8d9c4 HH |
176 | </term> |
| 177 | <listitem> | |
| 9b3d462b | 178 | <para>keyboard translation table loaded by loadkeys; taken from keymaps directory; will be written to /etc/sysconfig/keyboard in the initramfs, e.g.: <programlisting>KEYMAP=de-latin1-nodeadkeys</programlisting></para> |
| cdc8d9c4 HH |
179 | </listitem> |
| 180 | </varlistentry> | |
| 181 | <varlistentry> | |
| 182 | <term> | |
| 9b3d462b AŻ |
183 | <envar>EXT_KEYMAPS=</envar> |
| 184 | <replaceable><list of keymap base file names></replaceable> | |
| cdc8d9c4 HH |
185 | </term> |
| 186 | <listitem> | |
| 9b3d462b | 187 | <para>list of extra keymaps to bo loaded (sep. by space); will be written to /etc/sysconfig/keyboard in the initramfs</para> |
| cdc8d9c4 HH |
188 | </listitem> |
| 189 | </varlistentry> | |
| 190 | <varlistentry> | |
| 3eccdb52 | 191 | <term> |
| 9b3d462b AŻ |
192 | <envar>UNICODE=</envar> |
| 193 | <replaceable><1|0></replaceable> | |
| 3eccdb52 | 194 | </term> |
| cdc8d9c4 | 195 | <listitem> |
| 9b3d462b | 196 | <para>boolean, indicating UTF-8 mode; will be written to /etc/sysconfig/i18n in the initramfs</para> |
| cdc8d9c4 HH |
197 | </listitem> |
| 198 | </varlistentry> | |
| 199 | <varlistentry> | |
| 3eccdb52 | 200 | <term> |
| 9b3d462b AŻ |
201 | <envar>SYSFONT=</envar> |
| 202 | <replaceable><font base file name></replaceable> | |
| 3eccdb52 | 203 | </term> |
| cdc8d9c4 | 204 | <listitem> |
| 9b3d462b | 205 | <para>console font; taken from consolefonts directory; will be written to /etc/sysconfig/i18n in the initramfs; e.g.: <programlisting>SYSFONT=LatArCyrHeb-16</programlisting></para> |
| cdc8d9c4 HH |
206 | </listitem> |
| 207 | </varlistentry> | |
| 208 | <varlistentry> | |
| 209 | <term> | |
| 9b3d462b AŻ |
210 | <envar>CONTRANS=</envar> |
| 211 | <replaceable><console map base file name></replaceable> | |
| cdc8d9c4 HH |
212 | </term> |
| 213 | <listitem> | |
| c865ecbf | 214 | <para>see description of '-m' parameter in setfont manual; taken from consoletrans directory; will be written to /etc/sysconfig/i18n in the initramfs</para> |
| cdc8d9c4 HH |
215 | </listitem> |
| 216 | </varlistentry> | |
| 217 | <varlistentry> | |
| 218 | <term> | |
| 9b3d462b AŻ |
219 | <envar>UNIMAP=</envar> |
| 220 | <replaceable><unicode table base file name></replaceable> | |
| cdc8d9c4 HH |
221 | </term> |
| 222 | <listitem> | |
| c865ecbf | 223 | <para>see description of '-u' parameter in setfont manual; taken from unimaps directory; will be written to /etc/sysconfig/i18n in the initramfs</para> |
| 9b3d462b AŻ |
224 | </listitem> |
| 225 | </varlistentry> | |
| 226 | <varlistentry> | |
| 227 | <term> | |
| 228 | <envar>LANG=</envar> | |
| 229 | <replaceable><locale></replaceable> | |
| 230 | </term> | |
| 231 | <listitem> | |
| c865ecbf | 232 | <para>taken from the environment; if no UNICODE is defined we set its value in basis of LANG value (whether it ends with ".utf8" (or similar) or not); will be written to /etc/sysconfig/i18n in the initramfs; e.g.: <programlisting>LANG=pl_PL.utf8</programlisting></para> |
| 9b3d462b AŻ |
233 | </listitem> |
| 234 | </varlistentry> | |
| 235 | <varlistentry> | |
| 236 | <term> | |
| 237 | <envar>LC_ALL=</envar> | |
| 238 | <replaceable><locale></replaceable> | |
| 239 | </term> | |
| 240 | <listitem> | |
| 241 | <para>taken from the environment; will be written to /etc/sysconfig/i18n in the initramfs</para> | |
| cdc8d9c4 HH |
242 | </listitem> |
| 243 | </varlistentry> | |
| 244 | </variablelist> | |
| 245 | </refsect2> | |
| 246 | <refsect2> | |
| 247 | <title>LVM</title> | |
| 248 | <variablelist> | |
| 249 | <varlistentry> | |
| 250 | <term> | |
| 251 | <envar>rd_NO_LVM</envar> | |
| 252 | </term> | |
| 253 | <listitem> | |
| 254 | <para>disable LVM detection</para> | |
| 255 | </listitem> | |
| 256 | </varlistentry> | |
| 257 | <varlistentry> | |
| 258 | <term> | |
| 259 | <envar>rd_LVM_VG=<replaceable><volume group name></replaceable></envar> | |
| 260 | </term> | |
| 261 | <listitem> | |
| 262 | <para>only activate the volume groups with the given name | |
| 263 | rd_LVM_VG can be specified multiple times on the kernel command line.</para> | |
| 264 | </listitem> | |
| 265 | </varlistentry> | |
| 266 | <varlistentry> | |
| 267 | <term> | |
| 268 | <envar>rd_LVM_LV=<replaceable><logical volume name></replaceable></envar> | |
| 269 | </term> | |
| 270 | <listitem> | |
| 271 | <para>only activate the logical volumes with the given name | |
| 272 | rd_LVM_LV can be specified multiple times on the kernel command line.</para> | |
| 273 | </listitem> | |
| 274 | </varlistentry> | |
| 275 | <varlistentry> | |
| 276 | <term> | |
| 277 | <envar>rd_NO_LVMCONF</envar> | |
| 278 | </term> | |
| 279 | <listitem> | |
| 280 | <para>remove any /etc/lvm/lvm.conf, which may exist in the initramfs</para> | |
| 281 | </listitem> | |
| 282 | </varlistentry> | |
| 283 | </variablelist> | |
| 284 | </refsect2> | |
| 285 | <refsect2> | |
| 286 | <title>crypto LUKS</title> | |
| 287 | <variablelist> | |
| 288 | <varlistentry> | |
| 289 | <term> | |
| 290 | <envar>rd_NO_LUKS</envar> | |
| 291 | </term> | |
| 292 | <listitem> | |
| 293 | <para>disable crypto LUKS detection</para> | |
| 294 | </listitem> | |
| 295 | </varlistentry> | |
| 296 | <varlistentry> | |
| 297 | <term> | |
| 298 | <envar>rd_LUKS_UUID=<replaceable><luks uuid></replaceable></envar> | |
| 299 | </term> | |
| 300 | <listitem> | |
| 301 | <para>only activate the LUKS partitions with the given UUID | |
| 302 | Any "luks-" of the LUKS UUID is removed before comparing to <luks uuid>. | |
| 303 | The comparisons also matches, if <luks uuid> is only the beginning of the | |
| 304 | LUKS UUID, so you don't have to specify the full UUID. | |
| 305 | This parameter can be specified multiple times.</para> | |
| 306 | </listitem> | |
| 307 | </varlistentry> | |
| 308 | <varlistentry> | |
| 309 | <term> | |
| 310 | <envar>rd_NO_CRYPTTAB</envar> | |
| 311 | </term> | |
| 312 | <listitem> | |
| 313 | <para>do not check, if LUKS partition is in /etc/crypttab</para> | |
| 314 | </listitem> | |
| 315 | </varlistentry> | |
| 316 | </variablelist> | |
| 317 | </refsect2> | |
| 9b3d462b AŻ |
318 | <refsect2> |
| 319 | <title>crypt LUKS - experimental removable keys support</title> | |
| 320 | <para>works only when plymouth module is not included</para> | |
| 321 | <variablelist> | |
| 322 | <varlistentry> | |
| 323 | <term> | |
| 324 | <envar>rd_LUKS_KEYPATH=</envar> | |
| 325 | <replaceable><path to keyfile></replaceable> | |
| 326 | </term> | |
| 327 | <listitem> | |
| 328 | <para>path to keyfile inside remove device filesystem</para> | |
| 329 | </listitem> | |
| 330 | </varlistentry> | |
| 331 | <varlistentry> | |
| 332 | <term> | |
| 333 | <envar>rd_LUKS_KEYDEV_UUID=</envar> | |
| 334 | <replaceable><rem. device uuid></replaceable> | |
| 335 | </term> | |
| 336 | <listitem> | |
| c865ecbf | 337 | <para>UUID of removalbe device storing keyfile; UUID doesn't have to be exact just like for rd_LUKS_UUID</para> |
| 9b3d462b AŻ |
338 | </listitem> |
| 339 | </varlistentry> | |
| 340 | </variablelist> | |
| 341 | </refsect2> | |
| cdc8d9c4 HH |
342 | <refsect2> |
| 343 | <title>MD</title> | |
| 344 | <variablelist> | |
| 345 | <varlistentry> | |
| 346 | <term> | |
| 347 | <envar>rd_NO_MD</envar> | |
| 348 | </term> | |
| 349 | <listitem> | |
| 350 | <para>disable MD RAID detection</para> | |
| 351 | </listitem> | |
| 352 | </varlistentry> | |
| 353 | <varlistentry> | |
| 354 | <term> | |
| 355 | <envar>rd_NO_MDIMSM</envar> | |
| 356 | </term> | |
| 357 | <listitem> | |
| 358 | <para>no MD RAID for imsm/isw raids, use dmraid instead</para> | |
| 359 | </listitem> | |
| 360 | </varlistentry> | |
| 361 | <varlistentry> | |
| 362 | <term> | |
| 363 | <envar>rd_NO_MDADMCONF</envar> | |
| 364 | </term> | |
| 365 | <listitem> | |
| 366 | <para>ignore mdadm.conf included in initramfs</para> | |
| 367 | </listitem> | |
| 368 | </varlistentry> | |
| 369 | <varlistentry> | |
| 370 | <term> | |
| 371 | <envar>rd_MD_UUID=<replaceable><md uuid></replaceable></envar> | |
| 372 | </term> | |
| 373 | <listitem> | |
| 374 | <para>only activate the raid sets with the given UUID. | |
| 375 | This parameter can be specified multiple times.</para> | |
| 376 | </listitem> | |
| 377 | </varlistentry> | |
| 378 | </variablelist> | |
| 379 | </refsect2> | |
| 380 | <refsect2> | |
| 381 | <title>DMRAID</title> | |
| 382 | <variablelist> | |
| 383 | <varlistentry> | |
| 384 | <term> | |
| 385 | <envar>rd_NO_DM</envar> | |
| 386 | </term> | |
| 387 | <listitem> | |
| 388 | <para>disable DM RAID detection</para> | |
| 389 | </listitem> | |
| 390 | </varlistentry> | |
| 391 | <varlistentry> | |
| 392 | <term> | |
| 393 | <envar>rd_DM_UUID=<replaceable><dmraid uuid></replaceable></envar> | |
| 394 | </term> | |
| 395 | <listitem> | |
| 396 | <para>only activate the raid sets with the given UUID. | |
| 397 | This parameter can be specified multiple times.</para> | |
| 398 | </listitem> | |
| 399 | </varlistentry> | |
| 400 | </variablelist> | |
| 401 | </refsect2> | |
| 402 | <refsect2> | |
| 403 | <title>Network</title> | |
| 404 | <variablelist> | |
| 405 | <varlistentry> | |
| 3eccdb52 HH |
406 | <term> |
| 407 | <envar>ip=</envar> | |
| 408 | <replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable> | |
| 409 | </term> | |
| cdc8d9c4 HH |
410 | <listitem> |
| 411 | <para>dhcp|on|any: get ip from dhcp server from all interfaces. If root=dhcp, | |
| 412 | loop sequentially through all interfaces (eth0, eth1, ...) and use the first | |
| 413 | with a valid DHCP root-path.</para> | |
| 414 | <para>auto6: do IPv6 autoconfiguration</para> | |
| 415 | </listitem> | |
| 416 | </varlistentry> | |
| 417 | <varlistentry> | |
| 3eccdb52 | 418 | <term><envar>ip=</envar><replaceable><interface></replaceable>:<replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable></term> |
| cdc8d9c4 HH |
419 | <listitem> |
| 420 | <para>dhcp|on|any|dhcp6: get ip from dhcp server on a specific interface | |
| 421 | auto6: do IPv6 autoconfiguration | |
| 422 | This parameter can be specified multiple times.</para> | |
| 423 | </listitem> | |
| 424 | </varlistentry> | |
| 425 | <varlistentry> | |
| 426 | <term><envar>ip=</envar><replaceable><client-IP></replaceable>:<optional> | |
| 427 | <replaceable><server-id></replaceable> | |
| 3eccdb52 | 428 | </optional>:<replaceable><gateway-IP></replaceable>:<replaceable><netmask></replaceable>:<replaceable><client_hostname></replaceable>:<replaceable><interface></replaceable>:<replaceable>{none|off}</replaceable></term> |
| cdc8d9c4 HH |
429 | <listitem> |
| 430 | <para>explicit network configuration. If you want do define a IPv6 address, put it in brackets (e.g. [2001:DB8::1]). | |
| 431 | This parameter can be specified multiple times.</para> | |
| 432 | </listitem> | |
| 433 | </varlistentry> | |
| 434 | <varlistentry> | |
| 3eccdb52 | 435 | <term><envar>ifname=</envar><replaceable><interface></replaceable>:<replaceable><MAC></replaceable></term> |
| cdc8d9c4 HH |
436 | <listitem> |
| 437 | <para>Assign network device name <interface> (ie eth0) to the NIC with MAC <MAC>. | |
| 438 | Note letters in the MAC-address must be lowercase! | |
| 439 | Note that if you use this option you <emphasis remap="B">must</emphasis> specify an ifname= argument | |
| 440 | for all interfaces used in ip= or fcoe= arguments | |
| 441 | This parameter can be specified multiple times.</para> | |
| 442 | </listitem> | |
| 443 | </varlistentry> | |
| 444 | <varlistentry> | |
| 3eccdb52 HH |
445 | <term> |
| 446 | <envar>bootdev=</envar> | |
| 447 | <replaceable><interface></replaceable> | |
| 448 | </term> | |
| cdc8d9c4 HH |
449 | <listitem> |
| 450 | <para>specify network interface to use routing and netroot information from. | |
| 451 | Required if multiple ip= lines are used.</para> | |
| 452 | </listitem> | |
| 453 | </varlistentry> | |
| 454 | <varlistentry> | |
| 3eccdb52 HH |
455 | <term> |
| 456 | <envar>nameserver=</envar> | |
| 457 | <replaceable><IP></replaceable> | |
| 458 | <optional><envar>nameserver</envar>=<replaceable><IP></replaceable> ...</optional> | |
| 459 | </term> | |
| cdc8d9c4 HH |
460 | <listitem> |
| 461 | <para>specify nameserver(s) to use</para> | |
| 462 | </listitem> | |
| 463 | </varlistentry> | |
| 464 | </variablelist> | |
| 465 | </refsect2> | |
| 466 | <refsect2> | |
| 467 | <title>NFS</title> | |
| 468 | <variablelist> | |
| 469 | <varlistentry> | |
| 3eccdb52 HH |
470 | <term> |
| 471 | <envar>root=</envar> | |
| 472 | <optional><replaceable><server-ip></replaceable>:</optional> | |
| 473 | <replaceable><root-dir></replaceable> | |
| 474 | <optional>:<replaceable><nfs-options></replaceable></optional> | |
| 475 | </term> | |
| cdc8d9c4 HH |
476 | <listitem> |
| 477 | <para>mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given, | |
| 478 | use dhcp next_server. if server-ip is an IPv6 address it has to be put in brackets, e.g. [2001:DB8::1]. | |
| 479 | NFS options can be appended with the prefix ":" or "," and are seperated by ",".</para> | |
| 480 | </listitem> | |
| 481 | </varlistentry> | |
| 482 | <varlistentry> | |
| 3eccdb52 HH |
483 | <term><envar>root=</envar>nfs:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term> |
| 484 | <term><envar>root=</envar>nfs4:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term> | |
| 485 | <term> | |
| 486 | <envar>root=</envar> | |
| 487 | <replaceable>{dhcp|dhcp6}</replaceable> | |
| 488 | </term> | |
| cdc8d9c4 HH |
489 | <listitem> |
| 490 | <para>root=dhcp alone directs initrd to look at the DHCP root-path where NFS | |
| 491 | options can be specified. | |
| 492 | root-path=<server-ip>:<root-dir>[,<nfs-options>] | |
| 493 | root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>] | |
| 494 | root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]</para> | |
| 495 | </listitem> | |
| 496 | </varlistentry> | |
| 497 | <varlistentry> | |
| 3eccdb52 HH |
498 | <term> |
| 499 | <envar>root=</envar> | |
| 500 | <filename>/dev/nfs</filename> | |
| 501 | <envar> nfsroot=</envar> | |
| 502 | <optional><replaceable><server-ip></replaceable>:</optional> | |
| 503 | <replaceable><root-dir></replaceable> | |
| 504 | <optional>:<replaceable><nfs-options></replaceable></optional> | |
| 505 | </term> | |
| cdc8d9c4 HH |
506 | <listitem> |
| 507 | <para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation/filesystems/nfsroot.txt defines | |
| 508 | this method. | |
| 509 | This is supported by dracut but not recommended.</para> | |
| 510 | </listitem> | |
| 511 | </varlistentry> | |
| 512 | <varlistentry> | |
| 3eccdb52 HH |
513 | <term> |
| 514 | <envar remap="B">rd_NFS_DOMAIN=</envar> | |
| 515 | <replaceable><NFSv4 domain name></replaceable> | |
| 516 | </term> | |
| cdc8d9c4 HH |
517 | <listitem> |
| 518 | <para>Set the NFSv4 domain name. Will overwrite the settings in /etc/idmap.conf.</para> | |
| 519 | </listitem> | |
| 520 | </varlistentry> | |
| 521 | </variablelist> | |
| 522 | </refsect2> | |
| 523 | <refsect2> | |
| 524 | <title>iSCSI</title> | |
| 525 | <variablelist> | |
| 526 | <varlistentry> | |
| 3eccdb52 HH |
527 | <term><envar>root=</envar>iscsi:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional> |
| 528 | <replaceable><servername></replaceable> | |
| 529 | </optional>:<optional> | |
| 530 | <replaceable><protocol></replaceable> | |
| 531 | </optional>:<optional> | |
| 532 | <replaceable><port></replaceable> | |
| 533 | </optional>:<optional> | |
| 534 | <replaceable><LUN></replaceable> | |
| 535 | </optional>:<replaceable><targetname></replaceable></term> | |
| cdc8d9c4 HH |
536 | <listitem> |
| 537 | <para>protocol defaults to "6", LUN defaults to "0".</para> | |
| 538 | <para>If the "servername" field is provided by BOOTP or DHCP, then that | |
| 539 | field is used in conjunction with other associated fields to contact | |
| 540 | the boot server in the Boot stage (Section 7). However, if the | |
| 541 | "servername" field is not provided, then the "targetname" field is | |
| 542 | then used in the Discovery Service stage in conjunction with other | |
| 543 | associated fields.</para> | |
| 544 | <para><ulink url="http://tools.ietf.org/html/rfc4173">http://tools.ietf.org/html/rfc4173</ulink></para> | |
| 3eccdb52 HH |
545 | <para>e.g. |
| 546 | <programlisting> | |
| 547 | root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 | |
| 548 | </programlisting> | |
| 549 | </para> | |
| 550 | <para>If servername is an IPv6 address, it has to be put in brackets. e.g. | |
| 551 | <programlisting> | |
| 552 | root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0 | |
| 553 | </programlisting></para> | |
| 554 | </listitem> | |
| 555 | </varlistentry> | |
| 556 | <varlistentry> | |
| 557 | <term><envar>root=</envar><replaceable>???</replaceable><envar> netroot=</envar>iscsi:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional> | |
| 558 | <replaceable><servername></replaceable> | |
| 559 | </optional>:<optional> | |
| 560 | <replaceable><protocol></replaceable> | |
| 561 | </optional>:<optional> | |
| 562 | <replaceable><port></replaceable> | |
| 563 | </optional>:<optional> | |
| 564 | <replaceable><LUN></replaceable> | |
| 565 | </optional>:<replaceable><targetname></replaceable> ...</term> | |
| 566 | <listitem> | |
| 567 | <para>multiple netroot options allow setting up multiple iscsi disks. e.g. | |
| 568 | <programlisting> | |
| 569 | root=UUID=12424547 | |
| 570 | netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 | |
| 571 | netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1 | |
| 572 | </programlisting></para> | |
| cdc8d9c4 HH |
573 | <para>If servername is an IPv6 address, it has to be put in brackets. |
| 574 | e.g. | |
| 3eccdb52 | 575 | <programlisting>netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</programlisting></para> |
| cdc8d9c4 HH |
576 | </listitem> |
| 577 | </varlistentry> | |
| 578 | <varlistentry> | |
| 3eccdb52 HH |
579 | <term> |
| 580 | <envar>root=<replaceable>???</replaceable></envar> | |
| 581 | <envar> iscsi_initiator=<replaceable><initiator> </replaceable></envar> | |
| 582 | <envar>iscsi_target_name=<replaceable><target_name> </replaceable></envar> | |
| 583 | <envar>iscsi_target_ip=<replaceable><target ip> </replaceable></envar> | |
| 584 | <envar>iscsi_target_port=<replaceable><target port> </replaceable></envar> | |
| 585 | <envar>iscsi_target_group=<replaceable><target group> </replaceable></envar> | |
| 586 | <envar>iscsi_username=<replaceable><username> </replaceable></envar> | |
| 587 | <envar>iscsi_password=<replaceable><password> </replaceable></envar> | |
| 588 | <envar>iscsi_in_username=<replaceable><in username> </replaceable></envar> | |
| 589 | <envar>iscsi_in_password=<replaceable><in password> </replaceable></envar> | |
| 590 | </term> | |
| cdc8d9c4 HH |
591 | <listitem> |
| 592 | <para>manually specify all iscsistart parameter (see <userinput>iscsistart --help</userinput>)</para> | |
| 593 | </listitem> | |
| 594 | </varlistentry> | |
| 595 | <varlistentry> | |
| 596 | <term><envar>root=</envar>???<envar> iscsi_firmware</envar></term> | |
| 597 | <listitem> | |
| 598 | <para>will read the iscsi parameter from the BIOS firmware</para> | |
| 599 | </listitem> | |
| 600 | </varlistentry> | |
| 601 | </variablelist> | |
| 602 | </refsect2> | |
| 603 | <refsect2> | |
| 604 | <title>FCoE</title> | |
| 605 | <variablelist> | |
| 606 | <varlistentry> | |
| 3eccdb52 | 607 | <term><envar>netroot=</envar>fcoe:<replaceable><interface|MAC></replaceable>:<replaceable>{dcb|nodcb}</replaceable></term> |
| cdc8d9c4 HH |
608 | <listitem> |
| 609 | <para>Try to connect to a FCoE SAN through the NIC specified by <interface> or <MAC>, | |
| 610 | for the second argument, currently only nodcb is supported. Note letters in | |
| 611 | the MAC-address must be lowercase!</para> | |
| 612 | </listitem> | |
| 613 | </varlistentry> | |
| 614 | </variablelist> | |
| 615 | </refsect2> | |
| 616 | <refsect2> | |
| 617 | <title>NBD</title> | |
| 618 | <variablelist> | |
| 619 | <varlistentry> | |
| 3eccdb52 | 620 | <term><envar>root=</envar><constant>nbd</constant>:<replaceable><server></replaceable>:<replaceable><port></replaceable><optional>:<replaceable><fstype></replaceable></optional><optional>:<replaceable><mountopts></replaceable></optional></term> |
| cdc8d9c4 HH |
621 | <listitem> |
| 622 | <para>mount nbd share from <server></para> | |
| 623 | </listitem> | |
| 624 | </varlistentry> | |
| 625 | <varlistentry> | |
| 3eccdb52 HH |
626 | <term> |
| 627 | <envar>root=dhcp</envar> | |
| 628 | </term> | |
| cdc8d9c4 HH |
629 | <listitem> |
| 630 | <para>with dhcp root-path=nbd:<server>:<port>[:<fstype>][:<mountopts>] | |
| 631 | root=dhcp alone directs initrd to look at the DHCP root-path where NBD | |
| 632 | options can be specified. | |
| 633 | This syntax is only usable in cases where you are directly mounting the volume | |
| 634 | as the rootfs.</para> | |
| 635 | </listitem> | |
| 636 | </varlistentry> | |
| 637 | </variablelist> | |
| 638 | </refsect2> | |
| 639 | <refsect2> | |
| 640 | <title>DASD</title> | |
| 641 | <variablelist> | |
| 642 | <varlistentry> | |
| 643 | <term><envar>rd_DASD_MOD=</envar>....</term> | |
| 644 | <listitem> | |
| 645 | <para>same syntax as the kernel module parameter (s390 only)</para> | |
| 646 | </listitem> | |
| 647 | </varlistentry> | |
| 648 | <varlistentry> | |
| 3eccdb52 HH |
649 | <term> |
| 650 | <envar>rd_DASD=</envar> | |
| 651 | <replaceable><dasd_adaptor device bus ID></replaceable> | |
| 652 | <optional>,readonly=<replaceable>X</replaceable></optional> | |
| 653 | <optional>,use_diag=<replaceable>X</replaceable></optional> | |
| 654 | <optional>,erplog=<replaceable>X</replaceable></optional> | |
| 655 | </term> | |
| cdc8d9c4 HH |
656 | <listitem> |
| 657 | <para>activate DASD device with the given adaptor device bus ID and setting the sysfs attributes | |
| 658 | to the specified values | |
| 659 | This parameter can be specified multiple times.</para> | |
| 660 | </listitem> | |
| 661 | </varlistentry> | |
| 662 | </variablelist> | |
| 663 | </refsect2> | |
| 664 | <refsect2> | |
| 665 | <title>ZFCP</title> | |
| 666 | <variablelist> | |
| 667 | <varlistentry> | |
| 3eccdb52 | 668 | <term><envar>rd_ZFCP=</envar><replaceable><zfcp adaptor device bus ID></replaceable>,<replaceable><WWPN></replaceable>,<replaceable><FCPLUN></replaceable></term> |
| cdc8d9c4 HH |
669 | <listitem> |
| 670 | <para>rd_ZFCP can be specified multiple times on the kernel command line.</para> | |
| 671 | <para>example: rd_ZFCP=0.0.4000,0x5005076300C213e9,0x5022000000000000</para> | |
| 672 | </listitem> | |
| 673 | </varlistentry> | |
| 674 | <varlistentry> | |
| 675 | <term> | |
| 676 | <envar>rd_NO_ZFCPCONF</envar> | |
| 677 | </term> | |
| 678 | <listitem> | |
| 679 | <para>ignore zfcp.conf included in the initramfs</para> | |
| 680 | </listitem> | |
| 681 | </varlistentry> | |
| 682 | </variablelist> | |
| 683 | </refsect2> | |
| 684 | <refsect2> | |
| 685 | <title>ZNET</title> | |
| 686 | <variablelist> | |
| 687 | <varlistentry> | |
| 3eccdb52 | 688 | <term><envar>rd_ZNET=</envar><replaceable><nettype></replaceable>,<replaceable><subchannels></replaceable>,<replaceable><options></replaceable></term> |
| cdc8d9c4 HH |
689 | <listitem> |
| 690 | <para>rd_ZNET can be specified multiple times on the kernel command line. Examples: | |
| 691 | rd_ZNET=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo | |
| 692 | rd_ZNET=ctc,0.0.0600,0.0.0601,0.0.0602,protocol=bar</para> | |
| 693 | </listitem> | |
| 694 | </varlistentry> | |
| 695 | </variablelist> | |
| 696 | </refsect2> | |
| 697 | <refsect2> | |
| 698 | <title>Plymouth Boot Splash</title> | |
| 699 | <variablelist> | |
| 700 | <varlistentry> | |
| 701 | <term> | |
| 702 | <envar>rd_NO_PLYMOUTH</envar> | |
| 703 | </term> | |
| 704 | <listitem> | |
| 705 | <para>do not start plymouth. This will not work with encrypted partitions.</para> | |
| 706 | </listitem> | |
| 707 | </varlistentry> | |
| 708 | </variablelist> | |
| 709 | </refsect2> | |
| 710 | </refsect1> | |
| 711 | <refsect1> | |
| c865ecbf | 712 | <title>Files</title> |
| cdc8d9c4 HH |
713 | <variablelist> |
| 714 | <varlistentry> | |
| 715 | <term> | |
| 716 | <filename>/var/log/dracut.log</filename> | |
| 717 | </term> | |
| 718 | <listitem> | |
| 719 | <para>logfile of initramfs image creation</para> | |
| 720 | </listitem> | |
| 721 | </varlistentry> | |
| 722 | <varlistentry> | |
| 723 | <term> | |
| 724 | <filename>/tmp/dracut.log</filename> | |
| 725 | </term> | |
| 726 | <listitem> | |
| 727 | <para>logfile of initramfs image creation, if /var/log/dracut.log is not writable</para> | |
| 728 | </listitem> | |
| 729 | </varlistentry> | |
| 730 | <varlistentry> | |
| 731 | <term> | |
| 732 | <filename>/etc/dracut.conf</filename> | |
| 733 | </term> | |
| 734 | <listitem> | |
| 735 | <para>see <citerefentry> | |
| 736 | <refentrytitle>dracut.conf</refentrytitle> | |
| 737 | <manvolnum>5</manvolnum> | |
| 738 | </citerefentry></para> | |
| 739 | </listitem> | |
| 740 | </varlistentry> | |
| 741 | <varlistentry> | |
| 742 | <term> | |
| 743 | <filename>/etc/dracut.conf.d/*.conf</filename> | |
| 744 | </term> | |
| 745 | <listitem> | |
| 746 | <para>see <citerefentry> | |
| 747 | <refentrytitle>dracut.conf</refentrytitle> | |
| 748 | <manvolnum>5</manvolnum> | |
| 749 | </citerefentry></para> | |
| 750 | </listitem> | |
| 751 | </varlistentry> | |
| 752 | </variablelist> | |
| 753 | <refsect2> | |
| 754 | <title>Configuration in the Initramfs</title> | |
| 755 | <variablelist> | |
| 756 | <varlistentry> | |
| 757 | <term> | |
| 758 | <filename>/conf/conf.d/</filename> | |
| 759 | </term> | |
| 760 | <listitem> | |
| 761 | <para>Any files found in /conf/conf.d/ will be sourced in the initramfs to | |
| 762 | set initial values. Command line options will override these values | |
| 763 | set in the configuration files.</para> | |
| 764 | </listitem> | |
| 765 | </varlistentry> | |
| 766 | <varlistentry> | |
| 767 | <term> | |
| 768 | <filename>/etc/cmdline</filename> | |
| 769 | </term> | |
| 770 | <listitem> | |
| 771 | <para>Can contain additional command line options.</para> | |
| 772 | </listitem> | |
| 773 | </varlistentry> | |
| 774 | </variablelist> | |
| 775 | </refsect2> | |
| 776 | </refsect1> | |
| 777 | <refsect1> | |
| 778 | <title>See Also</title> | |
| 779 | <para> | |
| 780 | <citerefentry> | |
| 781 | <refentrytitle>dracut</refentrytitle> | |
| 782 | <manvolnum>8</manvolnum> | |
| 783 | </citerefentry> | |
| 784 | <citerefentry> | |
| 785 | <refentrytitle>dracut.conf</refentrytitle> | |
| 786 | <manvolnum>5</manvolnum> | |
| 787 | </citerefentry> | |
| 788 | </para> | |
| 789 | </refsect1> | |
| 790 | </refentry> |