chiark / gitweb /
bus: make sd_bus_request_name() and sd_bus_release_name() behave more like other...
[elogind.git] / man / kernel-command-line.xml
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>
47                 <refpurpose>Kernel command line parameters</refpurpose>
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
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>
66
67                 <para>For command line parameters understood by the
68                 initial RAM disk, please see
69                 <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
70                 or the documentation of the specific initrd
71                 implementation of your installation.</para>
72         </refsect1>
73
74         <refsect1>
75                 <title>Core OS Command Line Arguments</title>
76
77                 <variablelist class='kernel-commandline-options'>
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>
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
96                                         to control system behavior. For details, see
97                                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
98                                 </listitem>
99                         </varlistentry>
100
101                         <varlistentry>
102                                 <term><varname>systemd.restore_state=</varname></term>
103                                 <listitem>
104                                         <para>This parameter is understood by
105                                         several system tools to control
106                                         whether or not they should restore
107                                         system state from the previous boot.
108                                         For details, see
109                                         <citerefentry><refentrytitle>systemd-backlight@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
110                                         and
111                                         <citerefentry><refentrytitle>systemd-rfkill@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
112                                         </para>
113                                 </listitem>
114                         </varlistentry>
115
116                         <varlistentry>
117                                 <term><varname>quiet</varname></term>
118                                 <listitem>
119                                         <para>Parameter understood by
120                                         both the kernel and the system
121                                         and service manager to control
122                                         console log verbosity. For
123                                         details, see
124                                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
125                                 </listitem>
126                         </varlistentry>
127
128                         <varlistentry>
129                                 <term><varname>debug</varname></term>
130                                 <listitem>
131                                         <para>Parameter understood by
132                                         both the kernel and the system
133                                         and service manager to control
134                                         console log verbosity. For
135                                         details, see
136                                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
137                                 </listitem>
138                         </varlistentry>
139
140                         <varlistentry>
141                                 <term><varname>-b</varname></term>
142                                 <term><varname>emergency</varname></term>
143                                 <term><varname>single</varname></term>
144                                 <term><varname>s</varname></term>
145                                 <term><varname>S</varname></term>
146                                 <term><varname>1</varname></term>
147                                 <term><varname>2</varname></term>
148                                 <term><varname>3</varname></term>
149                                 <term><varname>4</varname></term>
150                                 <term><varname>5</varname></term>
151                                 <listitem>
152                                         <para>Parameters understood by
153                                         the system and service
154                                         manager, as compatibility
155                                         options. For details, see
156                                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
157                                 </listitem>
158                         </varlistentry>
159
160                         <varlistentry>
161                                 <term><varname>locale.LANG=</varname></term>
162                                 <term><varname>locale.LANGUAGE=</varname></term>
163                                 <term><varname>locale.LC_CTYPE=</varname></term>
164                                 <term><varname>locale.LC_NUMERIC=</varname></term>
165                                 <term><varname>locale.LC_TIME=</varname></term>
166                                 <term><varname>locale.LC_COLLATE=</varname></term>
167                                 <term><varname>locale.LC_MONETARY=</varname></term>
168                                 <term><varname>locale.LC_MESSAGES=</varname></term>
169                                 <term><varname>locale.LC_PAPER=</varname></term>
170                                 <term><varname>locale.LC_NAME=</varname></term>
171                                 <term><varname>locale.LC_ADDRESS=</varname></term>
172                                 <term><varname>locale.LC_TELEPHONE=</varname></term>
173                                 <term><varname>locale.LC_MEASUREMENT=</varname></term>
174                                 <term><varname>locale.LC_IDENTIFICATION=</varname></term>
175                                 <listitem>
176                                         <para>Parameters understood by
177                                         the system and service manager
178                                         to control locale and language
179                                         settings. For details, see
180                                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
181                                 </listitem>
182                         </varlistentry>
183
184                         <varlistentry>
185                                 <term><varname>fsck.mode=</varname></term>
186
187                                 <listitem>
188                                         <para>Parameter understood by
189                                         the file system checker
190                                         services. For details, see
191                                         <citerefentry><refentrytitle>systemd-fsck@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
192                                 </listitem>
193                         </varlistentry>
194
195                         <varlistentry>
196                                 <term><varname>quotacheck.mode=</varname></term>
197
198                                 <listitem>
199                                         <para>Parameter understood by
200                                         the file quota checker
201                                         service. For details, see
202                                         <citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
203                                 </listitem>
204                         </varlistentry>
205
206                         <varlistentry>
207                                 <term><varname>systemd.journald.forward_to_syslog=</varname></term>
208                                 <term><varname>systemd.journald.forward_to_kmsg=</varname></term>
209                                 <term><varname>systemd.journald.forward_to_console=</varname></term>
210
211                                 <listitem>
212                                         <para>Parameters understood by
213                                         the journal service. For
214                                         details, see
215                                         <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
216                                 </listitem>
217                         </varlistentry>
218
219                         <varlistentry>
220                                 <term><varname>vconsole.keymap=</varname></term>
221                                 <term><varname>vconsole.keymap.toggle=</varname></term>
222                                 <term><varname>vconsole.font=</varname></term>
223                                 <term><varname>vconsole.font.map=</varname></term>
224                                 <term><varname>vconsole.font.unimap=</varname></term>
225
226                                 <listitem>
227                                         <para>Parameters understood by
228                                         the virtual console setup logic. For
229                                         details, see
230                                         <citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
231                                 </listitem>
232                         </varlistentry>
233
234                         <varlistentry>
235                                 <term><varname>udev.log-priority=</varname></term>
236                                 <term><varname>rd.udev.log-priority=</varname></term>
237                                 <term><varname>udev.children-max=</varname></term>
238                                 <term><varname>rd.udev.children-max=</varname></term>
239                                 <term><varname>udev.exec-delay=</varname></term>
240                                 <term><varname>rd.udev.exec-delay=</varname></term>
241                                 <term><varname>net.ifnames=</varname></term>
242
243                                 <listitem>
244                                         <para>Parameters understood by
245                                         the device event managing daemon. For
246                                         details, see
247                                         <citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
248                                 </listitem>
249                         </varlistentry>
250
251                         <varlistentry>
252                                 <term><varname>plymouth.enable=</varname></term>
253
254                                 <listitem>
255                                         <para>May be used to disable
256                                         the Plymouth boot splash. For
257                                         details, see
258                                         <citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
259                                 </listitem>
260                         </varlistentry>
261
262                         <varlistentry>
263                                 <term><varname>luks=</varname></term>
264                                 <term><varname>rd.luks=</varname></term>
265                                 <term><varname>luks.crypttab=</varname></term>
266                                 <term><varname>rd.luks.crypttab=</varname></term>
267                                 <term><varname>luks.uuid=</varname></term>
268                                 <term><varname>rd.luks.uuid=</varname></term>
269                                 <term><varname>luks.options=</varname></term>
270                                 <term><varname>rd.luks.options=</varname></term>
271                                 <term><varname>luks.key=</varname></term>
272                                 <term><varname>rd.luks.key=</varname></term>
273
274                                 <listitem>
275                                         <para>Configures the LUKS
276                                         full-disk encryption logic at
277                                         boot. For details, see
278                                         <citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
279                                 </listitem>
280                         </varlistentry>
281
282                         <varlistentry>
283                                 <term><varname>fstab=</varname></term>
284                                 <term><varname>rd.fstab=</varname></term>
285
286                                 <listitem>
287                                         <para>Configures the
288                                         <filename>/etc/fstab</filename>
289                                         logic at boot. For details, see
290                                         <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
291                                 </listitem>
292                         </varlistentry>
293
294                         <varlistentry>
295                                 <term><varname>modules-load=</varname></term>
296                                 <term><varname>rd.modules-load=</varname></term>
297
298                                 <listitem>
299                                         <para>Load a specific kernel
300                                         module early at boot. For
301                                         details, see
302                                         <citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
303                                 </listitem>
304                         </varlistentry>
305
306                 </variablelist>
307
308         </refsect1>
309
310         <refsect1>
311                   <title>See Also</title>
312                   <para>
313                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
314                           <citerefentry><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
315                           <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
316                           <citerefentry><refentrytitle>systemd-fsck@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
317                           <citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
318                           <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
319                           <citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
320                           <citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
321                           <citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
322                           <citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
323                           <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
324                           <citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
325                           <citerefentry><refentrytitle>systemd-backlight@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
326                           <citerefentry><refentrytitle>systemd-rfkill@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
327                   </para>
328         </refsect1>
329
330 </refentry>