add "--kernel-cmdline" and kernel_cmdline options for default parameters
[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 *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_cmdline=*"__parameters__"::
104     Specify default kernel command line parameters
105
106 *kernel_only=*"__{yes|no}__"::
107     Only install kernel drivers and firmware files. (default=no)
108
109 *no_kernel=*"{yes|no}"::
110     Do not install kernel drivers and firmware files (default=no)
111
112 *stdloglvl*="__\{0-6\}__"::
113     Set logging to standard error level.
114
115 *sysloglvl*="__\{0-6\}__"::
116     Set logging to syslog level.
117
118 *fileloglvl=*"__\{0-6\}__"::
119     Set logging to file level.
120
121 *logfile=*"__<file>__"::
122     Path to log file.
123
124 *show_modules=*"__{yes|no}__"::
125     Print included module's name to standard output during build.
126
127 Files
128 -----
129 _/etc/dracut.conf_::
130     Old configuration file. You better use your own file in
131     _/etc/dracut/conf.d/_.
132
133 _/etc/dracut.conf.d/_::
134     Any _/etc/dracut.conf.d/*.conf_ file can overwrite the values in
135     _/etc/dracut.conf_. The configuration files are read in alphanumerical
136     order.
137
138 AUTHOR
139 ------
140 Harald Hoyer
141
142 See Also
143 --------
144 *dracut*(8) *dracut.cmdline*(7)
145