]> git.ipfire.org Git - thirdparty/dracut.git/blame - dracut.conf.5.asc
dracut.sh: we don't need to read the modalias files
[thirdparty/dracut.git] / dracut.conf.5.asc
CommitLineData
888d53f2
HH
1DRACUT.CONF(5)
2==============
3:doctype: manpage
4:man source: dracut
5:man manual: dracut
6
7NAME
8----
9dracut.conf - configuration file(s) for dracut
10
11SYNOPSIS
12--------
c4e098a5 13_/etc/dracut.conf_ _/etc/dracut.conf.d/*.conf_ _/usr/lib/dracut/dracut.conf.d/*.conf_
888d53f2
HH
14
15Description
16-----------
17_dracut.conf_ is loaded during the initialisation phase of dracut. Command line
c4e098a5
HH
18parameter will overwrite any values set here.
19
20_*.conf_ files are read from /usr/lib/dracut/dracut.conf.d and /etc/dracut.conf.d.
21Files with the same name in /etc/dracut.conf.d will replace files in /usr/lib/dracut/dracut.conf.d.
22The files are then read in alphanumerical order and will overwrite parameters set in
888d53f2
HH
23_/etc/dracut.conf_. Each line specifies an attribute and a value. A '#'
24indicates the beginning of a comment; following characters, up to the end of the
25line are not interpreted.
26
c4e098a5
HH
27dracut command line options will overwrite any values set here.
28
29Configuration files must have the extension .conf; other extensions are ignored.
30
888d53f2
HH
31*dracutmodules+=*" __<dracut modules>__ "::
32 Specify a space-separated list of dracut modules to call when building the
33 initramfs. Modules are located in _/usr/lib/dracut/modules.d_.
34
35*omit_dracutmodules+=*" __<dracut modules>__ "::
36 Omit a space-separated list of dracut modules.
37
38*add_dracutmodules+=*" __<dracut modules>__ "::
39 Add a space-separated list of dracut modules.
40
41*drivers+=*" __<kernel modules>__ "::
42 Specify a space-separated list of kernel modules to exclusively include in
43 the initramfs. The kernel modules have to be specified without the ".ko"
44 suffix.
45
46*add_drivers+=*" __<kernel modules>__ "::
47 Specify a space-separated list of kernel modules to add to the initramfs.
48 The kernel modules have to be specified without the ".ko" suffix.
49
50*omit_drivers+=*" __<kernel modules>__ "::
51 Specify a space-separated list of kernel modules not to add to the
52 initramfs. The kernel modules have to be specified without the ".ko" suffix.
53
888d53f2
HH
54*filesystems+=*" __<filesystem names>__ "::
55 Specify a space-separated list of kernel filesystem modules to exclusively
56 include in the generic initramfs.
57
58*drivers_dir=*"__<kernel modules directory>__"::
59 Specify the directory, where to look for kernel modules
60
61*fw_dir+=*" :__<dir>__[:__<dir>__ ...] "::
62 Specify additional directories, where to look for firmwares, separated by :
63
64*install_items+=*" __<file>__[ __<file>__ ...] "::
65 Specify additional files to include in the initramfs, separated by spaces.
66
67*do_strip=*"__{yes|no}__"::
68 Strip binaries in the initramfs (default=yes)
69
70*hostonly=*"__{yes|no}__"::
1d97bb8b
71 Host-Only mode: Install only what is needed for booting the local host
72 instead of a generic host and generate host-specific configuration.
888d53f2 73
3411ad66
HH
74*persistent_policy=*"__<policy>__"::
75 Use _<policy>_ to address disks and partitions.
76 _<policy>_ can be any directory name found in /dev/disk.
77 E.g. "by-uuid", "by-label"
78
4dd68ca4
79*tmpdir=*"__<temporary directory>__"::
80 Specify temporary directory to use.
81
888d53f2
HH
82[WARNING]
83====
84If chrooted to another root other than the real root device, use --fstab and provide a valid _/etc/fstab_.
85====
86
87*use_fstab=*"__{yes|no}__"::
88 Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
89
90*add_fstab+=*" __<filename>__ "::
91 Add entries of __<filename>__ to the initramfs /etc/fstab.
92
c586b033
CG
93*add_device+=*" __<device>__ "::
94 Bring up _<device>_ in initramfs, _<device>_ should be the device name.
95 This can be useful in hostonly mode for resume support when your swap is on
96 LVM an encrypted partition.
97
888d53f2
HH
98*mdadmconf=*"__{yes|no}__"::
99 Include local _/etc/mdadm.conf_ (default=yes)
100
101*lvmconf=*"__{yes|no}__"::
102 Include local _/etc/lvm/lvm.conf_ (default=yes)
103
104*fscks=*" __<fsck tools>__ "::
105 Add a space-separated list of fsck tools. If nothing is specified, the
106 default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
107 jfs_fsck reiserfsck btrfsck". The installation is opportunistic
108 (non-existing tools are ignored).
109
110*nofscks=*"__{yes|no}__"::
111 If specified, inhibit installation of any fsck tools.
112
a2b64e30 113*ro_mnt=*"__{yes|no}__"::
ff3953ef
114 Mount _/_ and _/usr_ read-only by default.
115
d20fb951
HH
116*kernel_cmdline=*"__parameters__"::
117 Specify default kernel command line parameters
118
888d53f2
HH
119*kernel_only=*"__{yes|no}__"::
120 Only install kernel drivers and firmware files. (default=no)
121
122*no_kernel=*"{yes|no}"::
123 Do not install kernel drivers and firmware files (default=no)
124
b7c770e1
DS
125*early_microcode=*"{yes|no}"::
126 Combine early microcode with ramdisk (default=no)
127
888d53f2
HH
128*stdloglvl*="__\{0-6\}__"::
129 Set logging to standard error level.
130
131*sysloglvl*="__\{0-6\}__"::
132 Set logging to syslog level.
133
134*fileloglvl=*"__\{0-6\}__"::
135 Set logging to file level.
136
137*logfile=*"__<file>__"::
138 Path to log file.
139
140*show_modules=*"__{yes|no}__"::
c4e098a5 141 Print the name of the included modules to standard output during build.
888d53f2
HH
142
143Files
144-----
145_/etc/dracut.conf_::
146 Old configuration file. You better use your own file in
81b676a6 147 _/etc/dracut.conf.d/_.
888d53f2 148
dece5ee1
HH
149_/etc/dracut.conf.d/_::
150 Any _/etc/dracut.conf.d/*.conf_ file can overwrite the values in
888d53f2
HH
151 _/etc/dracut.conf_. The configuration files are read in alphanumerical
152 order.
153
154AUTHOR
155------
156Harald Hoyer
157
158See Also
159--------
160*dracut*(8) *dracut.cmdline*(7)
161