Extend 52f1b041 to allow devices to be specified in config files as well as cmdline.
[platform/upstream/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