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   systemd is free software; you can redistribute it and/or modify it
  13   under the terms of the GNU Lesser General Public License as published by
  14   the Free Software Foundation; either version 2.1 of the License, or
  15   (at your option) any later version.
  16
  17   systemd is distributed in the hope that it will be useful, but
  18   WITHOUT ANY WARRANTY; without even the implied warranty of
  19   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  20   Lesser General Public License for more details.
  21
  22   You should have received a copy of the GNU Lesser General Public License
  23   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  24 -->
  25
  26 <refentry id="telinit"
  27     xmlns:xi="http://www.w3.org/2001/XInclude">
  28
  29   <refentryinfo>
  30     <title>telinit</title>
  31     <productname>systemd</productname>
  32
  33     <authorgroup>
  34       <author>
  35         <contrib>Developer</contrib>
  36         <firstname>Lennart</firstname>
  37         <surname>Poettering</surname>
  38         <email>lennart@poettering.net</email>
  39       </author>
  40     </authorgroup>
  41   </refentryinfo>
  42
  43   <refmeta>
  44     <refentrytitle>telinit</refentrytitle>
  45     <manvolnum>8</manvolnum>
  46   </refmeta>
  47
  48   <refnamediv>
  49     <refname>telinit</refname>
  50     <refpurpose>Change SysV runlevel</refpurpose>
  51   </refnamediv>
  52
  53   <refsynopsisdiv>
  54     <cmdsynopsis>
  55       <command>telinit <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
  56     </cmdsynopsis>
  57   </refsynopsisdiv>
  58
  59   <refsect1>
  60     <title>Description</title>
  61
  62     <para><command>telinit</command> may be used to change the SysV
  63     system runlevel. Since the concept of SysV runlevels is obsolete
  64     the runlevel requests will be transparently translated into
  65     systemd unit activation requests.</para>
  66
  67   </refsect1>
  68
  69   <refsect1>
  70     <title>Options</title>
  71
  72     <para>The following options are understood:</para>
  73
  74     <variablelist>
  75       <varlistentry>
  76         <term><option>--help</option></term>
  77
  78         <xi:include href="standard-options.xml" xpointer="help-text" />
  79       </varlistentry>
  80
  81       <varlistentry>
  82         <term><option>--no-wall</option></term>
  83
  84         <listitem><para>Do not send wall 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 machine. This is translated into
  96         an activation request for <filename>poweroff.target</filename>
  97         and is equivalent to <command>systemctl
  98         poweroff</command>.</para></listitem>
  99       </varlistentry>
 100
 101       <varlistentry>
 102         <term><command>6</command></term>
 103
 104         <listitem><para>Reboot the machine. This is translated into an
 105         activation request for <filename>reboot.target</filename> and
 106         is equivalent to <command>systemctl
 107         reboot</command>.</para></listitem>
 108       </varlistentry>
 109
 110       <varlistentry>
 111         <term><command>2</command></term>
 112         <term><command>3</command></term>
 113         <term><command>4</command></term>
 114         <term><command>5</command></term>
 115
 116         <listitem><para>Change the SysV runlevel. This is translated
 117         into an activation request for
 118         <filename>runlevel2.target</filename>,
 119         <filename>runlevel3.target</filename>, … and is equivalent
 120         to <command>systemctl isolate runlevel2.target</command>,
 121         <command>systemctl isolate runlevel3.target</command>,
 122         …</para></listitem>
 123       </varlistentry>
 124
 125       <varlistentry>
 126         <term><command>1</command></term>
 127         <term><command>s</command></term>
 128         <term><command>S</command></term>
 129
 130         <listitem><para>Change into system rescue mode. This is
 131         translated into an activation request for
 132         <filename>rescue.target</filename> and is equivalent to
 133         <command>systemctl rescue</command>.</para></listitem>
 134       </varlistentry>
 135
 136       <varlistentry>
 137         <term><command>q</command></term>
 138         <term><command>Q</command></term>
 139
 140         <listitem><para>Reload daemon configuration. This is
 141         equivalent to <command>systemctl
 142         daemon-reload</command>.</para></listitem>
 143       </varlistentry>
 144
 145       <varlistentry>
 146         <term><command>u</command></term>
 147         <term><command>U</command></term>
 148
 149         <listitem><para>Serialize state, reexecute daemon and
 150         deserialize state again. This is equivalent to
 151         <command>systemctl daemon-reexec</command>.</para></listitem>
 152       </varlistentry>
 153
 154     </variablelist>
 155   </refsect1>
 156
 157   <refsect1>
 158     <title>Exit status</title>
 159
 160     <para>On success, 0 is returned, a non-zero failure
 161     code otherwise.</para>
 162   </refsect1>
 163
 164   <refsect1>
 165     <title>Notes</title>
 166
 167     <para>This is a legacy command available for compatibility only.
 168     It should not be used anymore, as the concept of runlevels is
 169     obsolete.</para>
 170   </refsect1>
 171
 172   <refsect1>
 173     <title>See Also</title>
 174     <para>
 175       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 176       <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 177       <citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 178     </para>
 179   </refsect1>
 180
 181 </refentry>