telinit(8)

1telinit(8)                  System Manager's Manual                 telinit(8)
2
3
4

NAME

6       telinit - change system runlevel
7

SYNOPSIS

9       telinit [OPTION]...  RUNLEVEL
10

DESCRIPTION

12       telinit may be used to change the system runlevel.
13
14       The  RUNLEVEL argument should be one of the multi-user runlevels 2-5, 0
15       to halt the system, 6 to reboot the system or 1  to  bring  the  system
16       down into single-user mode.
17
18       Normally  you would use the shutdown(8) tool to halt or reboot the sys‐
19       tem, or to bring it down to single-user mode.
20
21       RUNLEVEL may also be S or s which will place the system  directly  into
22       single-user  mode without actually stopping processes first, you proba‐
23       bly won't want that.
24
25       The runlevel is  changed  by  emitting  the  runlevel(7)  event,  which
26       includes  the new runlevel in the RUNLEVEL environment variable as well
27       as the  previous  runlevel  (obtained  from  the  environment  or  from
28       /var/run/utmp) in the PREVLEVEL variable.
29
30       telinit  will  write the new runlevel to /var/run/utmp and append a new
31       entry to /var/log/wtmp.
32
33
34   Other commands
35       telinit may be also used to send basic commands to the  init(8)  daemon
36       for compatibility with System V.  These are:
37
38       Q or q to  request  that  init(8)  reload  its  configuration.  This is
39              rarely necessary since Upstart watches  its  configuration  with
40              inotify(7) and is deprecated by the initctl(8) reload-configura‐
41              tion command.
42
43       U or u to request that the init(8) daemon re-execute itself.   This  is
44              not  recommended  since  Upstart is currently unable to preserve
45              its state, but is necessary when upgrading system libraries.
46

OPTIONS

48       -e KEY=VALUE
49              This specifies an additional environment variable to be included
50              in the event along with RUNLEVEL and PREVLEVEL.
51

ENVIRONMENT

53       RUNLEVEL
54              telinit  will  read  the  current runlevel from this environment
55              variable if set in preference to reading from /var/run/utmp
56

FILES

58       /var/run/utmp
59              Where the current runlevel will be read  from;  this  file  will
60              also be updated with the new runlevel.
61
62       /var/log/wtmp
63              A  new runlevel record will be appended to this file for the new
64              runlevel.
65

NOTES

67       The Upstart init(8) daemon does not keep  track  of  runlevels  itself,
68       instead they are implemented entirely by its userspace tools.
69
70       See runlevel(7) for more details.
71

AUTHOR

73       Written by Scott James Remnant <scott@netsplit.com>
74

REPORTING BUGS

76       Report bugs at <https://launchpad.net/upstart/+bugs>
77

COPYRIGHT

79       Copyright © 2009 Canonical Ltd.
80       This is free software; see the source for copying conditions.  There is
81       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
82       PURPOSE.
83