]> git.ipfire.org Git - thirdparty/dracut.git/blob - dracut.conf.5.asc
systemd/dracut-pre-trigger.service: load service on demand
[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 *add_device+=*" __<device>__ "::
86 Bring up _<device>_ in initramfs, _<device>_ should be the device name.
87 This can be useful in hostonly mode for resume support when your swap is on
88 LVM an encrypted partition.
89
90 *mdadmconf=*"__{yes|no}__"::
91 Include local _/etc/mdadm.conf_ (default=yes)
92
93 *lvmconf=*"__{yes|no}__"::
94 Include local _/etc/lvm/lvm.conf_ (default=yes)
95
96 *fscks=*" __<fsck tools>__ "::
97 Add a space-separated list of fsck tools. If nothing is specified, the
98 default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck
99 jfs_fsck reiserfsck btrfsck". The installation is opportunistic
100 (non-existing tools are ignored).
101
102 *nofscks=*"__{yes|no}__"::
103 If specified, inhibit installation of any fsck tools.
104
105 *ro_mnt*
106 Mount _/_ and _/usr_ read-only by default.
107
108 *kernel_cmdline=*"__parameters__"::
109 Specify default kernel command line parameters
110
111 *kernel_only=*"__{yes|no}__"::
112 Only install kernel drivers and firmware files. (default=no)
113
114 *no_kernel=*"{yes|no}"::
115 Do not install kernel drivers and firmware files (default=no)
116
117 *stdloglvl*="__\{0-6\}__"::
118 Set logging to standard error level.
119
120 *sysloglvl*="__\{0-6\}__"::
121 Set logging to syslog level.
122
123 *fileloglvl=*"__\{0-6\}__"::
124 Set logging to file level.
125
126 *logfile=*"__<file>__"::
127 Path to log file.
128
129 *show_modules=*"__{yes|no}__"::
130 Print included module's name to standard output during build.
131
132 Files
133 -----
134 _/etc/dracut.conf_::
135 Old configuration file. You better use your own file in
136 _/etc/dracut/conf.d/_.
137
138 _/etc/dracut.conf.d/_::
139 Any _/etc/dracut.conf.d/*.conf_ file can overwrite the values in
140 _/etc/dracut.conf_. The configuration files are read in alphanumerical
141 order.
142
143 AUTHOR
144 ------
145 Harald Hoyer
146
147 See Also
148 --------
149 *dracut*(8) *dracut.cmdline*(7)
150