Shorten (wrap) some too-long lines.
[oweals/dinit.git] / doc / manpages / shutdown.8
1 .TH SHUTDOWN "8" "October 2018" "Dinit 0.4.0" "Dinit \- service management system"
2 .SH NAME
3 shutdown, halt, reboot \- system shutdown 
4 .\"
5 .SH SYNOPSIS
6 .\"
7 .B shutdown
8 [\fB\-r\fR|\fB\-h\fR|\fB\-p\fR] [\fB\-\-use\-passed\-cfd\fR]
9 [\fB\-\-system\fR]
10 .br
11 \fBhalt\fR [\fIoptions...\fR]
12 .br
13 \fBreboot\fR [\fIoptions...\fR]
14 .\"
15 .SH DESCRIPTION
16 .\"
17 This manual page is for the shutdown utility included with the \fBDinit\fR
18 service manager package. See \fBdinit\fR(8).
19
20 The shutdown, reboot and halt commands can be used to instruct the service
21 manager daemon to perform a service rollback and then to shutdown the
22 system. They can also perform shutdown directly, without service rollback.
23
24 Note that for consistency with other packages a "halt" alias is provided,
25 however it has no special significance.
26 .\"
27 .SH OPTIONS
28 .TP
29 \fB\-r\fP
30 Request a shutdown followed by restart. This is the default if executed as
31 \fBreboot\fR.
32 .TP
33 \fB\-h\fP
34 Shutdown and then halt the system (without powering down).
35 .TP
36 \fB\-p\fP
37 Shutdown and then power down the system. This is the default unless executed
38 as \fBreboot\fR.
39 .TP
40 \fB\-\-use\-passed\-cfd\fR
41 Instead of attempting to open a socket connection to the service daemon,
42 use a pre-opened connection that has been passed to the process from its parent
43 via an open file descriptor. The file descriptor with the connection is identifed
44 by the DINIT_CS_FD environment variable.
45 .TP
46 \fB\-\-system\fR
47 Shut down directly, instead of by issuing a command to the service manager. Use of
48 this option should be avoided, but it may allow performing a clean shutdown in case
49 the service manager has stopped responding.
50
51 The service manager may invoke \fBshutdown\fR with this option in order to perform
52 system shutdown after it has rolled back services.
53 .\"
54 .SH SEE ALSO
55 .\"
56 \fBdinit\fR(8), \fBdinitctl\fR(8)
57 .\"
58 .SH AUTHOR
59 Dinit, and this manual, were written by Davin McCall.