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