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