2012-06-22 03:35:52 +04:00
<?xml version='1.0'?> <!-- * - nxml - * -->
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!--
This file is part of systemd.
Copyright 2012 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see <http: / / w w w . g n u . o r g / l i c e n s e s /> .
-->
<refentry id= "kernel-command-line" >
<refentryinfo >
<title > kernel-command-line</title>
<productname > systemd</productname>
<authorgroup >
<author >
<contrib > Developer</contrib>
<firstname > Lennart</firstname>
<surname > Poettering</surname>
<email > lennart@poettering.net</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta >
<refentrytitle > kernel-command-line</refentrytitle>
<manvolnum > 7</manvolnum>
</refmeta>
<refnamediv >
<refname > kernel-command-line</refname>
2012-07-16 20:08:25 +04:00
<refpurpose > Kernel command line parameters</refpurpose>
2012-06-22 03:35:52 +04:00
</refnamediv>
<refsynopsisdiv >
<para > <filename > /proc/cmdline</filename> </para>
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
<para > The kernel, the initial RAM disk (initrd) and
basic userspace functionality may be configured at boot via
kernel command line arguments.</para>
<para > For command line parameters understood by the
2013-07-02 07:44:04 +04:00
kernel, please see <ulink
2012-06-22 18:57:01 +04:00
url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename > kernel-parameters.txt</filename> </ulink>
and
man: add a mapping for external manpages
It is annoying when we have dead links on fd.o.
Add project='man-pages|die-net|archlinux' to <citerefentry>-ies.
In generated html, add external links to
http://man7.org/linux/man-pages/man, http://linux.die.net/man/,
https://www.archlinux.org/.
By default, pages in sections 2 and 4 go to man7, since Michael
Kerrisk is the autorative source on kernel related stuff.
The rest of links goes to linux.die.net, because they have the
manpages.
Except for the pacman stuff, since it seems to be only available from
archlinux.org.
Poor gummiboot gets no link, because gummitboot(8) ain't to be found
on the net. According to common wisdom, that would mean that it does
not exist. But I have seen Kay using it, so I know it does, and
deserves to be found. Can somebody be nice and put it up somewhere?
2014-07-08 02:25:54 +04:00
<citerefentry project= 'man-pages' > <refentrytitle > bootparam</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry> .</para>
2012-06-22 03:35:52 +04:00
2012-11-29 23:06:57 +04:00
<para > For command line parameters understood by the
2012-06-22 03:35:52 +04:00
initial RAM disk, please see
man: add a mapping for external manpages
It is annoying when we have dead links on fd.o.
Add project='man-pages|die-net|archlinux' to <citerefentry>-ies.
In generated html, add external links to
http://man7.org/linux/man-pages/man, http://linux.die.net/man/,
https://www.archlinux.org/.
By default, pages in sections 2 and 4 go to man7, since Michael
Kerrisk is the autorative source on kernel related stuff.
The rest of links goes to linux.die.net, because they have the
manpages.
Except for the pacman stuff, since it seems to be only available from
archlinux.org.
Poor gummiboot gets no link, because gummitboot(8) ain't to be found
on the net. According to common wisdom, that would mean that it does
not exist. But I have seen Kay using it, so I know it does, and
deserves to be found. Can somebody be nice and put it up somewhere?
2014-07-08 02:25:54 +04:00
<citerefentry project= 'die-net' > <refentrytitle > dracut.cmdline</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry> ,
2012-06-22 18:29:26 +04:00
or the documentation of the specific initrd
implementation of your installation.</para>
2012-06-22 03:35:52 +04:00
</refsect1>
<refsect1 >
<title > Core OS Command Line Arguments</title>
2013-01-26 19:47:16 +04:00
<variablelist class= 'kernel-commandline-options' >
2012-06-22 03:35:52 +04:00
<varlistentry >
<term > <varname > systemd.unit=</varname> </term>
<term > <varname > rd.systemd.unit=</varname> </term>
<term > <varname > systemd.dump_core=</varname> </term>
<term > <varname > systemd.crash_shell=</varname> </term>
<term > <varname > systemd.crash_chvt=</varname> </term>
<term > <varname > systemd.confirm_spawn=</varname> </term>
<term > <varname > systemd.show_status=</varname> </term>
<term > <varname > systemd.log_target=</varname> </term>
<term > <varname > systemd.log_level=</varname> </term>
<term > <varname > systemd.log_color=</varname> </term>
<term > <varname > systemd.log_location=</varname> </term>
<term > <varname > systemd.default_standard_output=</varname> </term>
<term > <varname > systemd.default_standard_error=</varname> </term>
<term > <varname > systemd.setenv=</varname> </term>
<listitem >
<para > Parameters understood by
the system and service manager
2013-07-02 07:44:04 +04:00
to control system behavior. For details, see
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
2014-06-19 18:54:40 +04:00
<varlistentry >
<term > <varname > systemd.mask=</varname> </term>
2014-06-20 15:30:52 +04:00
<term > <varname > systemd.wants=</varname> </term>
2014-06-19 18:54:40 +04:00
<term > <varname > systemd.debug-shell</varname> </term>
<listitem >
<para > Additional parameters
understood by
<citerefentry > <refentrytitle > systemd-debug-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2014-06-20 15:30:52 +04:00
to mask or start specific
units at boot, or invoke a
debug shell on tty9.</para>
2014-06-19 18:54:40 +04:00
</listitem>
</varlistentry>
2013-10-19 02:46:07 +04:00
<varlistentry >
<term > <varname > systemd.restore_state=</varname> </term>
<listitem >
2013-10-22 03:50:48 +04:00
<para > This parameter is understood by
2013-10-19 02:46:07 +04:00
several system tools to control
whether or not they should restore
system state from the previous boot.
For details, see
<citerefentry > <refentrytitle > systemd-backlight@.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry>
and
<citerefentry > <refentrytitle > systemd-rfkill@.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .
</para>
</listitem>
</varlistentry>
2012-06-22 03:35:52 +04:00
<varlistentry >
<term > <varname > quiet</varname> </term>
<listitem >
2012-06-22 03:38:42 +04:00
<para > Parameter understood by
2012-06-22 03:35:52 +04:00
both the kernel and the system
2013-05-29 16:09:56 +04:00
and service manager to control
console log verbosity. For
2013-07-02 07:44:04 +04:00
details, see
2013-05-29 16:09:56 +04:00
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > debug</varname> </term>
<listitem >
<para > Parameter understood by
both the kernel and the system
2012-06-22 03:35:52 +04:00
and service manager to control
console log verbosity. For
2013-07-02 07:44:04 +04:00
details, see
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
2013-10-15 10:58:50 +04:00
<term > <varname > -b</varname> </term>
2012-06-22 03:35:52 +04:00
<term > <varname > emergency</varname> </term>
2014-10-09 20:26:47 +04:00
<term > <varname > rescue</varname> </term>
2012-06-22 03:35:52 +04:00
<term > <varname > single</varname> </term>
<term > <varname > s</varname> </term>
<term > <varname > S</varname> </term>
<term > <varname > 1</varname> </term>
<term > <varname > 2</varname> </term>
<term > <varname > 3</varname> </term>
<term > <varname > 4</varname> </term>
<term > <varname > 5</varname> </term>
<listitem >
<para > Parameters understood by
the system and service
manager, as compatibility
2013-07-02 07:44:04 +04:00
options. For details, see
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > locale.LANG=</varname> </term>
<term > <varname > locale.LANGUAGE=</varname> </term>
<term > <varname > locale.LC_CTYPE=</varname> </term>
<term > <varname > locale.LC_NUMERIC=</varname> </term>
<term > <varname > locale.LC_TIME=</varname> </term>
<term > <varname > locale.LC_COLLATE=</varname> </term>
<term > <varname > locale.LC_MONETARY=</varname> </term>
<term > <varname > locale.LC_MESSAGES=</varname> </term>
<term > <varname > locale.LC_PAPER=</varname> </term>
<term > <varname > locale.LC_NAME=</varname> </term>
<term > <varname > locale.LC_ADDRESS=</varname> </term>
<term > <varname > locale.LC_TELEPHONE=</varname> </term>
<term > <varname > locale.LC_MEASUREMENT=</varname> </term>
<term > <varname > locale.LC_IDENTIFICATION=</varname> </term>
<listitem >
<para > Parameters understood by
the system and service manager
to control locale and language
2013-07-02 07:44:04 +04:00
settings. For details, see
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > fsck.mode=</varname> </term>
2014-05-15 21:07:43 +04:00
<term > <varname > fsck.repair=</varname> </term>
<listitem >
2014-06-19 18:54:40 +04:00
<para > Parameters understood by
2014-05-15 21:07:43 +04:00
the file system checker
2013-07-02 07:44:04 +04:00
services. For details, see
2012-06-27 02:37:36 +04:00
<citerefentry > <refentrytitle > systemd-fsck@.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
2012-06-22 03:35:52 +04:00
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > quotacheck.mode=</varname> </term>
<listitem >
2012-06-22 03:38:42 +04:00
<para > Parameter understood by
2012-06-22 03:35:52 +04:00
the file quota checker
2013-07-02 07:44:04 +04:00
service. For details, see
2012-06-25 15:47:45 +04:00
<citerefentry > <refentrytitle > systemd-quotacheck.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
2012-06-22 03:35:52 +04:00
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > systemd.journald.forward_to_syslog=</varname> </term>
<term > <varname > systemd.journald.forward_to_kmsg=</varname> </term>
<term > <varname > systemd.journald.forward_to_console=</varname> </term>
2014-03-14 03:38:15 +04:00
<term > <varname > systemd.journald.forward_to_wall=</varname> </term>
2012-06-22 03:35:52 +04:00
<listitem >
<para > Parameters understood by
the journal service. For
2013-07-02 07:44:04 +04:00
details, see
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd-journald.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > vconsole.keymap=</varname> </term>
<term > <varname > vconsole.keymap.toggle=</varname> </term>
<term > <varname > vconsole.font=</varname> </term>
<term > <varname > vconsole.font.map=</varname> </term>
<term > <varname > vconsole.font.unimap=</varname> </term>
<listitem >
<para > Parameters understood by
the virtual console setup logic. For
2013-07-02 07:44:04 +04:00
details, see
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd-vconsole-setup.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > udev.log-priority=</varname> </term>
<term > <varname > rd.udev.log-priority=</varname> </term>
2012-06-22 12:11:06 +04:00
<term > <varname > udev.children-max=</varname> </term>
2012-06-22 03:35:52 +04:00
<term > <varname > rd.udev.children-max=</varname> </term>
2012-06-22 13:39:04 +04:00
<term > <varname > udev.exec-delay=</varname> </term>
<term > <varname > rd.udev.exec-delay=</varname> </term>
2014-10-23 08:12:50 +04:00
<term > <varname > udev.event-timeout=</varname> </term>
<term > <varname > rd.udev.event-timeout=</varname> </term>
2013-05-23 05:11:29 +04:00
<term > <varname > net.ifnames=</varname> </term>
2012-06-22 03:35:52 +04:00
<listitem >
<para > Parameters understood by
the device event managing daemon. For
2013-07-02 07:44:04 +04:00
details, see
2012-06-22 18:57:13 +04:00
<citerefentry > <refentrytitle > systemd-udevd.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
2012-06-22 03:35:52 +04:00
</listitem>
</varlistentry>
2012-06-22 12:11:06 +04:00
<varlistentry >
<term > <varname > plymouth.enable=</varname> </term>
<listitem >
<para > May be used to disable
the Plymouth boot splash. For
2013-07-02 07:44:04 +04:00
details, see
man: add a mapping for external manpages
It is annoying when we have dead links on fd.o.
Add project='man-pages|die-net|archlinux' to <citerefentry>-ies.
In generated html, add external links to
http://man7.org/linux/man-pages/man, http://linux.die.net/man/,
https://www.archlinux.org/.
By default, pages in sections 2 and 4 go to man7, since Michael
Kerrisk is the autorative source on kernel related stuff.
The rest of links goes to linux.die.net, because they have the
manpages.
Except for the pacman stuff, since it seems to be only available from
archlinux.org.
Poor gummiboot gets no link, because gummitboot(8) ain't to be found
on the net. According to common wisdom, that would mean that it does
not exist. But I have seen Kay using it, so I know it does, and
deserves to be found. Can somebody be nice and put it up somewhere?
2014-07-08 02:25:54 +04:00
<citerefentry project= 'die-net' > <refentrytitle > plymouth</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
2012-06-22 12:11:06 +04:00
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > luks=</varname> </term>
<term > <varname > rd.luks=</varname> </term>
<term > <varname > luks.crypttab=</varname> </term>
<term > <varname > rd.luks.crypttab=</varname> </term>
<term > <varname > luks.uuid=</varname> </term>
<term > <varname > rd.luks.uuid=</varname> </term>
2013-09-13 23:03:55 +04:00
<term > <varname > luks.options=</varname> </term>
<term > <varname > rd.luks.options=</varname> </term>
2013-04-11 17:44:33 +04:00
<term > <varname > luks.key=</varname> </term>
<term > <varname > rd.luks.key=</varname> </term>
2012-06-22 12:11:06 +04:00
<listitem >
<para > Configures the LUKS
full-disk encryption logic at
2013-07-02 07:44:04 +04:00
boot. For details, see
2012-06-22 12:27:05 +04:00
<citerefentry > <refentrytitle > systemd-cryptsetup-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > fstab=</varname> </term>
<term > <varname > rd.fstab=</varname> </term>
<listitem >
<para > Configures the
<filename > /etc/fstab</filename>
2013-07-02 07:44:04 +04:00
logic at boot. For details, see
2012-06-22 12:27:05 +04:00
<citerefentry > <refentrytitle > systemd-fstab-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
2012-06-22 12:11:06 +04:00
</listitem>
</varlistentry>
2014-06-19 18:54:40 +04:00
<varlistentry >
<term > <varname > root=</varname> </term>
<term > <varname > rootfstype=</varname> </term>
<term > <varname > rootfsflags=</varname> </term>
<term > <varname > ro</varname> </term>
<term > <varname > rw</varname> </term>
<listitem >
<para > Configures the root file
system and its file system
type and mount options, as
well as whether it shall be
mounted read-only or
read-writable initially. For
details, see
<citerefentry > <refentrytitle > systemd-fstab-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
<varlistentry >
<term > <varname > systemd.gpt_auto=</varname> </term>
<term > <varname > rd.systemd.gpt_auto=</varname> </term>
<listitem >
<para > Configures whether GPT
based partition auto-discovery
shall be attempted. For
details, see
<citerefentry > <refentrytitle > systemd-gpt-auto-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
2012-06-22 13:39:04 +04:00
<varlistentry >
2012-07-04 03:12:25 +04:00
<term > <varname > modules-load=</varname> </term>
<term > <varname > rd.modules-load=</varname> </term>
2012-06-22 13:39:04 +04:00
<listitem >
<para > Load a specific kernel
2012-06-22 15:45:29 +04:00
module early at boot. For
2013-07-02 07:44:04 +04:00
details, see
2012-06-22 13:39:04 +04:00
<citerefentry > <refentrytitle > systemd-modules-load.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
2014-08-27 00:17:45 +04:00
<varlistentry >
<term > <varname > resume=</varname> </term>
<listitem >
<para > Enables resume from hibernation
using the specified device.
All <citerefentry > <refentrytitle > fstab</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> -like
2014-08-30 19:13:16 +04:00
paths are supported. For details, see
2014-08-27 00:17:45 +04:00
<citerefentry > <refentrytitle > systemd-hibernate-resume-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .</para>
</listitem>
</varlistentry>
2012-06-22 12:11:06 +04:00
</variablelist>
2012-06-22 03:35:52 +04:00
</refsect1>
<refsect1 >
<title > See Also</title>
<para >
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
man: add a mapping for external manpages
It is annoying when we have dead links on fd.o.
Add project='man-pages|die-net|archlinux' to <citerefentry>-ies.
In generated html, add external links to
http://man7.org/linux/man-pages/man, http://linux.die.net/man/,
https://www.archlinux.org/.
By default, pages in sections 2 and 4 go to man7, since Michael
Kerrisk is the autorative source on kernel related stuff.
The rest of links goes to linux.die.net, because they have the
manpages.
Except for the pacman stuff, since it seems to be only available from
archlinux.org.
Poor gummiboot gets no link, because gummitboot(8) ain't to be found
on the net. According to common wisdom, that would mean that it does
not exist. But I have seen Kay using it, so I know it does, and
deserves to be found. Can somebody be nice and put it up somewhere?
2014-07-08 02:25:54 +04:00
<citerefentry project= 'man-pages' > <refentrytitle > bootparam</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry> ,
<citerefentry project= 'die-net' > <refentrytitle > dracut.cmdline</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry> ,
2014-06-19 18:54:40 +04:00
<citerefentry > <refentrytitle > systemd-debug-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2012-06-27 02:37:36 +04:00
<citerefentry > <refentrytitle > systemd-fsck@.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2012-06-25 15:47:45 +04:00
<citerefentry > <refentrytitle > systemd-quotacheck.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2012-06-22 03:35:52 +04:00
<citerefentry > <refentrytitle > systemd-journald.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-vconsole-setup.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2012-06-22 18:57:13 +04:00
<citerefentry > <refentrytitle > systemd-udevd.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
man: add a mapping for external manpages
It is annoying when we have dead links on fd.o.
Add project='man-pages|die-net|archlinux' to <citerefentry>-ies.
In generated html, add external links to
http://man7.org/linux/man-pages/man, http://linux.die.net/man/,
https://www.archlinux.org/.
By default, pages in sections 2 and 4 go to man7, since Michael
Kerrisk is the autorative source on kernel related stuff.
The rest of links goes to linux.die.net, because they have the
manpages.
Except for the pacman stuff, since it seems to be only available from
archlinux.org.
Poor gummiboot gets no link, because gummitboot(8) ain't to be found
on the net. According to common wisdom, that would mean that it does
not exist. But I have seen Kay using it, so I know it does, and
deserves to be found. Can somebody be nice and put it up somewhere?
2014-07-08 02:25:54 +04:00
<citerefentry project= 'die-net' > <refentrytitle > plymouth</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2012-06-22 18:59:32 +04:00
<citerefentry > <refentrytitle > systemd-cryptsetup-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-fstab-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2014-06-19 18:54:40 +04:00
<citerefentry > <refentrytitle > systemd-gpt-auto-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-modules-load.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-backlight@.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
2014-08-27 00:17:45 +04:00
<citerefentry > <refentrytitle > systemd-rfkill@.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-hibernate-resume-generator</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry>
2012-06-22 03:35:52 +04:00
</para>
</refsect1>
</refentry>