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