Debian Codegraph @

upstream/debian-unstable/man8/shutdown.8

raw
1 '\" t
2 .TH "SHUTDOWN" "8" "" "systemd 261~rc3" "shutdown"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 shutdown \- Halt, power off or reboot the machine
24 .SH "SYNOPSIS"
25 .HP \w'\fBshutdown\fR\ 'u
26 \fBshutdown\fR [OPTIONS...] [TIME] [WALL...]
27 .SH "DESCRIPTION"
28 .PP
29 \fBshutdown\fR
30 may be used to halt, power off, or reboot the machine\&.
31 .PP
32 The first argument may be a time string (which is usually
33 "now")\&. Optionally, this may be followed by a wall message to be sent to all logged\-in users before going down\&.
34 .PP
35 The time string may either be in the format
36 "hh:mm"
37 for hour/minutes specifying the time to execute the shutdown at, specified in 24h clock format\&. Alternatively it may be in the syntax
38 "+m"
39 referring to the specified number of minutes m from now\&.
40 "now"
41 is an alias for
42 "+0", i\&.e\&. for triggering an immediate shutdown\&. If no time argument is specified,
43 "+1"
44 is implied\&.
45 .PP
46 Note that to specify a wall message you must specify a time argument, too\&.
47 .PP
48 If the time argument is used, 5 minutes before the system goes down the
49 /run/nologin
50 file is created to ensure that further logins shall not be allowed\&.
51 .SH "OPTIONS"
52 .PP
53 The following options are understood:
54 .PP
55 \fB\-\-help\fR
56 .RS 4
57 Print a short help text and exit\&.
58 .RE
59 .PP
60 \fB\-H\fR, \fB\-\-halt\fR
61 .RS 4
62 Halt the machine\&.
63 .RE
64 .PP
65 \fB\-P\fR, \fB\-\-poweroff\fR
66 .RS 4
67 Power the machine off (the default)\&.
68 .RE
69 .PP
70 \fB\-r\fR, \fB\-\-reboot\fR
71 .RS 4
72 Reboot the machine\&.
73 .RE
74 .PP
75 \fB\-h\fR
76 .RS 4
77 The same as
78 \fB\-\-poweroff\fR, but does not override the action to take if it is "halt"\&. E\&.g\&.
79 \fBshutdown \-\-reboot \-h\fR
80 means "poweroff", but
81 \fBshutdown \-\-halt \-h\fR
82 means "halt"\&.
83 .RE
84 .PP
85 \fB\-k\fR
86 .RS 4
87 Do not halt, power off, or reboot, but just write the wall message\&.
88 .RE
89 .PP
90 \fB\-\-no\-wall\fR
91 .RS 4
92 Do not send wall message before halt, power off, or reboot\&.
93 .RE
94 .PP
95 \fB\-c\fR
96 .RS 4
97 Cancel a pending shutdown\&. This may be used to cancel the effect of an invocation of
98 \fBshutdown\fR
99 with a time argument that is not
100 "+0"
101 or
102 "now"\&.
103 .RE
104 .PP
105 \fB\-\-show\fR
106 .RS 4
107 Show a pending shutdown action and time if there is any\&.
108 .sp
109 Added in version 250\&.
110 .RE
111 .SH "EXIT STATUS"
112 .PP
113 On success, 0 is returned, a non\-zero failure code otherwise\&.
114 .SH "COMPATIBILITY"
115 .PP
116 The
117 \fB shutdown\fR
118 command in previous init systems (including sysvinit) defaulted to single\-user mode instead of powering off the machine\&. To change into single\-user mode, use
119 \fBsystemctl rescue\fR
120 instead\&.
121 .SH "SEE ALSO"
122 .PP
123 \fBsystemd\fR(1), \fBsystemctl\fR(1), \fBhalt\fR(8), \fBwall\fR(1)