Debian Codegraph @

upstream/debian-unstable/man8/poweroff.8

raw
1 '\" t
2 .TH "POWEROFF" "8" "" "systemd 261~rc3" "poweroff"
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 poweroff, reboot, halt \- Power off, reboot, or halt the machine
24 .SH "SYNOPSIS"
25 .HP \w'\fBpoweroff\fR\ 'u
26 \fBpoweroff\fR [OPTIONS...]
27 .HP \w'\fBreboot\fR\ 'u
28 \fBreboot\fR [OPTIONS...]
29 .HP \w'\fBhalt\fR\ 'u
30 \fBhalt\fR [OPTIONS...]
31 .SH "DESCRIPTION"
32 .PP
33 \fBpoweroff\fR,
34 \fBreboot\fR, and
35 \fBhalt\fR
36 may be used to power off, reboot, or halt the machine\&. All three commands take the same options\&.
37 .SH "OPTIONS"
38 .PP
39 The following options are understood:
40 .PP
41 \fB\-\-help\fR
42 .RS 4
43 Print a short help text and exit\&.
44 .sp
45 Added in version 253\&.
46 .RE
47 .PP
48 \fB\-\-halt\fR
49 .RS 4
50 Halt the machine, regardless of which one of the three commands is invoked\&.
51 .sp
52 Added in version 253\&.
53 .RE
54 .PP
55 \fB\-p\fR, \fB\-\-poweroff\fR
56 .RS 4
57 Power off the machine, when either
58 \fBhalt\fR
59 or
60 \fBpoweroff\fR
61 is invoked\&. This option is ignored when
62 \fBreboot\fR
63 is invoked\&.
64 .sp
65 Added in version 253\&.
66 .RE
67 .PP
68 \fB\-\-reboot\fR
69 .RS 4
70 Reboot the machine, regardless of which one of the three commands is invoked\&.
71 .sp
72 Added in version 253\&.
73 .RE
74 .PP
75 \fB\-f\fR, \fB\-\-force\fR
76 .RS 4
77 Force immediate power\-off, halt, or reboot\&. If specified, the command does not contact the init system\&. In most cases, filesystems are not properly unmounted before shutdown\&. For example, the command
78 \fBreboot \-f\fR
79 is mostly equivalent to
80 \fBsystemctl reboot \-ff\fR, instead of
81 \fBsystemctl reboot \-f\fR\&.
82 .sp
83 Added in version 253\&.
84 .RE
85 .PP
86 \fB\-w\fR, \fB\-\-wtmp\-only\fR
87 .RS 4
88 Only write wtmp shutdown entry, do not actually power off, reboot, or halt\&.
89 .sp
90 Added in version 253\&.
91 .RE
92 .PP
93 \fB\-d\fR, \fB\-\-no\-wtmp\fR
94 .RS 4
95 Do not write wtmp shutdown entry\&.
96 .sp
97 Added in version 253\&.
98 .RE
99 .PP
100 \fB\-n\fR, \fB\-\-no\-sync\fR
101 .RS 4
102 Do not sync hard disks/storage media before power\-off, reboot, or halt\&.
103 .sp
104 Added in version 253\&.
105 .RE
106 .PP
107 \fB\-\-no\-wall\fR
108 .RS 4
109 Do not send wall message before power\-off, reboot, or halt\&.
110 .sp
111 Added in version 253\&.
112 .RE
113 .SH "EXIT STATUS"
114 .PP
115 On success, 0 is returned, a non\-zero failure code otherwise\&.
116 .SH "NOTES"
117 .PP
118 These commands are implemented in a way that preserves basic compatibility with the original SysV commands\&.
119 \fBsystemctl\fR(1)
120 verbs
121 \fBpoweroff\fR,
122 \fBreboot\fR,
123 \fBhalt\fR
124 provide the same functionality with some additional features\&.
125 .PP
126 Note that on many SysV systems
127 \fBhalt\fR
128 used to be synonymous to
129 \fBpoweroff\fR, i\&.e\&. both commands would equally result in powering the machine off\&. systemd is more accurate here, and
130 \fBhalt\fR
131 results in halting the machine only (leaving power on), and
132 \fBpoweroff\fR
133 is required to actually power it off\&.
134 .SH "SEE ALSO"
135 .PP
136 \fBsystemd\fR(1), \fBsystemctl\fR(1), \fBshutdown\fR(8), \fBwall\fR(1)