359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering This file is part of systemd.
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering Copyright 2010 Lennart Poettering
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering systemd is free software; you can redistribute it and/or modify it
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering under the terms of the GNU Lesser General Public License as published by
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering the Free Software Foundation; either version 2.1 of the License, or
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering (at your option) any later version.
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering systemd is distributed in the hope that it will be useful, but
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Lesser General Public License for more details.
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering You should have received a copy of the GNU Lesser General Public License
359957ee23e8dad97f6c75969d7ecfe4d3c4369fLennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek xmlns:xi="http://www.w3.org/2001/XInclude"
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek conditional="HAVE_UTMP">
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <email>lennart@poettering.net</email>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>runlevel</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Print previous and current SysV runlevel</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <arg choice="opt" rep="repeat">options</arg>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <para>"Runlevels" are an obsolete way to start and stop groups of
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek services used in SysV init. systemd provides a compatibility layer
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek that maps runlevels to targets, and associated binaries like
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <command>runlevel</command>. Nevertheless, only one runlevel can
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek be "active" at a given time, while systemd can activate multiple
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek targets concurrently, so the mapping to runlevels is confusing
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek and only approximate. Runlevels should not be used in new code,
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek and are mostly useful as a shorthand way to refer the matching
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek systemd targets in kernel boot parameters.</para>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <title>Mapping between runlevels and systemd targets</title>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <tgroup cols='2' align='left' colsep='1' rowsep='1'>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <entry><filename>poweroff.target</filename></entry>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <entry><filename>rescue.target</filename></entry>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <entry><filename>multi-user.target</filename></entry>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <entry><filename>graphical.target</filename></entry>
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <entry><filename>reboot.target</filename></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><command>runlevel</command> prints the previous and current
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek SysV runlevel if they are known.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The two runlevel characters are separated by a single space
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek character. If a runlevel cannot be determined, N is printed
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek instead. If neither can be determined, the word "unknown" is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Unless overridden in the environment, this will check the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek utmp database for recent runlevel changes.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The following option is understood:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>--help</option></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <xi:include href="standard-options.xml" xpointer="help-text" />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>If one or both runlevels could be determined, 0 is returned,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek a non-zero failure code otherwise.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='environment-variables'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>$RUNLEVEL</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>If <varname>$RUNLEVEL</varname> is set,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <command>runlevel</command> will print this value as current
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek runlevel and ignore utmp.</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>$PREVLEVEL</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>If <varname>$PREVLEVEL</varname> is set,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <command>runlevel</command> will print this value as previous
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek runlevel and ignore utmp.</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><filename>/var/run/utmp</filename></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>The utmp database <command>runlevel</command>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek reads the previous and current runlevel
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
9f6434a675a1b855c8e7d59195a7f066b9022021Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.target</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>