]>
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.5/docbookx.dtd" []> |
4c5da015 | 3 | <!-- vim: set ts=8 sts=2 sw=2 et: --> |
cdc8d9c4 HH |
4 | <refentry id="dracutconf5"> |
5 | <refentryinfo> | |
6 | <title>dracut.conf</title> | |
7 | <productname>dracut</productname> | |
8 | <authorgroup> | |
9 | <author> | |
10 | <contrib>Developer</contrib> | |
11 | <firstname>Harald</firstname> | |
12 | <surname>Hoyer</surname> | |
13 | <email>harald@redhat.com</email> | |
14 | </author> | |
15 | </authorgroup> | |
16 | </refentryinfo> | |
17 | <refmeta> | |
18 | <refentrytitle>dracut.conf</refentrytitle> | |
19 | <manvolnum>5</manvolnum> | |
20 | </refmeta> | |
21 | <refnamediv> | |
22 | <refname>dracut.conf</refname> | |
23 | <refpurpose>configuration file(s) for dracut</refpurpose> | |
24 | </refnamediv> | |
25 | <refsynopsisdiv> | |
26 | <cmdsynopsis> | |
27 | <command>/etc/dracut.conf</command> | |
28 | <arg choice="plain"> | |
29 | <replaceable>/etc/dracut.conf.d/*.conf</replaceable> | |
30 | </arg> | |
31 | <sbr/> | |
32 | </cmdsynopsis> | |
33 | </refsynopsisdiv> | |
34 | <refsect1> | |
35 | <title>Description</title> | |
f844e7dc | 36 | <para><filename>dracut.conf</filename> |
cdc8d9c4 HH |
37 | is loaded during the initialisation phase of dracut. |
38 | Command line parameter will overwrite any values set here. | |
f844e7dc HH |
39 | <emphasis><filename>dracut.conf.d/*.conf</filename> files are read in alphanumerical order and will</emphasis> |
40 | overwrite parameters set in <filename>/etc/dracut.conf</filename>. Each line specifies an attribute and a value. A '#' indicates the beginning of a comment; following characters, up to the end of the line are not interpreted.</para> | |
cdc8d9c4 HH |
41 | <variablelist> |
42 | <varlistentry> | |
3eccdb52 HH |
43 | <term> |
44 | <envar>dracutmodules+=" <replaceable><dracut modules></replaceable> "</envar> | |
45 | </term> | |
cdc8d9c4 HH |
46 | <listitem> |
47 | <para>Specify a space-separated list of dracut modules to | |
48 | call when building the initramfs. Modules are located | |
c5a65990 | 49 | in <filename>/usr/lib/dracut/modules.d</filename>.</para> |
cdc8d9c4 HH |
50 | </listitem> |
51 | </varlistentry> | |
52 | <varlistentry> | |
3eccdb52 HH |
53 | <term> |
54 | <envar>omit_dracutmodules+=" <replaceable><dracut modules></replaceable> "</envar> | |
55 | </term> | |
cdc8d9c4 HH |
56 | <listitem> |
57 | <para>Omit a space-separated list of dracut modules.</para> | |
58 | </listitem> | |
59 | </varlistentry> | |
60 | <varlistentry> | |
3eccdb52 HH |
61 | <term> |
62 | <envar>add_dracutmodules+=" <replaceable><dracut modules></replaceable> "</envar> | |
63 | </term> | |
cdc8d9c4 HH |
64 | <listitem> |
65 | <para>Add a space-separated list of dracut modules.</para> | |
66 | </listitem> | |
67 | </varlistentry> | |
68 | <varlistentry> | |
3eccdb52 HH |
69 | <term> |
70 | <envar>drivers+=" <replaceable><kernel modules></replaceable> "</envar> | |
71 | </term> | |
cdc8d9c4 HH |
72 | <listitem> |
73 | <para>Specify a space-separated list of kernel modules to | |
74 | exclusively include in the initramfs. | |
75 | The kernel modules have to be specified without the ".ko" suffix.</para> | |
76 | </listitem> | |
77 | </varlistentry> | |
78 | <varlistentry> | |
3eccdb52 HH |
79 | <term> |
80 | <envar>add_drivers+=" <replaceable><kernel modules></replaceable> "</envar> | |
81 | </term> | |
cdc8d9c4 | 82 | <listitem> |
3b403b32 | 83 | <para>Specify a space-separated list of kernel |
cdc8d9c4 | 84 | modules to add to the initramfs. |
fcbcb252 HH |
85 | The kernel modules have to be specified without the ".ko" suffix.</para> |
86 | </listitem> | |
87 | </varlistentry> | |
88 | <varlistentry> | |
89 | <term> | |
90 | <envar>omit_drivers+=" <replaceable><kernel modules></replaceable> "</envar> | |
91 | </term> | |
92 | <listitem> | |
93 | <para>Specify a space-separated list of kernel | |
94 | modules not to add to the initramfs. | |
cdc8d9c4 HH |
95 | The kernel modules have to be specified without the ".ko" suffix.</para> |
96 | </listitem> | |
97 | </varlistentry> | |
c6c6a088 HH |
98 | <varlistentry> |
99 | <term> | |
100 | <envar>install_items+=" <replaceable><kernel modules></replaceable> "</envar> | |
101 | </term> | |
102 | <listitem> | |
103 | <para>Specify a space-separated list of files, which are added to the initramfs image.</para> | |
104 | </listitem> | |
105 | </varlistentry> | |
cdc8d9c4 | 106 | <varlistentry> |
3eccdb52 HH |
107 | <term> |
108 | <envar>filesystems+=" <replaceable><filesystem names></replaceable> "</envar> | |
109 | </term> | |
cdc8d9c4 HH |
110 | <listitem> |
111 | <para>Specify a space-separated list of kernel filesystem | |
112 | modules to exclusively include in the generic | |
113 | initramfs.</para> | |
114 | </listitem> | |
115 | </varlistentry> | |
116 | <varlistentry> | |
3eccdb52 HH |
117 | <term> |
118 | <envar>drivers_dir="<replaceable><kernel modules directory></replaceable>"</envar> | |
119 | </term> | |
cdc8d9c4 HH |
120 | <listitem> |
121 | <para>Specify the directory, where to look for kernel modules</para> | |
122 | </listitem> | |
123 | </varlistentry> | |
124 | <varlistentry> | |
3eccdb52 HH |
125 | <term> |
126 | <envar>fw_dir+=" :<replaceable><dir></replaceable>[:<replaceable><dir></replaceable> ...] "</envar> | |
127 | </term> | |
cdc8d9c4 | 128 | <listitem> |
f844e7dc | 129 | <para>Specify additional directories, where to look for firmwares, separated by <constant>:</constant></para> |
cdc8d9c4 HH |
130 | </listitem> |
131 | </varlistentry> | |
0ec40e08 HH |
132 | <varlistentry> |
133 | <term> | |
134 | <envar>install_items+=" <replaceable><file></replaceable>[ <replaceable><file></replaceable> ...] "</envar> | |
135 | </term> | |
136 | <listitem> | |
137 | <para>Specify additional files to include in the initramfs, separated by spaces.</para> | |
138 | </listitem> | |
139 | </varlistentry> | |
cdc8d9c4 | 140 | <varlistentry> |
3eccdb52 HH |
141 | <term> |
142 | <envar>do_strip="<replaceable>{yes|no}</replaceable>"</envar> | |
143 | </term> | |
cdc8d9c4 HH |
144 | <listitem> |
145 | <para>Strip binaries in the initramfs (default=yes)</para> | |
146 | </listitem> | |
147 | </varlistentry> | |
148 | <varlistentry> | |
3eccdb52 HH |
149 | <term> |
150 | <envar>hostonly="<replaceable>{yes|no}</replaceable>"</envar> | |
151 | </term> | |
cdc8d9c4 | 152 | <listitem> |
3b403b32 | 153 | <para>Host-Only mode: Install only what is needed for booting |
f844e7dc HH |
154 | the local host instead of a generic host. |
155 | <warning><para>If chrooted to another root other than the real root device, use <option>--fstab</option> and provide a valid <filename>/etc/fstab</filename>.</para> | |
156 | </warning> | |
157 | </para> | |
d350ae69 HH |
158 | </listitem> |
159 | </varlistentry> | |
160 | <varlistentry> | |
161 | <term> | |
162 | <envar>use_fstab="<replaceable>{yes|no}</replaceable>"</envar> | |
163 | </term> | |
164 | <listitem> | |
f844e7dc | 165 | <para>Use <filename>/etc/fstab</filename> instead of <filename>/proc/self/mountinfo</filename>.</para> |
cdc8d9c4 HH |
166 | </listitem> |
167 | </varlistentry> | |
45abddb0 HH |
168 | <varlistentry> |
169 | <term> | |
170 | <envar>add_fstab+=" <replaceable><filename></replaceable> "</envar> | |
171 | </term> | |
172 | <listitem> | |
173 | <para>Add entries of <replaceable><filename></replaceable> to the initramfs /etc/fstab.</para> | |
174 | </listitem> | |
175 | </varlistentry> | |
cdc8d9c4 | 176 | <varlistentry> |
3eccdb52 HH |
177 | <term> |
178 | <envar>mdadmconf="<replaceable>{yes|no}</replaceable>"</envar> | |
179 | </term> | |
cdc8d9c4 | 180 | <listitem> |
f844e7dc | 181 | <para>Include local <filename>/etc/mdadm.conf</filename> (default=yes)</para> |
cdc8d9c4 HH |
182 | </listitem> |
183 | </varlistentry> | |
184 | <varlistentry> | |
3eccdb52 HH |
185 | <term> |
186 | <envar>lvmconf="<replaceable>{yes|no}</replaceable>"</envar> | |
187 | </term> | |
cdc8d9c4 | 188 | <listitem> |
f844e7dc | 189 | <para>Include local <filename>/etc/lvm/lvm.conf</filename> (default=yes)</para> |
cdc8d9c4 HH |
190 | </listitem> |
191 | </varlistentry> | |
4c5da015 MS |
192 | <varlistentry> |
193 | <term> | |
194 | <envar>fscks=" <replaceable><fsck tools></replaceable> "</envar> | |
195 | </term> | |
196 | <listitem> | |
197 | <para>Add a space-separated list of fsck tools. If nothing is | |
198 | specified, the default is: "<replaceable>umount mount | |
199 | /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck jfs_fsck | |
200 | reiserfsck btrfsck</replaceable>" | |
201 | </para> | |
61bc3bbc | 202 | <para>The installation is opportunistic (non-existing tools are ignored).</para> |
4c5da015 MS |
203 | </listitem> |
204 | </varlistentry> | |
205 | <varlistentry> | |
206 | <term> | |
207 | <envar>nofscks="<replaceable>{yes}</replaceable>"</envar> | |
208 | </term> | |
209 | <listitem> | |
210 | <para>If specified, inhibit installation of any fsck tools.</para> | |
211 | </listitem> | |
212 | </varlistentry> | |
cdc8d9c4 | 213 | <varlistentry> |
3eccdb52 HH |
214 | <term> |
215 | <envar>kernel_only="<replaceable>{yes|no}</replaceable>"</envar> | |
216 | </term> | |
cdc8d9c4 HH |
217 | <listitem> |
218 | <para>Only install kernel drivers and firmware files. (default=no)</para> | |
219 | </listitem> | |
220 | </varlistentry> | |
221 | <varlistentry> | |
3eccdb52 HH |
222 | <term> |
223 | <envar>no_kernel="<replaceable>{yes|no}</replaceable>"</envar> | |
224 | </term> | |
cdc8d9c4 HH |
225 | <listitem> |
226 | <para>Do not install kernel drivers and firmware files (default=no)</para> | |
227 | </listitem> | |
228 | </varlistentry> | |
adcccd18 AŻ |
229 | <varlistentry> |
230 | <term> | |
231 | <envar>stdloglvl="<replaceable>{0-6}</replaceable>"</envar> | |
232 | </term> | |
233 | <listitem> | |
234 | <para>Set logging to standard error level.</para> | |
235 | </listitem> | |
236 | </varlistentry> | |
237 | <varlistentry> | |
238 | <term> | |
239 | <envar>sysloglvl="<replaceable>{0-6}</replaceable>"</envar> | |
240 | </term> | |
241 | <listitem> | |
242 | <para>Set logging to syslog level.</para> | |
243 | </listitem> | |
244 | </varlistentry> | |
245 | <varlistentry> | |
246 | <term> | |
247 | <envar>fileloglvl="<replaceable>{0-6}</replaceable>"</envar> | |
248 | </term> | |
249 | <listitem> | |
250 | <para>Set logging to file level.</para> | |
251 | </listitem> | |
252 | </varlistentry> | |
253 | <varlistentry> | |
254 | <term> | |
255 | <envar>logfile="<replaceable><file></replaceable>"</envar> | |
256 | </term> | |
257 | <listitem> | |
258 | <para>Path to log file.</para> | |
259 | </listitem> | |
260 | </varlistentry> | |
261 | <varlistentry> | |
262 | <term> | |
263 | <envar>show_modules="<replaceable>{yes|no}</replaceable>"</envar> | |
264 | </term> | |
265 | <listitem> | |
266 | <para>Print included module's name to standard output during build.</para> | |
267 | </listitem> | |
268 | </varlistentry> | |
cdc8d9c4 HH |
269 | </variablelist> |
270 | </refsect1> | |
271 | <refsect1> | |
272 | <title>Files</title> | |
273 | <variablelist> | |
274 | <varlistentry> | |
275 | <term> | |
276 | <filename>/etc/dracut/conf.d/</filename> | |
277 | </term> | |
278 | <listitem> | |
f844e7dc | 279 | <para>Any <filename>/etc/dracut/conf.d/*.conf</filename> file can overwrite the values in <filename>/etc/dracut.conf</filename>. |
cdc8d9c4 HH |
280 | The configuration files are read in alphanumerical order.</para> |
281 | </listitem> | |
282 | </varlistentry> | |
283 | </variablelist> | |
284 | </refsect1> | |
285 | <refsect1> | |
286 | <title>See Also</title> | |
287 | <para><citerefentry> | |
288 | <refentrytitle>dracut</refentrytitle> | |
289 | <manvolnum>8</manvolnum> | |
290 | </citerefentry> | |
291 | <citerefentry> | |
45abddb0 | 292 | <refentrytitle>dracut.cmdline</refentrytitle> |
cdc8d9c4 HH |
293 | <manvolnum>7</manvolnum> |
294 | </citerefentry> | |
295 | </para> | |
296 | </refsect1> | |
297 | </refentry> |