Systemd/man/telinit.xml
Lennart Poettering 5430f7f2bc relicense to LGPLv2.1 (with exceptions)
We finally got the OK from all contributors with non-trivial commits to
relicense systemd from GPL2+ to LGPL2.1+.

Some udev bits continue to be GPL2+ for now, but we are looking into
relicensing them too, to allow free copy/paste of all code within
systemd.

The bits that used to be MIT continue to be MIT.

The big benefit of the relicensing is that closed source code may now
link against libsystemd-login.so and friends.
2012-04-12 00:24:39 +02:00

196 lines
7.9 KiB
XML

<?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 2010 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://www.gnu.org/licenses/>.
-->
<refentry id="telinit">
<refentryinfo>
<title>telinit</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>telinit</refentrytitle>
<manvolnum>8</manvolnum>
</refmeta>
<refnamediv>
<refname>telinit</refname>
<refpurpose>Change SysV runlevel</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>telinit <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para><command>telinit</command> may be used to change
the SysV system runlevel. Since the concept of SysV
runlevels is obsolete the runlevel requests
will be transparently translated into systemd unit
activation requests.</para>
</refsect1>
<refsect1>
<title>Options</title>
<para>The following options are understood:</para>
<variablelist>
<varlistentry>
<term><option>--help</option></term>
<listitem><para>Prints a short help
text and exits.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--no-wall</option></term>
<listitem><para>Don't send wall
message before
reboot/halt/power-off.</para></listitem>
</varlistentry>
</variablelist>
<para>The following commands are understood:</para>
<variablelist>
<varlistentry>
<term><command>0</command></term>
<listitem><para>Power-off the
machine. This is translated into an
activation request for
<filename>poweroff.target</filename>
and is equivalent to
<command>systemctl
poweroff</command>.</para></listitem>
</varlistentry>
<varlistentry>
<term><command>6</command></term>
<listitem><para>Reboot the
machine. This is translated into an
activation request for
<filename>reboot.target</filename> and
is equivalent to <command>systemctl
reboot</command>.</para></listitem>
</varlistentry>
<varlistentry>
<term><command>2</command></term>
<term><command>3</command></term>
<term><command>4</command></term>
<term><command>5</command></term>
<listitem><para>Change the SysV
runlevel. This is translated into an
activation request for
<filename>runlevel2.target</filename>,
<filename>runlevel3.target</filename>,
... and is equivalent to
<command>systemctl isolate
runlevel2.target</command>,
<command>systemctl isolate
runlevel3.target</command>,
...</para></listitem>
</varlistentry>
<varlistentry>
<term><command>1</command></term>
<term><command>s</command></term>
<term><command>S</command></term>
<listitem><para>Change into system
rescue mode. This is translated into
an activation request for
<filename>rescue.target</filename> and
is equivalent to <command>systemctl
rescue</command>.</para></listitem>
</varlistentry>
<varlistentry>
<term><command>q</command></term>
<term><command>Q</command></term>
<listitem><para>Reload daemon
configuration. This is equivalent to
<command>systemctl
daemon-reload</command>.</para></listitem>
</varlistentry>
<varlistentry>
<term><command>u</command></term>
<term><command>U</command></term>
<listitem><para>Serialize state,
reexecute daemon and deserialize state
again. This is equivalent to
<command>systemctl
daemon-reexec</command>.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Exit status</title>
<para>On success 0 is returned, a non-zero failure
code otherwise.</para>
</refsect1>
<refsect1>
<title>Notes</title>
<para>This is a legacy command available for compatibility
only. It should not be used anymore, as the concept of
runlevels is obsolete.</para>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>