]> git.ipfire.org Git - thirdparty/dracut.git/blob - dracut.conf.5.asc
replace xml documentation with asciidoc
[thirdparty/dracut.git] / dracut.conf.5.asc
1 DRACUT.CONF(5)
2 ==============
3 :doctype: manpage
4 :man source: dracut
5 :man manual: dracut
6
7 NAME
8 ----
9 dracut.conf - configuration file(s) for dracut
10
11 SYNOPSIS
12 --------
13 _/etc/dracut.conf_ _/etc/dracut.conf.d/*.conf_
14
15 Description
16 -----------
17 _dracut.conf_ is loaded during the initialisation phase of dracut. Command line
18 parameter will overwrite any values set here. _dracut.conf.d/*.conf_ files are
19 read in alphanumerical order and will overwrite parameters set in
20 _/etc/dracut.conf_. Each line specifies an attribute and a value. A '#'
21 indicates the beginning of a comment; following characters, up to the end of the
22 line are not interpreted.
23
24 *dracutmodules+=*" __<dracut modules>__ "::
25 Specify a space-separated list of dracut modules to call when building the
26 initramfs. Modules are located in _/usr/lib/dracut/modules.d_.
27
28 *omit_dracutmodules+=*" __<dracut modules>__ "::
29 Omit a space-separated list of dracut modules.
30
31 *add_dracutmodules+=*" __<dracut modules>__ "::
32 Add a space-separated list of dracut modules.
33
34 *drivers+=*" __<kernel modules>__ "::
35 Specify a space-separated list of kernel modules to exclusively include in
36 the initramfs. The kernel modules have to be specified without the ".ko"
37 suffix.
38
39 *add_drivers+=*" __<kernel modules>__ "::
40 Specify a space-separated list of kernel modules to add to the initramfs.
41 The kernel modules have to be specified without the ".ko" suffix.
42
43 *omit_drivers+=*" __<kernel modules>__ "::
44 Specify a space-separated list of kernel modules not to add to the
45 initramfs. The kernel modules have to be specified without the ".ko" suffix.
46
47 *install_items+=*" __<kernel modules>__ "::
48 Specify a space-separated list of files, which are added to the initramfs
49 image.
50
51 *filesystems+=*" __<filesystem names>__ "::
52 Specify a space-separated list of kernel filesystem modules to exclusively
53 include in the generic initramfs.
54
55 *drivers_dir=*"__<kernel modules directory>__"::
56 Specify the directory, where to look for kernel modules
57
58 *fw_dir+=*" :__<dir>__[:__<dir>__ ...] "::
59 Specify additional directories, where to look for firmwares, separated by :
60
61 *install_items+=*" __<file>__[ __<file>__ ...] "::
62 Specify additional files to include in the initramfs, separated by spaces.
63
64 *do_strip=*"__{yes|no}__"::
65 Strip binaries in the initramfs (default=yes)
66
67 *hostonly=*"__{yes|no}__"::
68 Host-Only mode: Install only what is needed for booting the local host instead of a generic host.
69
70 [WARNING]
71 ====
72 If chrooted to another root other than the real root device, use --fstab and provide a valid _/etc/fstab_.
73 ====
74
75 *use_fstab=*"__{yes|no}__"::
76 Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
77
78 *add_fstab+=*" __<filename>__ "::
79 Add entries of __<filename>__ to the initramfs /etc/fstab.
80
81 *mdadmconf=*"__{yes|no}__"::
82 Include local _/etc/mdadm.conf_ (default=yes)
83
84 *lvmconf=*"__{yes|no}__"::
85 Include local _/etc/lvm/lvm.conf_ (default=yes)
86
87 *fscks=*" __<fsck tools>__ "::
88 Add a space-separated list of fsck tools. If nothing is specified, the
89 default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
90 jfs_fsck reiserfsck btrfsck". The installation is opportunistic
91 (non-existing tools are ignored).
92
93 *nofscks=*"__{yes|no}__"::
94 If specified, inhibit installation of any fsck tools.
95
96 *kernel_only=*"__{yes|no}__"::
97 Only install kernel drivers and firmware files. (default=no)
98
99 *no_kernel=*"{yes|no}"::
100 Do not install kernel drivers and firmware files (default=no)
101
102 *stdloglvl*="__\{0-6\}__"::
103 Set logging to standard error level.
104
105 *sysloglvl*="__\{0-6\}__"::
106 Set logging to syslog level.
107
108 *fileloglvl=*"__\{0-6\}__"::
109 Set logging to file level.
110
111 *logfile=*"__<file>__"::
112 Path to log file.
113
114 *show_modules=*"__{yes|no}__"::
115 Print included module's name to standard output during build.
116
117 Files
118 -----
119 _/etc/dracut.conf_::
120 Old configuration file. You better use your own file in
121 _/etc/dracut/conf.d/_.
122
123 _/etc/dracut/conf.d/_::
124 Any _/etc/dracut/conf.d/*.conf_ file can overwrite the values in
125 _/etc/dracut.conf_. The configuration files are read in alphanumerical
126 order.
127
128 AUTHOR
129 ------
130 Harald Hoyer
131
132 See Also
133 --------
134 *dracut*(8) *dracut.cmdline*(7)
135