man/telinit.xml

   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+ -->
   5
   6 <refentry id="telinit"
   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
 152 </refentry>