telinit.xml revision 798d3a524ea57aaf40cb53858aaa45ec702f012d
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<?xml version='1.0'?> <!--*-nxml-*-->
499b34cea04a46823d003d4c0520c8b03e8513cbBrian Wellington<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff<!--
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff This file is part of systemd.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence
15a44745412679c30a6d022733925af70a38b715David Lawrence Copyright 2010 Lennart Poettering
15a44745412679c30a6d022733925af70a38b715David Lawrence
15a44745412679c30a6d022733925af70a38b715David Lawrence systemd is free software; you can redistribute it and/or modify it
15a44745412679c30a6d022733925af70a38b715David Lawrence under the terms of the GNU Lesser General Public License as published by
15a44745412679c30a6d022733925af70a38b715David Lawrence the Free Software Foundation; either version 2.1 of the License, or
15a44745412679c30a6d022733925af70a38b715David Lawrence (at your option) any later version.
15a44745412679c30a6d022733925af70a38b715David Lawrence
15a44745412679c30a6d022733925af70a38b715David Lawrence systemd is distributed in the hope that it will be useful, but
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff WITHOUT ANY WARRANTY; without even the implied warranty of
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
f3ca27e9fe307b55e35ea8d7b37351650630e5a3Andreas Gustafsson Lesser General Public License for more details.
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff You should have received a copy of the GNU Lesser General Public License
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff along with systemd; If not, see <http://www.gnu.org/licenses/>.
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff-->
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff
c803787146cadcb2d7e10cbf4491f3be513dfa1aMichael Graff<refentry id="telinit"
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff xmlns:xi="http://www.w3.org/2001/XInclude">
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <refentryinfo>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <title>telinit</title>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <productname>systemd</productname>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff <authorgroup>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff <author>
9282e3c21a20f354e22ad3f092aea4956abaea5cMichael Graff <contrib>Developer</contrib>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff <firstname>Lennart</firstname>
9282e3c21a20f354e22ad3f092aea4956abaea5cMichael Graff <surname>Poettering</surname>
294802790e8030f1c19b6c2c5d5204b6f464c729Michael Graff <email>lennart@poettering.net</email>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff </author>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff </authorgroup>
058eeac2105c39e7cb31fb75ee0b473717ec3bbcMark Andrews </refentryinfo>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence
3024dbecbac365171bc6de0f3fa04951d6558be3Michael Graff <refmeta>
5fca48054b5e791a2fa0c5015bc3b6fef4fcdce1Andreas Gustafsson <refentrytitle>telinit</refentrytitle>
f181f94ec8da8b1dbcc6353e8be965ea4a5ea282Michael Graff <manvolnum>8</manvolnum>
6028d1ce0380d0ba7f6c6ecd1ad20b31ddd1becbDavid Lawrence </refmeta>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff <refnamediv>
440be4c866f6935ac069db79a414304507a664c2Michael Graff <refname>telinit</refname>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <refpurpose>Change SysV runlevel</refpurpose>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley </refnamediv>
e45d323a2a0f4ca08d4b139546e60a5fa7bd3f0cMichael Graff
29f28fe573d4b3b318b3b026d567c1eb86738015Michael Graff <refsynopsisdiv>
86944a4c8002e80ae9b6eb5a5e29b797879be45fMichael Graff <cmdsynopsis>
21e7034ec046105c00a0dab86c83732e2e77ad99Michael Graff <command>telinit <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="req">COMMAND</arg></command>
e51511aa3281f8dc384eb1283115c7f8d5c402aeMichael Graff </cmdsynopsis>
e51511aa3281f8dc384eb1283115c7f8d5c402aeMichael Graff </refsynopsisdiv>
d1cbf714097e900ed1703529584d3e1a50e8a4a8Brian Wellington
11efdeb076d65fa9f0c5fc067dc040e7c99dfba6Michael Graff <refsect1>
09f22ac5b09e70bc526015f37168ba33e21ea91fDavid Lawrence <title>Description</title>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence <para><command>telinit</command> may be used to change the SysV
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff system runlevel. Since the concept of SysV runlevels is obsolete
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence the runlevel requests will be transparently translated into
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff systemd unit activation requests.</para>
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff </refsect1>
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff <refsect1>
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence <title>Options</title>
31fab17bcdbe302592a6c0dc5374ef56333ee879Michael Graff
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence <para>The following options are understood:</para>
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff
92ef1a9b9dbd48ecb507b42ac62c15afefdaf838David Lawrence <variablelist>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley <varlistentry>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <term><option>--help</option></term>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <xi:include href="standard-options.xml" xpointer="help-text" />
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley </varlistentry>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <varlistentry>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <term><option>--no-wall</option></term>
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <listitem><para>Do not send wall message before
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff reboot/halt/power-off.</para></listitem>
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff </varlistentry>
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff </variablelist>
d947011dc393d9f9988d1349d585b246d19cc3c7Michael Graff
3115cd89bc1e1fd3ecc4705d253e3484a3f5c555Michael Graff <para>The following commands are understood:</para>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley
a14eb88840e06b8d458c1556e5452b6d2a50012eMichael Graff <variablelist>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <varlistentry>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <term><command>0</command></term>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington <listitem><para>Power-off the machine. This is translated into
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley an activation request for <filename>poweroff.target</filename>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington and is equivalent to <command>systemctl
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington poweroff</command>.</para></listitem>
7b5172166d816efabcdb22519b136ba124bb2619Brian Wellington </varlistentry>
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff
acafce24bbc6140464302fb18c729791f1bfddd6Michael Graff <varlistentry>
acafce24bbc6140464302fb18c729791f1bfddd6Michael Graff <term><command>6</command></term>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff
64828244e04e86dfa40f0a4f0c05f27923da499dMichael Graff <listitem><para>Reboot the machine. This is translated into an
64828244e04e86dfa40f0a4f0c05f27923da499dMichael Graff activation request for <filename>reboot.target</filename> and
081cff0c33514a5dc63ab794fc199c07377ab756Mark Andrews is equivalent to <command>systemctl
081cff0c33514a5dc63ab794fc199c07377ab756Mark Andrews reboot</command>.</para></listitem>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff </varlistentry>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
ff9bb3fc5453bbf310b67c560fbf04a5c0fb60daMichael Graff <varlistentry>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <term><command>2</command></term>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <term><command>3</command></term>
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff <term><command>4</command></term>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley <term><command>5</command></term>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff <listitem><para>Change the SysV runlevel. This is translated
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff into an activation request for
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <filename>runlevel2.target</filename>,
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <filename>runlevel3.target</filename>, ... and is equivalent
78bf1ca89505820ed7b03be4bf0c0b53b557f3cdAndreas Gustafsson to <command>systemctl isolate runlevel2.target</command>,
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <command>systemctl isolate runlevel3.target</command>,
439c0011e642fb1d26011116144af698125262dbMichael Graff ...</para></listitem>
11efdeb076d65fa9f0c5fc067dc040e7c99dfba6Michael Graff </varlistentry>
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff
11efdeb076d65fa9f0c5fc067dc040e7c99dfba6Michael Graff <varlistentry>
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff <term><command>1</command></term>
081cff0c33514a5dc63ab794fc199c07377ab756Mark Andrews <term><command>s</command></term>
84c46a7acb961cac19c0d857bfdd00f3383a9bc6Michael Graff <term><command>S</command></term>
3ac63b472022ff92691d1fe69ac715a729671965Michael Graff
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley <listitem><para>Change into system rescue mode. This is
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff translated into an activation request for
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff <filename>rescue.target</filename> and is equivalent to
30251e07d1705d1a85b0e1d5a969496e1aed612eMichael Graff <command>systemctl rescue</command>.</para></listitem>
e51511aa3281f8dc384eb1283115c7f8d5c402aeMichael Graff </varlistentry>
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <varlistentry>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <term><command>q</command></term>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <term><command>Q</command></term>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
2992344aacdb08e4af936c176d49ef789f5673ddMichael Graff <listitem><para>Reload daemon configuration. This is
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff equivalent to <command>systemctl
bb143613cf26e0f27dfd9caf1a7336065d064b26Michael Graff daemon-reload</command>.</para></listitem>
fe14eafefa91fada7cea0a55b09196c01477406cBob Halley </varlistentry>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff <varlistentry>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff <term><command>u</command></term>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <term><command>U</command></term>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff <listitem><para>Serialize state, reexecute daemon and
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff deserialize state again. This is equivalent to
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff <command>systemctl daemon-reexec</command>.</para></listitem>
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff </varlistentry>
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff </variablelist>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff </refsect1>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <refsect1>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <title>Exit status</title>
213973a334f92d4aef4ef62b4538fc2e4d0e8082Michael Graff
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff <para>On success, 0 is returned, a non-zero failure
6dde125c2f47617ceef1518cf9e5588e8f366b71Michael Graff code otherwise.</para>
784d78b831830bf7b53507e742254f9c49295752Andreas Gustafsson </refsect1>
a44c12b332b867f29631e235eb11d1263c73d6c0Bob Halley
59c049874bbef182857c57bd9cca292898921c69Bob Halley <refsect1>
59c049874bbef182857c57bd9cca292898921c69Bob Halley <title>Notes</title>
59c049874bbef182857c57bd9cca292898921c69Bob Halley
59c049874bbef182857c57bd9cca292898921c69Bob Halley <para>This is a legacy command available for compatibility only.
59c049874bbef182857c57bd9cca292898921c69Bob Halley It should not be used anymore, as the concept of runlevels is
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff obsolete.</para>
66bd3b3c6b171271c705b897823dcdcf29464698Michael Graff </refsect1>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <refsect1>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <title>See Also</title>
8cdfd17426179ae6f629a9b7475d46a22f535047Bob Halley <para>
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
11fcc67616fac1bc6a28b3d4fed24641137888e7Michael Graff <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
ad3a5c4b7e21af04d1b872f933c2e19e5c0a135bMichael Graff <citerefentry project='man-pages'><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>
1c3bc66ada38236cc81c41b7174a9f0a872c9ab6Michael Graff </para>
1f90c108282533a23b8362c34bcde4267c1eb4b1Michael Graff </refsect1>
4281fe4a80af7402613f0d5c3eeff8829a4ede1fMichael Graff
ebdd11e84734e28ddd64562e82a7c646a58a04f4Michael Graff</refentry>
16508d9185e5eb96af2ebe900a08c46a6e5eb7edBob Halley