chiark / gitweb /
systemctl: add --sysv-compat
[elogind.git] / man / telinit.xml
1 <?xml version='1.0'?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3         "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
5 <!--
6   This file is part of systemd.
7
8   Copyright 2010 Lennart Poettering
9
10   systemd is free software; you can redistribute it and/or modify it
11   under the terms of the GNU General Public License as published by
12   the Free Software Foundation; either version 2 of the License, or
13   (at your option) any later version.
14
15   systemd is distributed in the hope that it will be useful, but
16   WITHOUT ANY WARRANTY; without even the implied warranty of
17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18   General Public License for more details.
19
20   You should have received a copy of the GNU General Public License
21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 -->
23
24 <refentry id="telinit">
25
26         <refentryinfo>
27                 <title>telinit</title>
28                 <productname>systemd</productname>
29
30                 <authorgroup>
31                         <author>
32                                 <contrib>Developer</contrib>
33                                 <firstname>Lennart</firstname>
34                                 <surname>Poettering</surname>
35                                 <email>lennart@poettering.net</email>
36                         </author>
37                 </authorgroup>
38         </refentryinfo>
39
40         <refmeta>
41                 <refentrytitle>telinit</refentrytitle>
42                 <manvolnum>8</manvolnum>
43         </refmeta>
44
45         <refnamediv>
46                 <refname>telinit</refname>
47                 <refpurpose>Change SysV runlevel</refpurpose>
48         </refnamediv>
49
50         <refsynopsisdiv>
51                 <cmdsynopsis>
52                         <command>telinit <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
53                 </cmdsynopsis>
54         </refsynopsisdiv>
55
56         <refsect1>
57                 <title>Description</title>
58
59                 <para><command>telinit</command> may be used to change
60                 the SysV system runlevel. Since the concept of SysV
61                 runlevels is obsolete the runlevel requests
62                 will be transparently translated into systemd unit
63                 activation requests.</para>
64
65         </refsect1>
66
67         <refsect1>
68                 <title>Options</title>
69
70                 <para>The following options are understood:</para>
71
72                 <variablelist>
73                         <varlistentry>
74                                 <term><option>--help</option></term>
75
76                                 <listitem><para>Prints a short help
77                                 text and exits.</para></listitem>
78                         </varlistentry>
79
80                         <varlistentry>
81                                 <term><option>--no-wall</option></term>
82
83                                 <listitem><para>Don't send wall
84                                 message before
85                                 reboot/halt/power-off.</para></listitem>
86                         </varlistentry>
87                 </variablelist>
88
89                 <para>The following commands are understood:</para>
90
91                 <variablelist>
92                         <varlistentry>
93                                 <term><command>0</command></term>
94
95                                 <listitem><para>Power-off the
96                                 machine. This is translated into an
97                                 activation request for
98                                 <filename>poweroff.target</filename>
99                                 and is equivalent to
100                                 <command>systemctl
101                                 poweroff</command>.</para></listitem>
102                         </varlistentry>
103
104                         <varlistentry>
105                                 <term><command>6</command></term>
106
107                                 <listitem><para>Reboot the
108                                 machine. This is translated into an
109                                 activation request for
110                                 <filename>reboot.target</filename> and
111                                 is equivalent to <command>systemctl
112                                 reboot</command>.</para></listitem>
113                         </varlistentry>
114
115                         <varlistentry>
116                                 <term><command>2</command></term>
117                                 <term><command>3</command></term>
118                                 <term><command>4</command></term>
119                                 <term><command>5</command></term>
120
121                                 <listitem><para>Change the SysV
122                                 runlevel. This is translated into an
123                                 activation request for
124                                 <filename>runlevel2.target</filename>,
125                                 <filename>runlevel3.target</filename>,
126                                 ... and is equivalent to
127                                 <command>systemctl isolate
128                                 runlevel2.target</command>,
129                                 <command>systemctl isolate
130                                 runlevel3.target</command>,
131                                 ...</para></listitem>
132                         </varlistentry>
133
134                         <varlistentry>
135                                 <term><command>1</command></term>
136                                 <term><command>s</command></term>
137                                 <term><command>S</command></term>
138
139                                 <listitem><para>Change into system
140                                 rescue mode. This is translated into
141                                 an activation request for
142                                 <filename>rescue.target</filename> and
143                                 is equivalent to <command>systemctl
144                                 rescue</command>.</para></listitem>
145                         </varlistentry>
146
147                         <varlistentry>
148                                 <term><command>q</command></term>
149                                 <term><command>Q</command></term>
150
151                                 <listitem><para>Reload daemon
152                                 configuration. This is equivalent to
153                                 <command>systemctl
154                                 daemon-reload</command>.</para></listitem>
155                         </varlistentry>
156
157                         <varlistentry>
158                                 <term><command>u</command></term>
159                                 <term><command>U</command></term>
160
161                                 <listitem><para>Serialize state,
162                                 reexecute daemon and deserialize state
163                                 again. This is equivalent to
164                                 <command>systemctl
165                                 daemon-reexec</command>.</para></listitem>
166                         </varlistentry>
167
168                 </variablelist>
169         </refsect1>
170
171         <refsect1>
172                 <title>Exit status</title>
173
174                 <para>On success 0 is returned, a non-zero failure
175                 code otherwise.</para>
176         </refsect1>
177
178         <refsect1>
179                 <title>Notes</title>
180
181                 <para>This is a legacy command available for compatibility
182                 only. It should not be used anymore, as the concept of
183                 runlevels is obsolete.</para>
184         </refsect1>
185
186         <refsect1>
187                 <title>See Also</title>
188                 <para>
189                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
190                         <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
191                         <citerefentry><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
192                 </para>
193         </refsect1>
194
195 </refentry>