]>
Commit | Line | Data |
---|---|---|
888d53f2 HH |
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 | -------- | |
c4e098a5 | 13 | _/etc/dracut.conf_ _/etc/dracut.conf.d/*.conf_ _/usr/lib/dracut/dracut.conf.d/*.conf_ |
888d53f2 HH |
14 | |
15 | Description | |
16 | ----------- | |
17 | _dracut.conf_ is loaded during the initialisation phase of dracut. Command line | |
c4e098a5 HH |
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 | |
888d53f2 HH |
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 | ||
c4e098a5 HH |
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 | ||
888d53f2 HH |
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 | ||
888d53f2 HH |
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 | ||
f4a94278 HH |
70 | *do_prelink=*"__{yes|no}__":: |
71 | Prelink binaries in the initramfs (default=yes) | |
72 | ||
888d53f2 | 73 | *hostonly=*"__{yes|no}__":: |
1d97bb8b AŻ |
74 | Host-Only mode: Install only what is needed for booting the local host |
75 | instead of a generic host and generate host-specific configuration. | |
888d53f2 | 76 | |
3411ad66 HH |
77 | *persistent_policy=*"__<policy>__":: |
78 | Use _<policy>_ to address disks and partitions. | |
79 | _<policy>_ can be any directory name found in /dev/disk. | |
80 | E.g. "by-uuid", "by-label" | |
81 | ||
4dd68ca4 AŻ |
82 | *tmpdir=*"__<temporary directory>__":: |
83 | Specify temporary directory to use. | |
84 | ||
888d53f2 HH |
85 | [WARNING] |
86 | ==== | |
87 | If chrooted to another root other than the real root device, use --fstab and provide a valid _/etc/fstab_. | |
88 | ==== | |
89 | ||
90 | *use_fstab=*"__{yes|no}__":: | |
91 | Use _/etc/fstab_ instead of _/proc/self/mountinfo_. | |
92 | ||
93 | *add_fstab+=*" __<filename>__ ":: | |
94 | Add entries of __<filename>__ to the initramfs /etc/fstab. | |
95 | ||
c586b033 CG |
96 | *add_device+=*" __<device>__ ":: |
97 | Bring up _<device>_ in initramfs, _<device>_ should be the device name. | |
98 | This can be useful in hostonly mode for resume support when your swap is on | |
99 | LVM an encrypted partition. | |
100 | ||
888d53f2 HH |
101 | *mdadmconf=*"__{yes|no}__":: |
102 | Include local _/etc/mdadm.conf_ (default=yes) | |
103 | ||
104 | *lvmconf=*"__{yes|no}__":: | |
105 | Include local _/etc/lvm/lvm.conf_ (default=yes) | |
106 | ||
107 | *fscks=*" __<fsck tools>__ ":: | |
108 | Add a space-separated list of fsck tools. If nothing is specified, the | |
109 | default is: "umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck | |
110 | jfs_fsck reiserfsck btrfsck". The installation is opportunistic | |
111 | (non-existing tools are ignored). | |
112 | ||
113 | *nofscks=*"__{yes|no}__":: | |
114 | If specified, inhibit installation of any fsck tools. | |
115 | ||
a2b64e30 | 116 | *ro_mnt=*"__{yes|no}__":: |
ff3953ef AŻ |
117 | Mount _/_ and _/usr_ read-only by default. |
118 | ||
d20fb951 HH |
119 | *kernel_cmdline=*"__parameters__":: |
120 | Specify default kernel command line parameters | |
121 | ||
888d53f2 HH |
122 | *kernel_only=*"__{yes|no}__":: |
123 | Only install kernel drivers and firmware files. (default=no) | |
124 | ||
125 | *no_kernel=*"{yes|no}":: | |
126 | Do not install kernel drivers and firmware files (default=no) | |
127 | ||
b7c770e1 DS |
128 | *early_microcode=*"{yes|no}":: |
129 | Combine early microcode with ramdisk (default=no) | |
130 | ||
888d53f2 HH |
131 | *stdloglvl*="__\{0-6\}__":: |
132 | Set logging to standard error level. | |
133 | ||
134 | *sysloglvl*="__\{0-6\}__":: | |
135 | Set logging to syslog level. | |
136 | ||
137 | *fileloglvl=*"__\{0-6\}__":: | |
138 | Set logging to file level. | |
139 | ||
140 | *logfile=*"__<file>__":: | |
141 | Path to log file. | |
142 | ||
143 | *show_modules=*"__{yes|no}__":: | |
c4e098a5 | 144 | Print the name of the included modules to standard output during build. |
888d53f2 HH |
145 | |
146 | Files | |
147 | ----- | |
148 | _/etc/dracut.conf_:: | |
149 | Old configuration file. You better use your own file in | |
81b676a6 | 150 | _/etc/dracut.conf.d/_. |
888d53f2 | 151 | |
dece5ee1 HH |
152 | _/etc/dracut.conf.d/_:: |
153 | Any _/etc/dracut.conf.d/*.conf_ file can overwrite the values in | |
888d53f2 HH |
154 | _/etc/dracut.conf_. The configuration files are read in alphanumerical |
155 | order. | |
156 | ||
157 | AUTHOR | |
158 | ------ | |
159 | Harald Hoyer | |
160 | ||
161 | See Also | |
162 | -------- | |
163 | *dracut*(8) *dracut.cmdline*(7) | |
164 |