kernel-command-line.xml revision 951657bd0a5bb32b5f56cc6b91ad2ea4094bdfaf
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering<?xml version='1.0'?> <!--*-nxml-*-->
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering<!--
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering This file is part of systemd.
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering Copyright 2012 Lennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering systemd is free software; you can redistribute it and/or modify it
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering under the terms of the GNU Lesser General Public License as published by
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering the Free Software Foundation; either version 2.1 of the License, or
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering (at your option) any later version.
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering systemd is distributed in the hope that it will be useful, but
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering Lesser General Public License for more details.
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering You should have received a copy of the GNU Lesser General Public License
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering-->
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering<refentry id="kernel-command-line">
07630cea1f3a845c09309f197ac7c4f11edd3b62Lennart Poettering
b5efdb8af40ea759a1ea584c1bc44ecc81dd00ceLennart Poettering <refentryinfo>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <title>kernel-command-line</title>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <productname>systemd</productname>
07630cea1f3a845c09309f197ac7c4f11edd3b62Lennart Poettering
07630cea1f3a845c09309f197ac7c4f11edd3b62Lennart Poettering <authorgroup>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <author>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <contrib>Developer</contrib>
3e348b8a6af4bc46562efa44500fe2fa44320aa1Ronny Chevalier <firstname>Lennart</firstname>
3e348b8a6af4bc46562efa44500fe2fa44320aa1Ronny Chevalier <surname>Poettering</surname>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <email>lennart@poettering.net</email>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </author>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </authorgroup>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </refentryinfo>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
dfd9cf7f0b257d38f5527989dd9315e767fbe41bZbigniew Jędrzejewski-Szmek <refmeta>
dfd9cf7f0b257d38f5527989dd9315e767fbe41bZbigniew Jędrzejewski-Szmek <refentrytitle>kernel-command-line</refentrytitle>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <manvolnum>7</manvolnum>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </refmeta>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <refnamediv>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <refname>kernel-command-line</refname>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <refpurpose>Kernel command line parameters</refpurpose>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </refnamediv>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <refsynopsisdiv>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <para><filename>/proc/cmdline</filename></para>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </refsynopsisdiv>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <refsect1>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <title>Description</title>
0c0cdb06c139b52ff103287f6909b3daa5b2dc54Ronny Chevalier
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <para>The kernel, the initial RAM disk (initrd) and
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering basic userspace functionality may be configured at boot via
0c0cdb06c139b52ff103287f6909b3daa5b2dc54Ronny Chevalier kernel command line arguments.</para>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <para>For command line parameters understood by the
0c0cdb06c139b52ff103287f6909b3daa5b2dc54Ronny Chevalier kernel please see <ulink
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering and
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <citerefentry><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <para>For command line parameters understood by the
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering initial RAM disk, please see
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering or the documentation of the specific initrd
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering implementation of your installation.</para>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering </refsect1>
2678031a179a9b91fc799f8ef951a548c66c4b49Lennart Poettering
dfd9cf7f0b257d38f5527989dd9315e767fbe41bZbigniew Jędrzejewski-Szmek <refsect1>
dfd9cf7f0b257d38f5527989dd9315e767fbe41bZbigniew Jędrzejewski-Szmek <title>Core OS Command Line Arguments</title>
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering
d0767ffd08bbb5c069e266710eb0462315e47e6dLennart Poettering <variablelist class='kernel-commandline-options'>
<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
to control system behavior. For details see
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>quiet</varname></term>
<listitem>
<para>Parameter understood by
both the kernel and the system
and service manager to control
console log verbosity. For
details see
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>emergency</varname></term>
<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
options. For details see
<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
settings. For details see
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>fsck.mode=</varname></term>
<listitem>
<para>Parameter understood by
the file system checker
services. For details see
<citerefentry><refentrytitle>systemd-fsck@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>quotacheck.mode=</varname></term>
<listitem>
<para>Parameter understood by
the file quota checker
service. For details see
<citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</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>
<listitem>
<para>Parameters understood by
the journal service. For
details see
<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
details see
<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>
<term><varname>udev.children-max=</varname></term>
<term><varname>rd.udev.children-max=</varname></term>
<term><varname>udev.exec-delay=</varname></term>
<term><varname>rd.udev.exec-delay=</varname></term>
<listitem>
<para>Parameters understood by
the device event managing daemon. For
details see
<citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>plymouth.enable=</varname></term>
<listitem>
<para>May be used to disable
the Plymouth boot splash. For
details see
<citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</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>
<term><varname>luks.key=</varname></term>
<term><varname>rd.luks.key=</varname></term>
<listitem>
<para>Configures the LUKS
full-disk encryption logic at
boot. For details see
<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>
logic at boot. For details see
<citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>modules-load=</varname></term>
<term><varname>rd.modules-load=</varname></term>
<listitem>
<para>Load a specific kernel
module early at boot. For
details see
<citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
<citerefentry><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-fsck@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-vconsole-setup.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>plymouth</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-cryptsetup-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-modules-load.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>