]> git.ipfire.org Git - thirdparty/dracut.git/blob - dracut.conf.5.asc
dracut.conf.5.asc: correct ro_mnt documentation
[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_ _/usr/lib/dracut/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.
19
20 _*.conf_ files are read from /usr/lib/dracut/dracut.conf.d and /etc/dracut.conf.d.
21 Files with the same name in /etc/dracut.conf.d will replace files in /usr/lib/dracut/dracut.conf.d.
22 The files are then read in alphanumerical order and will overwrite parameters set in
23 _/etc/dracut.conf_. Each line specifies an attribute and a value. A '#'
24 indicates the beginning of a comment; following characters, up to the end of the
25 line are not interpreted.
26
27 dracut command line options will overwrite any values set here.
28
29 Configuration files must have the extension .conf; other extensions are ignored.
30
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
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}__"::
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.
73
74 *tmpdir=*"__<temporary directory>__"::
75 Specify temporary directory to use.
76
77 [WARNING]
78 ====
79 If chrooted to another root other than the real root device, use --fstab and provide a valid _/etc/fstab_.
80 ====
81
82 *use_fstab=*"__{yes|no}__"::
83 Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
84
85 *add_fstab+=*" __<filename>__ "::
86 Add entries of __<filename>__ to the initramfs /etc/fstab.
87
88 *add_device+=*" __<device>__ "::
89 Bring up _<device>_ in initramfs, _<device>_ should be the device name.
90 This can be useful in hostonly mode for resume support when your swap is on
91 LVM an encrypted partition.
92
93 *mdadmconf=*"__{yes|no}__"::
94 Include local _/etc/mdadm.conf_ (default=yes)
95
96 *lvmconf=*"__{yes|no}__"::
97 Include local _/etc/lvm/lvm.conf_ (default=yes)
98
99 *fscks=*" __<fsck tools>__ "::
100 Add a space-separated list of fsck tools. If nothing is specified, the
101 default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
102 jfs_fsck reiserfsck btrfsck". The installation is opportunistic
103 (non-existing tools are ignored).
104
105 *nofscks=*"__{yes|no}__"::
106 If specified, inhibit installation of any fsck tools.
107
108 *ro_mnt=*"__{yes|no}__"::
109 Mount _/_ and _/usr_ read-only by default.
110
111 *kernel_cmdline=*"__parameters__"::
112 Specify default kernel command line parameters
113
114 *kernel_only=*"__{yes|no}__"::
115 Only install kernel drivers and firmware files. (default=no)
116
117 *no_kernel=*"{yes|no}"::
118 Do not install kernel drivers and firmware files (default=no)
119
120 *early_microcode=*"{yes|no}"::
121 Combine early microcode with ramdisk (default=no)
122
123 *stdloglvl*="__\{0-6\}__"::
124 Set logging to standard error level.
125
126 *sysloglvl*="__\{0-6\}__"::
127 Set logging to syslog level.
128
129 *fileloglvl=*"__\{0-6\}__"::
130 Set logging to file level.
131
132 *logfile=*"__<file>__"::
133 Path to log file.
134
135 *show_modules=*"__{yes|no}__"::
136 Print the name of the included modules to standard output during build.
137
138 Files
139 -----
140 _/etc/dracut.conf_::
141 Old configuration file. You better use your own file in
142 _/etc/dracut.conf.d/_.
143
144 _/etc/dracut.conf.d/_::
145 Any _/etc/dracut.conf.d/*.conf_ file can overwrite the values in
146 _/etc/dracut.conf_. The configuration files are read in alphanumerical
147 order.
148
149 AUTHOR
150 ------
151 Harald Hoyer
152
153 See Also
154 --------
155 *dracut*(8) *dracut.cmdline*(7)
156