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.
790 lines
30 KiB
790 lines
30 KiB
<?xml version='1.0' encoding='UTF-8'?> |
|
<!-- 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" []> |
|
<refentry> |
|
<refentryinfo> |
|
<title>dracut.kernel</title> |
|
<productname>dracut</productname> |
|
<authorgroup> |
|
<author> |
|
<contrib>Developer</contrib> |
|
<firstname>Harald</firstname> |
|
<surname>Hoyer</surname> |
|
<email>harald@redhat.com</email> |
|
</author> |
|
</authorgroup> |
|
</refentryinfo> |
|
<refmeta> |
|
<refentrytitle>dracut.kernel</refentrytitle> |
|
<manvolnum>7</manvolnum> |
|
<refmiscinfo class="version"/> |
|
</refmeta> |
|
<refnamediv> |
|
<refname>dracut.kernel</refname> |
|
<refpurpose>dracut kernel command line options</refpurpose> |
|
</refnamediv> |
|
<refsect1> |
|
<title>Description</title> |
|
<para>The root filesystem used by the kernel is specified in the boot configuration |
|
file, as always. The traditional <emphasis remap="B">root=/dev/hda1</emphasis> style device |
|
specification is allowed. If a label is used, as in <emphasis remap="B">root=LABEL=rootPart</emphasis> |
|
the initramfs will search all available devices for an ext2 or ext3 filesystem |
|
with the appropriate label, and mount that device as the root filesystem. |
|
<emphasis remap="B">root=UUID=uuidnumber</emphasis> will mount the partition with that UUID as the |
|
root filesystem.</para> |
|
<refsect2> |
|
<title>Standard</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>init=<replaceable><path to real init></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para> </para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>root=<replaceable><path to blockdevice></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>specify blockdevice to use as root filesystem. |
|
e.g. |
|
<programlisting> |
|
root=/dev/sda1 |
|
root=/dev/disk/by-path/pci-0000:00:1f.1-scsi-0:0:1:0-part1 |
|
</programlisting></para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rootfstype=<replaceable><filesystem type></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>"auto" if not specified, e.g. rootfstype=ext3</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rootflags=<replaceable><mount options></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>specify additional mount options for the root filesystem. If not set, /etc/fstab |
|
of the real root will be parsed for special mount options and mounted |
|
accordingly.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_FSTAB</envar> |
|
</term> |
|
<listitem> |
|
<para>do not honor special mount options for the root filesystem found in |
|
/etc/fstab of the real root.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>Misc</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rdblacklist=<replaceable><drivername></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>do not load kernel module <drivername> |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rdloaddriver=<replaceable><drivername></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>force loading kernel module <drivername> |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>Debug</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rdinfo</envar> |
|
</term> |
|
<listitem> |
|
<para>print informational output though "quiet" is set</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rdshell</envar> |
|
</term> |
|
<listitem> |
|
<para>allow dropping to a shell, if root mounting fails</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rdinitdebug</envar> |
|
</term> |
|
<listitem> |
|
<para>set -x for the dracut shell and logs to dmesg, console and /init.log</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rdbreak</envar> |
|
</term> |
|
<listitem> |
|
<para>drop to a shell at the end</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term><envar>rdbreak=</envar>{cmdline|pre-udev|pre-trigger|initqueue|pre-mount|mount|pre-pivot} </term> |
|
<listitem> |
|
<para>drop to a shell on defined breakpoint</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rdudevinfo</envar> |
|
</term> |
|
<listitem> |
|
<para>set udev to loglevel info</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rdudevdebug</envar> |
|
</term> |
|
<listitem> |
|
<para>set udev to loglevel debug</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>I18N</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>KEYMAP=</envar> |
|
<replaceable><keymap base file name></replaceable> |
|
</term> |
|
<listitem> |
|
<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> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>EXT_KEYMAPS=</envar> |
|
<replaceable><list of keymap base file names></replaceable> |
|
</term> |
|
<listitem> |
|
<para>list of extra keymaps to bo loaded (sep. by space); will be written to /etc/sysconfig/keyboard in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>UNICODE=</envar> |
|
<replaceable><1|0></replaceable> |
|
</term> |
|
<listitem> |
|
<para>boolean, indicating UTF-8 mode; will be written to /etc/sysconfig/i18n in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>SYSFONT=</envar> |
|
<replaceable><font base file name></replaceable> |
|
</term> |
|
<listitem> |
|
<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> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>CONTRANS=</envar> |
|
<replaceable><console map base file name></replaceable> |
|
</term> |
|
<listitem> |
|
<para>see description of '-m' parameter in setfont manual; taken from consoletrans directory; will be written to /etc/sysconfig/i18n in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>UNIMAP=</envar> |
|
<replaceable><unicode table base file name></replaceable> |
|
</term> |
|
<listitem> |
|
<para>see description of '-u' parameter in setfont manual; taken from unimaps directory; will be written to /etc/sysconfig/i18n in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>LANG=</envar> |
|
<replaceable><locale></replaceable> |
|
</term> |
|
<listitem> |
|
<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> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>LC_ALL=</envar> |
|
<replaceable><locale></replaceable> |
|
</term> |
|
<listitem> |
|
<para>taken from the environment; will be written to /etc/sysconfig/i18n in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>LVM</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_LVM</envar> |
|
</term> |
|
<listitem> |
|
<para>disable LVM detection</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_LVM_VG=<replaceable><volume group name></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>only activate the volume groups with the given name |
|
rd_LVM_VG can be specified multiple times on the kernel command line.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_LVM_LV=<replaceable><logical volume name></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>only activate the logical volumes with the given name |
|
rd_LVM_LV can be specified multiple times on the kernel command line.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_LVMCONF</envar> |
|
</term> |
|
<listitem> |
|
<para>remove any /etc/lvm/lvm.conf, which may exist in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>crypto LUKS</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_LUKS</envar> |
|
</term> |
|
<listitem> |
|
<para>disable crypto LUKS detection</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_LUKS_UUID=<replaceable><luks uuid></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>only activate the LUKS partitions with the given UUID |
|
Any "luks-" of the LUKS UUID is removed before comparing to <luks uuid>. |
|
The comparisons also matches, if <luks uuid> is only the beginning of the |
|
LUKS UUID, so you don't have to specify the full UUID. |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_CRYPTTAB</envar> |
|
</term> |
|
<listitem> |
|
<para>do not check, if LUKS partition is in /etc/crypttab</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>crypt LUKS - experimental removable keys support</title> |
|
<para>works only when plymouth module is not included</para> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_LUKS_KEYPATH=</envar> |
|
<replaceable><path to keyfile></replaceable> |
|
</term> |
|
<listitem> |
|
<para>path to keyfile inside remove device filesystem</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_LUKS_KEYDEV_UUID=</envar> |
|
<replaceable><rem. device uuid></replaceable> |
|
</term> |
|
<listitem> |
|
<para>UUID of removalbe device storing keyfile; UUID doesn't have to be exact just like for rd_LUKS_UUID</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>MD</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_MD</envar> |
|
</term> |
|
<listitem> |
|
<para>disable MD RAID detection</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_MDIMSM</envar> |
|
</term> |
|
<listitem> |
|
<para>no MD RAID for imsm/isw raids, use dmraid instead</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_MDADMCONF</envar> |
|
</term> |
|
<listitem> |
|
<para>ignore mdadm.conf included in initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_MD_UUID=<replaceable><md uuid></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>only activate the raid sets with the given UUID. |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>DMRAID</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_DM</envar> |
|
</term> |
|
<listitem> |
|
<para>disable DM RAID detection</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_DM_UUID=<replaceable><dmraid uuid></replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>only activate the raid sets with the given UUID. |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>Network</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>ip=</envar> |
|
<replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable> |
|
</term> |
|
<listitem> |
|
<para>dhcp|on|any: get ip from dhcp server from all interfaces. If root=dhcp, |
|
loop sequentially through all interfaces (eth0, eth1, ...) and use the first |
|
with a valid DHCP root-path.</para> |
|
<para>auto6: do IPv6 autoconfiguration</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term><envar>ip=</envar><replaceable><interface></replaceable>:<replaceable>{dhcp|on|any|dhcp6|auto6}</replaceable></term> |
|
<listitem> |
|
<para>dhcp|on|any|dhcp6: get ip from dhcp server on a specific interface |
|
auto6: do IPv6 autoconfiguration |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term><envar>ip=</envar><replaceable><client-IP></replaceable>:<optional> |
|
<replaceable><server-id></replaceable> |
|
</optional>:<replaceable><gateway-IP></replaceable>:<replaceable><netmask></replaceable>:<replaceable><client_hostname></replaceable>:<replaceable><interface></replaceable>:<replaceable>{none|off}</replaceable></term> |
|
<listitem> |
|
<para>explicit network configuration. If you want do define a IPv6 address, put it in brackets (e.g. [2001:DB8::1]). |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term><envar>ifname=</envar><replaceable><interface></replaceable>:<replaceable><MAC></replaceable></term> |
|
<listitem> |
|
<para>Assign network device name <interface> (ie eth0) to the NIC with MAC <MAC>. |
|
Note letters in the MAC-address must be lowercase! |
|
Note that if you use this option you <emphasis remap="B">must</emphasis> specify an ifname= argument |
|
for all interfaces used in ip= or fcoe= arguments |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>bootdev=</envar> |
|
<replaceable><interface></replaceable> |
|
</term> |
|
<listitem> |
|
<para>specify network interface to use routing and netroot information from. |
|
Required if multiple ip= lines are used.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>nameserver=</envar> |
|
<replaceable><IP></replaceable> |
|
<optional><envar>nameserver</envar>=<replaceable><IP></replaceable> ...</optional> |
|
</term> |
|
<listitem> |
|
<para>specify nameserver(s) to use</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>NFS</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>root=</envar> |
|
<optional><replaceable><server-ip></replaceable>:</optional> |
|
<replaceable><root-dir></replaceable> |
|
<optional>:<replaceable><nfs-options></replaceable></optional> |
|
</term> |
|
<listitem> |
|
<para>mount nfs share from <server-ip>:/<root-dir>, if no server-ip is given, |
|
use dhcp next_server. if server-ip is an IPv6 address it has to be put in brackets, e.g. [2001:DB8::1]. |
|
NFS options can be appended with the prefix ":" or "," and are seperated by ",".</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term><envar>root=</envar>nfs:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term> |
|
<term><envar>root=</envar>nfs4:<optional><replaceable><server-ip></replaceable>:</optional><replaceable><root-dir></replaceable><optional>:<replaceable><nfs-options></replaceable></optional></term> |
|
<term> |
|
<envar>root=</envar> |
|
<replaceable>{dhcp|dhcp6}</replaceable> |
|
</term> |
|
<listitem> |
|
<para>root=dhcp alone directs initrd to look at the DHCP root-path where NFS |
|
options can be specified. |
|
root-path=<server-ip>:<root-dir>[,<nfs-options>] |
|
root-path=nfs:<server-ip>:<root-dir>[,<nfs-options>] |
|
root-path=nfs4:<server-ip>:<root-dir>[,<nfs-options>]</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>root=</envar> |
|
<filename>/dev/nfs</filename> |
|
<envar> nfsroot=</envar> |
|
<optional><replaceable><server-ip></replaceable>:</optional> |
|
<replaceable><root-dir></replaceable> |
|
<optional>:<replaceable><nfs-options></replaceable></optional> |
|
</term> |
|
<listitem> |
|
<para><emphasis remap="B">Deprecated!</emphasis> kernel Documentation/filesystems/nfsroot.txt defines |
|
this method. |
|
This is supported by dracut but not recommended.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar remap="B">rd_NFS_DOMAIN=</envar> |
|
<replaceable><NFSv4 domain name></replaceable> |
|
</term> |
|
<listitem> |
|
<para>Set the NFSv4 domain name. Will overwrite the settings in /etc/idmap.conf.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>iSCSI</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term><envar>root=</envar>iscsi:<optional><replaceable><username></replaceable>:<replaceable><password></replaceable><optional>:<replaceable><reverse></replaceable>:<replaceable><password></replaceable></optional>@</optional><optional> |
|
<replaceable><servername></replaceable> |
|
</optional>:<optional> |
|
<replaceable><protocol></replaceable> |
|
</optional>:<optional> |
|
<replaceable><port></replaceable> |
|
</optional>:<optional> |
|
<replaceable><LUN></replaceable> |
|
</optional>:<replaceable><targetname></replaceable></term> |
|
<listitem> |
|
<para>protocol defaults to "6", LUN defaults to "0".</para> |
|
<para>If the "servername" field is provided by BOOTP or DHCP, then that |
|
field is used in conjunction with other associated fields to contact |
|
the boot server in the Boot stage (Section 7). However, if the |
|
"servername" field is not provided, then the "targetname" field is |
|
then used in the Discovery Service stage in conjunction with other |
|
associated fields.</para> |
|
<para><ulink url="http://tools.ietf.org/html/rfc4173">http://tools.ietf.org/html/rfc4173</ulink></para> |
|
<para>e.g. |
|
<programlisting> |
|
root=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 |
|
</programlisting> |
|
</para> |
|
<para>If servername is an IPv6 address, it has to be put in brackets. e.g. |
|
<programlisting> |
|
root=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0 |
|
</programlisting></para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<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> |
|
<replaceable><servername></replaceable> |
|
</optional>:<optional> |
|
<replaceable><protocol></replaceable> |
|
</optional>:<optional> |
|
<replaceable><port></replaceable> |
|
</optional>:<optional> |
|
<replaceable><LUN></replaceable> |
|
</optional>:<replaceable><targetname></replaceable> ...</term> |
|
<listitem> |
|
<para>multiple netroot options allow setting up multiple iscsi disks. e.g. |
|
<programlisting> |
|
root=UUID=12424547 |
|
netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target0 |
|
netroot=iscsi:192.168.50.1::::iqn.2009-06.dracut:target1 |
|
</programlisting></para> |
|
<para>If servername is an IPv6 address, it has to be put in brackets. |
|
e.g. |
|
<programlisting>netroot=iscsi:[2001:DB8::1]::::iqn.2009-06.dracut:target0</programlisting></para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>root=<replaceable>???</replaceable></envar> |
|
<envar> iscsi_initiator=<replaceable><initiator> </replaceable></envar> |
|
<envar>iscsi_target_name=<replaceable><target_name> </replaceable></envar> |
|
<envar>iscsi_target_ip=<replaceable><target ip> </replaceable></envar> |
|
<envar>iscsi_target_port=<replaceable><target port> </replaceable></envar> |
|
<envar>iscsi_target_group=<replaceable><target group> </replaceable></envar> |
|
<envar>iscsi_username=<replaceable><username> </replaceable></envar> |
|
<envar>iscsi_password=<replaceable><password> </replaceable></envar> |
|
<envar>iscsi_in_username=<replaceable><in username> </replaceable></envar> |
|
<envar>iscsi_in_password=<replaceable><in password> </replaceable></envar> |
|
</term> |
|
<listitem> |
|
<para>manually specify all iscsistart parameter (see <userinput>iscsistart --help</userinput>)</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term><envar>root=</envar>???<envar> iscsi_firmware</envar></term> |
|
<listitem> |
|
<para>will read the iscsi parameter from the BIOS firmware</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>FCoE</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term><envar>netroot=</envar>fcoe:<replaceable><interface|MAC></replaceable>:<replaceable>{dcb|nodcb}</replaceable></term> |
|
<listitem> |
|
<para>Try to connect to a FCoE SAN through the NIC specified by <interface> or <MAC>, |
|
for the second argument, currently only nodcb is supported. Note letters in |
|
the MAC-address must be lowercase!</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>NBD</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term><envar>root=</envar><constant>nbd</constant>:<replaceable><server></replaceable>:<replaceable><port></replaceable><optional>:<replaceable><fstype></replaceable></optional><optional>:<replaceable><mountopts></replaceable></optional></term> |
|
<listitem> |
|
<para>mount nbd share from <server></para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>root=dhcp</envar> |
|
</term> |
|
<listitem> |
|
<para>with dhcp root-path=nbd:<server>:<port>[:<fstype>][:<mountopts>] |
|
root=dhcp alone directs initrd to look at the DHCP root-path where NBD |
|
options can be specified. |
|
This syntax is only usable in cases where you are directly mounting the volume |
|
as the rootfs.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>DASD</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term><envar>rd_DASD_MOD=</envar>....</term> |
|
<listitem> |
|
<para>same syntax as the kernel module parameter (s390 only)</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_DASD=</envar> |
|
<replaceable><dasd_adaptor device bus ID></replaceable> |
|
<optional>,readonly=<replaceable>X</replaceable></optional> |
|
<optional>,use_diag=<replaceable>X</replaceable></optional> |
|
<optional>,erplog=<replaceable>X</replaceable></optional> |
|
</term> |
|
<listitem> |
|
<para>activate DASD device with the given adaptor device bus ID and setting the sysfs attributes |
|
to the specified values |
|
This parameter can be specified multiple times.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>ZFCP</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term><envar>rd_ZFCP=</envar><replaceable><zfcp adaptor device bus ID></replaceable>,<replaceable><WWPN></replaceable>,<replaceable><FCPLUN></replaceable></term> |
|
<listitem> |
|
<para>rd_ZFCP can be specified multiple times on the kernel command line.</para> |
|
<para>example: rd_ZFCP=0.0.4000,0x5005076300C213e9,0x5022000000000000</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_ZFCPCONF</envar> |
|
</term> |
|
<listitem> |
|
<para>ignore zfcp.conf included in the initramfs</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>ZNET</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term><envar>rd_ZNET=</envar><replaceable><nettype></replaceable>,<replaceable><subchannels></replaceable>,<replaceable><options></replaceable></term> |
|
<listitem> |
|
<para>rd_ZNET can be specified multiple times on the kernel command line. Examples: |
|
rd_ZNET=qeth,0.0.0600,0.0.0601,0.0.0602,layer2=1,portname=foo |
|
rd_ZNET=ctc,0.0.0600,0.0.0601,0.0.0602,protocol=bar</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
<refsect2> |
|
<title>Plymouth Boot Splash</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<envar>rd_NO_PLYMOUTH</envar> |
|
</term> |
|
<listitem> |
|
<para>do not start plymouth. This will not work with encrypted partitions.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
</refsect1> |
|
<refsect1> |
|
<title>Files</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<filename>/var/log/dracut.log</filename> |
|
</term> |
|
<listitem> |
|
<para>logfile of initramfs image creation</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<filename>/tmp/dracut.log</filename> |
|
</term> |
|
<listitem> |
|
<para>logfile of initramfs image creation, if /var/log/dracut.log is not writable</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<filename>/etc/dracut.conf</filename> |
|
</term> |
|
<listitem> |
|
<para>see <citerefentry> |
|
<refentrytitle>dracut.conf</refentrytitle> |
|
<manvolnum>5</manvolnum> |
|
</citerefentry></para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<filename>/etc/dracut.conf.d/*.conf</filename> |
|
</term> |
|
<listitem> |
|
<para>see <citerefentry> |
|
<refentrytitle>dracut.conf</refentrytitle> |
|
<manvolnum>5</manvolnum> |
|
</citerefentry></para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
<refsect2> |
|
<title>Configuration in the Initramfs</title> |
|
<variablelist> |
|
<varlistentry> |
|
<term> |
|
<filename>/conf/conf.d/</filename> |
|
</term> |
|
<listitem> |
|
<para>Any files found in /conf/conf.d/ will be sourced in the initramfs to |
|
set initial values. Command line options will override these values |
|
set in the configuration files.</para> |
|
</listitem> |
|
</varlistentry> |
|
<varlistentry> |
|
<term> |
|
<filename>/etc/cmdline</filename> |
|
</term> |
|
<listitem> |
|
<para>Can contain additional command line options.</para> |
|
</listitem> |
|
</varlistentry> |
|
</variablelist> |
|
</refsect2> |
|
</refsect1> |
|
<refsect1> |
|
<title>See Also</title> |
|
<para> |
|
<citerefentry> |
|
<refentrytitle>dracut</refentrytitle> |
|
<manvolnum>8</manvolnum> |
|
</citerefentry> |
|
<citerefentry> |
|
<refentrytitle>dracut.conf</refentrytitle> |
|
<manvolnum>5</manvolnum> |
|
</citerefentry> |
|
</para> |
|
</refsect1> |
|
</refentry>
|
|
|