1<?xml version='1.0'?> <!--*-nxml-*-->
2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
5
6<refentry id="telinit" conditional='HAVE_SYSV_COMPAT'
7    xmlns:xi="http://www.w3.org/2001/XInclude">
8
9  <refentryinfo>
10    <title>telinit</title>
11    <productname>systemd</productname>
12  </refentryinfo>
13
14  <refmeta>
15    <refentrytitle>telinit</refentrytitle>
16    <manvolnum>8</manvolnum>
17  </refmeta>
18
19  <refnamediv>
20    <refname>telinit</refname>
21    <refpurpose>Change SysV runlevel</refpurpose>
22  </refnamediv>
23
24  <refsynopsisdiv>
25    <cmdsynopsis>
26      <command>telinit <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
27    </cmdsynopsis>
28  </refsynopsisdiv>
29
30  <refsect1>
31    <title>Description</title>
32
33    <para><command>telinit</command> may be used to change the SysV
34    system runlevel. Since the concept of SysV runlevels is obsolete
35    the runlevel requests will be transparently translated into
36    systemd unit activation requests.</para>
37
38  </refsect1>
39
40  <refsect1>
41    <title>Options</title>
42
43    <para>The following options are understood:</para>
44
45    <variablelist>
46      <varlistentry>
47        <term><option>--help</option></term>
48
49        <xi:include href="standard-options.xml" xpointer="help-text" />
50      </varlistentry>
51
52      <varlistentry>
53        <term><option>--no-wall</option></term>
54
55        <listitem><para>Do not send wall message before
56        reboot/halt/power-off.</para></listitem>
57      </varlistentry>
58    </variablelist>
59
60    <para>The following commands are understood:</para>
61
62    <variablelist>
63      <varlistentry>
64        <term><command>0</command></term>
65
66        <listitem><para>Power-off the machine. This is translated into
67        an activation request for <filename>poweroff.target</filename>
68        and is equivalent to <command>systemctl
69        poweroff</command>.</para></listitem>
70      </varlistentry>
71
72      <varlistentry>
73        <term><command>6</command></term>
74
75        <listitem><para>Reboot the machine. This is translated into an
76        activation request for <filename>reboot.target</filename> and
77        is equivalent to <command>systemctl
78        reboot</command>.</para></listitem>
79      </varlistentry>
80
81      <varlistentry>
82        <term><command>2</command></term>
83        <term><command>3</command></term>
84        <term><command>4</command></term>
85        <term><command>5</command></term>
86
87        <listitem><para>Change the SysV runlevel. This is translated
88        into an activation request for
89        <filename>runlevel2.target</filename>,
90        <filename>runlevel3.target</filename>, … and is equivalent
91        to <command>systemctl isolate runlevel2.target</command>,
92        <command>systemctl isolate runlevel3.target</command>,
93        …</para></listitem>
94      </varlistentry>
95
96      <varlistentry>
97        <term><command>1</command></term>
98        <term><command>s</command></term>
99        <term><command>S</command></term>
100
101        <listitem><para>Change into system rescue mode. This is
102        translated into an activation request for
103        <filename>rescue.target</filename> and is equivalent to
104        <command>systemctl rescue</command>.</para></listitem>
105      </varlistentry>
106
107      <varlistentry>
108        <term><command>q</command></term>
109        <term><command>Q</command></term>
110
111        <listitem><para>Reload daemon configuration. This is
112        equivalent to <command>systemctl
113        daemon-reload</command>.</para></listitem>
114      </varlistentry>
115
116      <varlistentry>
117        <term><command>u</command></term>
118        <term><command>U</command></term>
119
120        <listitem><para>Serialize state, reexecute daemon and
121        deserialize state again. This is equivalent to
122        <command>systemctl daemon-reexec</command>.</para></listitem>
123      </varlistentry>
124
125    </variablelist>
126  </refsect1>
127
128  <refsect1>
129    <title>Exit status</title>
130
131    <para>On success, 0 is returned, a non-zero failure
132    code otherwise.</para>
133  </refsect1>
134
135  <refsect1>
136    <title>Notes</title>
137
138    <para>This is a legacy command available for compatibility only.
139    It should not be used anymore, as the concept of runlevels is
140    obsolete.</para>
141  </refsect1>
142
143  <refsect1>
144    <title>See Also</title>
145    <para>
146      <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
147      <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
148      <citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
149    </para>
150  </refsect1>
151</refentry>
152