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