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">
6 This file is part of systemd.
8 Copyright 2012 Lennart Poettering
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.
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.
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/>.
24 <refentry id="kernel-command-line">
27 <title>kernel-command-line</title>
28 <productname>systemd</productname>
32 <contrib>Developer</contrib>
33 <firstname>Lennart</firstname>
34 <surname>Poettering</surname>
35 <email>lennart@poettering.net</email>
41 <refentrytitle>kernel-command-line</refentrytitle>
42 <manvolnum>7</manvolnum>
46 <refname>kernel-command-line</refname>
47 <refpurpose>Kernel Command Line Parameters</refpurpose>
51 <para><filename>/proc/cmdline</filename></para>
55 <title>Description</title>
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>
61 <para>For command line parameters understood by the
62 kernel please see <ulink
63 url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>.</para>
65 <para>For command line paramaters understood by the
66 initial RAM disk, please see
67 <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
68 or the documentation of the specific initrd
69 implementation of your installation.</para>
74 <title>Core OS Command Line Arguments</title>
78 <term><varname>systemd.unit=</varname></term>
79 <term><varname>rd.systemd.unit=</varname></term>
80 <term><varname>systemd.dump_core=</varname></term>
81 <term><varname>systemd.crash_shell=</varname></term>
82 <term><varname>systemd.crash_chvt=</varname></term>
83 <term><varname>systemd.confirm_spawn=</varname></term>
84 <term><varname>systemd.show_status=</varname></term>
85 <term><varname>systemd.log_target=</varname></term>
86 <term><varname>systemd.log_level=</varname></term>
87 <term><varname>systemd.log_color=</varname></term>
88 <term><varname>systemd.log_location=</varname></term>
89 <term><varname>systemd.default_standard_output=</varname></term>
90 <term><varname>systemd.default_standard_error=</varname></term>
91 <term><varname>systemd.setenv=</varname></term>
93 <para>Parameters understood by
94 the system and service manager
95 to control system behaviour. For details see
96 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
101 <term><varname>quiet</varname></term>
103 <para>Parameter understood by
104 both the kernel and the system
105 and service manager to control
106 console log verbosity. For
108 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
113 <term><varname>emergency</varname></term>
114 <term><varname>single</varname></term>
115 <term><varname>s</varname></term>
116 <term><varname>S</varname></term>
117 <term><varname>1</varname></term>
118 <term><varname>2</varname></term>
119 <term><varname>3</varname></term>
120 <term><varname>4</varname></term>
121 <term><varname>5</varname></term>
123 <para>Parameters understood by
124 the system and service
125 manager, as compatibility
126 options. For details see
127 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
132 <term><varname>locale.LANG=</varname></term>
133 <term><varname>locale.LANGUAGE=</varname></term>
134 <term><varname>locale.LC_CTYPE=</varname></term>
135 <term><varname>locale.LC_NUMERIC=</varname></term>
136 <term><varname>locale.LC_TIME=</varname></term>
137 <term><varname>locale.LC_COLLATE=</varname></term>
138 <term><varname>locale.LC_MONETARY=</varname></term>
139 <term><varname>locale.LC_MESSAGES=</varname></term>
140 <term><varname>locale.LC_PAPER=</varname></term>
141 <term><varname>locale.LC_NAME=</varname></term>
142 <term><varname>locale.LC_ADDRESS=</varname></term>
143 <term><varname>locale.LC_TELEPHONE=</varname></term>
144 <term><varname>locale.LC_MEASUREMENT=</varname></term>
145 <term><varname>locale.LC_IDENTIFICATION=</varname></term>
147 <para>Parameters understood by
148 the system and service manager
149 to control locale and language
150 settings. For details see
151 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
156 <term><varname>fsck.mode=</varname></term>
159 <para>Parameter understood by
160 the file system checker
161 services. For details see
162 <citerefentry><refentrytitle>fsck-root.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
167 <term><varname>quotacheck.mode=</varname></term>
170 <para>Parameter understood by
171 the file quota checker
172 service. For details see
173 <citerefentry><refentrytitle>quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
178 <term><varname>systemd.journald.forward_to_syslog=</varname></term>
179 <term><varname>systemd.journald.forward_to_kmsg=</varname></term>
180 <term><varname>systemd.journald.forward_to_console=</varname></term>
183 <para>Parameters understood by
184 the journal service. For
186 <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
191 <term><varname>vconsole.keymap=</varname></term>
192 <term><varname>vconsole.keymap.toggle=</varname></term>
193 <term><varname>vconsole.font=</varname></term>
194 <term><varname>vconsole.font.map=</varname></term>
195 <term><varname>vconsole.font.unimap=</varname></term>
198 <para>Parameters understood by
199 the virtual console setup logic. For
201 <citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
206 <term><varname>udev.log-priority=</varname></term>
207 <term><varname>rd.udev.log-priority=</varname></term>
208 <term><varname>udev.children-max=</varname></term>
209 <term><varname>rd.udev.children-max=</varname></term>
210 <term><varname>udev.exec-delay=</varname></term>
211 <term><varname>rd.udev.exec-delay=</varname></term>
214 <para>Parameters understood by
215 the device event managing daemon. For
217 <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
222 <term><varname>plymouth.enable=</varname></term>
225 <para>May be used to disable
226 the Plymouth boot splash. For
228 <citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
233 <term><varname>luks=</varname></term>
234 <term><varname>rd.luks=</varname></term>
235 <term><varname>luks.crypttab=</varname></term>
236 <term><varname>rd.luks.crypttab=</varname></term>
237 <term><varname>luks.uuid=</varname></term>
238 <term><varname>rd.luks.uuid=</varname></term>
241 <para>Configures the LUKS
242 full-disk encryption logic at
243 boot. For details see
244 <citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
249 <term><varname>fstab=</varname></term>
250 <term><varname>rd.fstab=</varname></term>
254 <filename>/etc/fstab</filename>
255 logic at boot. For details see
256 <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
261 <term><varname>driver=</varname></term>
262 <term><varname>rd.driver=</varname></term>
265 <para>Load a specific kernel
266 boot early at boot. For
268 <citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
277 <title>See Also</title>
279 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
280 <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
281 <citerefentry><refentrytitle>fsck-root.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
282 <citerefentry><refentrytitle>quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
283 <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
284 <citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
285 <citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
286 <citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
287 <citerefentry><refentrytitle>cryptsetup@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>