]> git.ipfire.org Git - thirdparty/dracut.git/blob - dracut.conf.5.asc
ro_mnt - option at build time to force ro mount of / and /usr
[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
69 instead of a generic host and generate host-specific configuration.
70
71 *tmpdir=*"__<temporary directory>__"::
72 Specify temporary directory to use.
73
74 [WARNING]
75 ====
76 If chrooted to another root other than the real root device, use --fstab and provide a valid _/etc/fstab_.
77 ====
78
79 *use_fstab=*"__{yes|no}__"::
80 Use _/etc/fstab_ instead of _/proc/self/mountinfo_.
81
82 *add_fstab+=*" __<filename>__ "::
83 Add entries of __<filename>__ to the initramfs /etc/fstab.
84
85 *mdadmconf=*"__{yes|no}__"::
86 Include local _/etc/mdadm.conf_ (default=yes)
87
88 *lvmconf=*"__{yes|no}__"::
89 Include local _/etc/lvm/lvm.conf_ (default=yes)
90
91 *fscks=*" __<fsck tools>__ "::
92 Add a space-separated list of fsck tools. If nothing is specified, the
93 default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
94 jfs_fsck reiserfsck btrfsck". The installation is opportunistic
95 (non-existing tools are ignored).
96
97 *nofscks=*"__{yes|no}__"::
98 If specified, inhibit installation of any fsck tools.
99
100 *ro_mnt*
101 Mount _/_ and _/usr_ read-only by default.
102
103 *kernel_only=*"__{yes|no}__"::
104 Only install kernel drivers and firmware files. (default=no)
105
106 *no_kernel=*"{yes|no}"::
107 Do not install kernel drivers and firmware files (default=no)
108
109 *stdloglvl*="__\{0-6\}__"::
110 Set logging to standard error level.
111
112 *sysloglvl*="__\{0-6\}__"::
113 Set logging to syslog level.
114
115 *fileloglvl=*"__\{0-6\}__"::
116 Set logging to file level.
117
118 *logfile=*"__<file>__"::
119 Path to log file.
120
121 *show_modules=*"__{yes|no}__"::
122 Print included module's name to standard output during build.
123
124 Files
125 -----
126 _/etc/dracut.conf_::
127 Old configuration file. You better use your own file in
128 _/etc/dracut/conf.d/_.
129
130 _/etc/dracut/conf.d/_::
131 Any _/etc/dracut/conf.d/*.conf_ file can overwrite the values in
132 _/etc/dracut.conf_. The configuration files are read in alphanumerical
133 order.
134
135 AUTHOR
136 ------
137 Harald Hoyer
138
139 See Also
140 --------
141 *dracut*(8) *dracut.cmdline*(7)
142