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 Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 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   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser 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>Do not 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>