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