]> git.ipfire.org Git - thirdparty/systemd.git/blame - man/kernel-command-line.xml
man: mention net.ifnames in kernel-command-line(3)
[thirdparty/systemd.git] / man / kernel-command-line.xml
CommitLineData
c66e7bc7
LP
1<?xml version='1.0'?> <!--*-nxml-*-->
2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
5<!--
6 This file is part of systemd.
7
8 Copyright 2012 Lennart Poettering
9
10 systemd is free software; you can redistribute it and/or modify it
11 under the terms of the GNU Lesser General Public License as published by
12 the Free Software Foundation; either version 2.1 of the License, or
13 (at your option) any later version.
14
15 systemd is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
19
20 You should have received a copy of the GNU Lesser General Public License
21 along with systemd; If not, see <http://www.gnu.org/licenses/>.
22-->
23
24<refentry id="kernel-command-line">
25
26 <refentryinfo>
27 <title>kernel-command-line</title>
28 <productname>systemd</productname>
29
30 <authorgroup>
31 <author>
32 <contrib>Developer</contrib>
33 <firstname>Lennart</firstname>
34 <surname>Poettering</surname>
35 <email>lennart@poettering.net</email>
36 </author>
37 </authorgroup>
38 </refentryinfo>
39
40 <refmeta>
41 <refentrytitle>kernel-command-line</refentrytitle>
42 <manvolnum>7</manvolnum>
43 </refmeta>
44
45 <refnamediv>
46 <refname>kernel-command-line</refname>
34511ca7 47 <refpurpose>Kernel command line parameters</refpurpose>
c66e7bc7
LP
48 </refnamediv>
49
50 <refsynopsisdiv>
51 <para><filename>/proc/cmdline</filename></para>
52 </refsynopsisdiv>
53
54 <refsect1>
55 <title>Description</title>
56
57 <para>The kernel, the initial RAM disk (initrd) and
58 basic userspace functionality may be configured at boot via
59 kernel command line arguments.</para>
60
61 <para>For command line parameters understood by the
62 kernel please see <ulink
99166f29
LP
63 url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
64 and
65 <citerefentry><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
c66e7bc7 66
2ab38e24 67 <para>For command line parameters understood by the
c66e7bc7 68 initial RAM disk, please see
2a91f5f0
LP
69 <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
70 or the documentation of the specific initrd
71 implementation of your installation.</para>
c66e7bc7
LP
72 </refsect1>
73
74 <refsect1>
75 <title>Core OS Command Line Arguments</title>
76
ccc9a4f9 77 <variablelist class='kernel-commandline-options'>
c66e7bc7
LP
78 <varlistentry>
79 <term><varname>systemd.unit=</varname></term>
80 <term><varname>rd.systemd.unit=</varname></term>
81 <term><varname>systemd.dump_core=</varname></term>
82 <term><varname>systemd.crash_shell=</varname></term>
83 <term><varname>systemd.crash_chvt=</varname></term>
84 <term><varname>systemd.confirm_spawn=</varname></term>
85 <term><varname>systemd.show_status=</varname></term>
c66e7bc7
LP
86 <term><varname>systemd.log_target=</varname></term>
87 <term><varname>systemd.log_level=</varname></term>
88 <term><varname>systemd.log_color=</varname></term>
89 <term><varname>systemd.log_location=</varname></term>
90 <term><varname>systemd.default_standard_output=</varname></term>
91 <term><varname>systemd.default_standard_error=</varname></term>
92 <term><varname>systemd.setenv=</varname></term>
93 <listitem>
94 <para>Parameters understood by
95 the system and service manager
c5315881 96 to control system behavior. For details see
c66e7bc7
LP
97 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
98 </listitem>
99 </varlistentry>
100
101 <varlistentry>
102 <term><varname>quiet</varname></term>
103 <listitem>
ccb94c88 104 <para>Parameter understood by
c66e7bc7
LP
105 both the kernel and the system
106 and service manager to control
107 console log verbosity. For
108 details see
109 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry>
114 <term><varname>emergency</varname></term>
115 <term><varname>single</varname></term>
116 <term><varname>s</varname></term>
117 <term><varname>S</varname></term>
118 <term><varname>1</varname></term>
119 <term><varname>2</varname></term>
120 <term><varname>3</varname></term>
121 <term><varname>4</varname></term>
122 <term><varname>5</varname></term>
123 <listitem>
124 <para>Parameters understood by
125 the system and service
126 manager, as compatibility
127 options. For details see
128 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry>
133 <term><varname>locale.LANG=</varname></term>
134 <term><varname>locale.LANGUAGE=</varname></term>
135 <term><varname>locale.LC_CTYPE=</varname></term>
136 <term><varname>locale.LC_NUMERIC=</varname></term>
137 <term><varname>locale.LC_TIME=</varname></term>
138 <term><varname>locale.LC_COLLATE=</varname></term>
139 <term><varname>locale.LC_MONETARY=</varname></term>
140 <term><varname>locale.LC_MESSAGES=</varname></term>
141 <term><varname>locale.LC_PAPER=</varname></term>
142 <term><varname>locale.LC_NAME=</varname></term>
143 <term><varname>locale.LC_ADDRESS=</varname></term>
144 <term><varname>locale.LC_TELEPHONE=</varname></term>
145 <term><varname>locale.LC_MEASUREMENT=</varname></term>
146 <term><varname>locale.LC_IDENTIFICATION=</varname></term>
147 <listitem>
148 <para>Parameters understood by
149 the system and service manager
150 to control locale and language
151 settings. For details see
152 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
153 </listitem>
154 </varlistentry>
155
156 <varlistentry>
157 <term><varname>fsck.mode=</varname></term>
158
159 <listitem>
ccb94c88 160 <para>Parameter understood by
c66e7bc7
LP
161 the file system checker
162 services. For details see
a32f224a 163 <citerefentry><refentrytitle>systemd-fsck@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
c66e7bc7
LP
164 </listitem>
165 </varlistentry>
166
167 <varlistentry>
168 <term><varname>quotacheck.mode=</varname></term>
169
170 <listitem>
ccb94c88 171 <para>Parameter understood by
c66e7bc7
LP
172 the file quota checker
173 service. For details see
93a1d735 174 <citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
c66e7bc7
LP
175 </listitem>
176 </varlistentry>
177
178 <varlistentry>
179 <term><varname>systemd.journald.forward_to_syslog=</varname></term>
180 <term><varname>systemd.journald.forward_to_kmsg=</varname></term>
181 <term><varname>systemd.journald.forward_to_console=</varname></term>
182
183 <listitem>
184 <para>Parameters understood by
185 the journal service. For
186 details see
187 <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
188 </listitem>
189 </varlistentry>
190
191 <varlistentry>
192 <term><varname>vconsole.keymap=</varname></term>
193 <term><varname>vconsole.keymap.toggle=</varname></term>
194 <term><varname>vconsole.font=</varname></term>
195 <term><varname>vconsole.font.map=</varname></term>
196 <term><varname>vconsole.font.unimap=</varname></term>
197
198 <listitem>
199 <para>Parameters understood by
200 the virtual console setup logic. For
201 details see
202 <citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
203 </listitem>
204 </varlistentry>
205
206 <varlistentry>
207 <term><varname>udev.log-priority=</varname></term>
c66e7bc7 208 <term><varname>rd.udev.log-priority=</varname></term>
66a78c2b 209 <term><varname>udev.children-max=</varname></term>
c66e7bc7 210 <term><varname>rd.udev.children-max=</varname></term>
03658d4f
LP
211 <term><varname>udev.exec-delay=</varname></term>
212 <term><varname>rd.udev.exec-delay=</varname></term>
a057be1f 213 <term><varname>net.ifnames=</varname></term>
c66e7bc7
LP
214
215 <listitem>
216 <para>Parameters understood by
217 the device event managing daemon. For
218 details see
c7a5e7cf 219 <citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
c66e7bc7
LP
220 </listitem>
221 </varlistentry>
c66e7bc7 222
66a78c2b
LP
223 <varlistentry>
224 <term><varname>plymouth.enable=</varname></term>
225
226 <listitem>
227 <para>May be used to disable
228 the Plymouth boot splash. For
229 details see
230 <citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry>
235 <term><varname>luks=</varname></term>
236 <term><varname>rd.luks=</varname></term>
237 <term><varname>luks.crypttab=</varname></term>
238 <term><varname>rd.luks.crypttab=</varname></term>
239 <term><varname>luks.uuid=</varname></term>
240 <term><varname>rd.luks.uuid=</varname></term>
951657bd
HH
241 <term><varname>luks.key=</varname></term>
242 <term><varname>rd.luks.key=</varname></term>
66a78c2b
LP
243
244 <listitem>
245 <para>Configures the LUKS
246 full-disk encryption logic at
247 boot. For details see
94734142
LP
248 <citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry>
253 <term><varname>fstab=</varname></term>
254 <term><varname>rd.fstab=</varname></term>
255
256 <listitem>
257 <para>Configures the
258 <filename>/etc/fstab</filename>
259 logic at boot. For details see
260 <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
66a78c2b
LP
261 </listitem>
262 </varlistentry>
263
03658d4f 264 <varlistentry>
627e4bb2
LP
265 <term><varname>modules-load=</varname></term>
266 <term><varname>rd.modules-load=</varname></term>
03658d4f
LP
267
268 <listitem>
269 <para>Load a specific kernel
97f4e887 270 module early at boot. For
03658d4f
LP
271 details see
272 <citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
273 </listitem>
274 </varlistentry>
275
66a78c2b 276 </variablelist>
c66e7bc7
LP
277
278 </refsect1>
279
280 <refsect1>
281 <title>See Also</title>
282 <para>
283 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
eab367b9 284 <citerefentry><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
c66e7bc7 285 <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
a32f224a 286 <citerefentry><refentrytitle>systemd-fsck@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
93a1d735 287 <citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
c66e7bc7
LP
288 <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
289 <citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
c7a5e7cf 290 <citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
2488799b 291 <citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
eab367b9
LP
292 <citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
293 <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
294 <citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
c66e7bc7
LP
295 </para>
296 </refsect1>
297
298</refentry>