kernel-command-line.xml revision d2c68822c47e37b582820f45b496b2e7d1f9e642
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend<?xml version='1.0'?> <!--*-nxml-*-->
2d0611ffc9f91c5fc2ddccb93f9a3d17791ae650takashi<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend<!--
7ec4d5cc4aa574e3191bc5a612e68fd8f25ab7earpluem This file is part of systemd.
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend Copyright 2012 Lennart Poettering
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend systemd is free software; you can redistribute it and/or modify it
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend under the terms of the GNU Lesser General Public License as published by
d9b843d090f14405079b4a61a493316cd3f1e5b9minfrin the Free Software Foundation; either version 2.1 of the License, or
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend (at your option) any later version.
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes
909ce17e2bd0faef7b1c294f2307f009793fd493nd systemd is distributed in the hope that it will be useful, but
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend WITHOUT ANY WARRANTY; without even the implied warranty of
0ce5630695a7aa568811a9dd0aceedd685f040dend MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
a29610af88e278144045bfa1bc63b4a1a4b5ff14trawick Lesser General Public License for more details.
42af92a661a06b3cebc88d585aad75064a309d51nd
367d146f245f3b1c9f77c18e6ec591b52e0b344cbnicholes You should have received a copy of the GNU Lesser General Public License
6fe26506780e73be2a412d758af77fafdf03291and along with systemd; If not, see <http://www.gnu.org/licenses/>.
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend-->
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend<refentry id="kernel-command-line">
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refentryinfo>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <title>kernel-command-line</title>
43f6cc6aa3312619633538b8978619a48c0ce52eminfrin <productname>systemd</productname>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <authorgroup>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <author>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <contrib>Developer</contrib>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <firstname>Lennart</firstname>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <surname>Poettering</surname>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <email>lennart@poettering.net</email>
05ede5110427cb9dc071cc671d5aaba5d3b88c79nd </author>
e8b603fa9ccf7b17b11b42df6d8916fd97c2331dnd </authorgroup>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend </refentryinfo>
2f39535ac2206b346dcfbcaf271e3addc901f520rbowen
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refmeta>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refentrytitle>kernel-command-line</refentrytitle>
d6ce05b6521a82cc93da69f7c2116c4a5bc54f8cjim <manvolnum>7</manvolnum>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend </refmeta>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refnamediv>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refname>kernel-command-line</refname>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refpurpose>Kernel command line parameters</refpurpose>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend </refnamediv>
03a4ff9ac4c9b8009249010e7c53bb86ff05915and
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <refsynopsisdiv>
1e367a83311e5243e04d68857d007d04765a48f9chrisd <para><filename>/proc/cmdline</filename></para>
1e367a83311e5243e04d68857d007d04765a48f9chrisd </refsynopsisdiv>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
7d15331eeb5429d7148d13d6fd914a641bf1c000pquerna <refsect1>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <title>Description</title>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <para>The kernel, the initial RAM disk (initrd) and
2704de98885368683621b01c8f8f4e4b01557611takashi basic userspace functionality may be configured at boot via
2704de98885368683621b01c8f8f4e4b01557611takashi kernel command line arguments.</para>
2704de98885368683621b01c8f8f4e4b01557611takashi
1e367a83311e5243e04d68857d007d04765a48f9chrisd <para>For command line parameters understood by the
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend kernel, please see <ulink
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
d2b809e5d72658bff23819d8b77f20e4939af541nd and
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <citerefentry project='man-pages'><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
fb51a6b789d85113d0976148685b0063c294220drbowen
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <para>For command line parameters understood by the
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend initial RAM disk, please see
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <citerefentry project='die-net'><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend or the documentation of the specific initrd
27d778df0b517e1578f907d2e51eb961cd8ee5fbjim implementation of your installation.</para>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend </refsect1>
6b0fe1f447ba35827cd5cf1d2a703bd8517f33ffmturk
6b0fe1f447ba35827cd5cf1d2a703bd8517f33ffmturk <refsect1>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <title>Core OS Command Line Arguments</title>
e5ce3ac0e9b720c0fa23782e29168a0810697fdetakashi
f73390048b37c973a8016ffd22108d7a73c6cc22pquerna <variablelist class='kernel-commandline-options'>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <varlistentry>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <term><varname>systemd.unit=</varname></term>
0a69d9bb491d9810892a9949c01403a1de3c7ac2nd <term><varname>rd.systemd.unit=</varname></term>
ebdfe3e677aaa92fe2df702295eac81a97a4610frbowen <term><varname>systemd.dump_core=</varname></term>
68c4447ba8e057cf38cbbec918e0549b817f20b4minfrin <term><varname>systemd.crash_shell=</varname></term>
5f4e50966b2b9b58436a1651cbe588d1b595657ewrowe <term><varname>systemd.crash_chvt=</varname></term>
5332c9934b1c0136e9cd4815fe7d70b79d83fddcsf <term><varname>systemd.confirm_spawn=</varname></term>
623eebe956d9c2d6d073ed3eae855b56030b40e9noodl <term><varname>systemd.show_status=</varname></term>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <term><varname>systemd.log_target=</varname></term>
79b024b81f6bb3c44dce77a7552191daf8b522d2jim <term><varname>systemd.log_level=</varname></term>
4277c95b5a9454a5c25f8d8762634fcff37aa840minfrin <term><varname>systemd.log_color=</varname></term>
4277c95b5a9454a5c25f8d8762634fcff37aa840minfrin <term><varname>systemd.log_location=</varname></term>
4277c95b5a9454a5c25f8d8762634fcff37aa840minfrin <term><varname>systemd.default_standard_output=</varname></term>
f195a136dcd90148b116fdae8ce95b41ba92b87eminfrin <term><varname>systemd.default_standard_error=</varname></term>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <term><varname>systemd.setenv=</varname></term>
1de1266f0ea387d6373be8415745dfd2ab876341jim <listitem>
1de1266f0ea387d6373be8415745dfd2ab876341jim <para>Parameters understood by
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend the system and service manager
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend to control system behavior. For details, see
0ce5630695a7aa568811a9dd0aceedd685f040dend <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend </listitem>
10eed2803538d660048f6e733602e82a75ef6885noodl </varlistentry>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <varlistentry>
4db28ee269aa06f7c6232e11cd01f58c3349af23noodl <term><varname>systemd.mask=</varname></term>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <term><varname>systemd.wants=</varname></term>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <term><varname>systemd.debug-shell</varname></term>
03c25fb6f628ac81f2ecb637d1e7502dcee783f3nd <listitem>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend <para>Additional parameters
0ce5630695a7aa568811a9dd0aceedd685f040dend understood by
7fa75a06a4fee19e995c069ee00310455d1452e1pquerna <citerefentry><refentrytitle>systemd-debug-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend to mask or start specific
316f02e3836836c82e19019ff23f90a7ebc65289nilgun units at boot, or invoke a
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend debug shell on tty9.</para>
0ce5630695a7aa568811a9dd0aceedd685f040dend </listitem>
0ce5630695a7aa568811a9dd0aceedd685f040dend </varlistentry>
f73f2c2fae0ded6c8273c28d025ba8aa8136a0fend
<varlistentry>
<term><varname>systemd.restore_state=</varname></term>
<listitem>
<para>This parameter is understood by
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>
<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>debug</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>-b</varname></term>
<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>
<term><varname>fsck.repair=</varname></term>
<listitem>
<para>Parameters 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>
<term><varname>systemd.journald.forward_to_wall=</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>
<term><varname>net.ifnames=</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 project='die-net'><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.options=</varname></term>
<term><varname>rd.luks.options=</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>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>
<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>
<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
pathes are supported. For details, see
<citerefentry><refentrytitle>systemd-hibernate-resume-generator</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 project='man-pages'><refentrytitle>bootparam</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
<citerefentry project='die-net'><refentrytitle>dracut.cmdline</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-debug-generator</refentrytitle><manvolnum>8</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 project='die-net'><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-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>,
<citerefentry><refentrytitle>systemd-rfkill@.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-hibernate-resume-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>