xref: /dragonfly/sbin/reboot/reboot.8 (revision c89a6c1b)
1.\" Copyright (c) 1990, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\"    must display the following acknowledgement:
14.\"	This product includes software developed by the University of
15.\"	California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\"    may be used to endorse or promote products derived from this software
18.\"    without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\"	@(#)reboot.8	8.1 (Berkeley) 6/9/93
33.\" $FreeBSD: src/sbin/reboot/reboot.8,v 1.10.2.7 2003/02/23 22:42:10 trhodes Exp $
34.\" $DragonFly: src/sbin/reboot/reboot.8,v 1.3 2005/08/01 01:49:17 swildner Exp $
35.\"
36.Dd June 9, 1993
37.Dt REBOOT 8
38.Os
39.Sh NAME
40.Nm reboot ,
41.Nm halt ,
42.Nm fastboot ,
43.Nm fasthalt
44.Nd stopping and restarting the system
45.Sh SYNOPSIS
46.Nm halt
47.Op Fl lnqp
48.Op Fl k Ar kernel
49.Nm
50.Op Fl dlnqp
51.Op Fl k Ar kernel
52.Nm fasthalt
53.Op Fl lnqp
54.Op Fl k Ar kernel
55.Nm fastboot
56.Op Fl dlnqp
57.Op Fl k Ar kernel
58.Sh DESCRIPTION
59The
60.Nm halt
61and
62.Nm
63utilities flush the file system cache to disk, send all running processes
64a
65.Dv SIGTERM
66(and subsequently a
67.Dv SIGKILL )
68and, respectively, halt or restart the system.
69The action is logged, including entering a shutdown record into the
70.Xr wtmp 5
71file.
72.Pp
73The options are as follows:
74.Bl -tag -width indent
75.It Fl d
76The system is requested to create a crash dump.
77This option is
78supported only when rebooting, and it has no effect unless a dump
79device has previously been specified with
80.Xr dumpon 8 .
81.It Fl k Ar kernel
82Boot the specified
83.Ar kernel
84on the next system boot.
85If the kernel boots successfully, the
86.Em default
87kernel will be booted on successive boots, this is a one-shot option.
88If the boot fails, the system will continue attempting to boot
89.Ar kernel
90until the boot process is interrupted and a valid kernel booted.
91This may change in the future.
92.It Fl l
93The halt or reboot is
94.Em not
95logged to the system log.
96This option is intended for applications such as
97.Xr shutdown 8 ,
98that call
99.Nm
100or
101.Nm halt
102and log this themselves.
103.It Fl n
104The file system cache is not flushed.
105This option should probably not be used.
106.It Fl q
107The system is halted or restarted quickly and ungracefully, and only
108the flushing of the file system cache is performed (if the
109.Fl n
110is not specified).
111This option should probably not be used.
112.It Fl p
113The system will turn off the power
114if it can.
115This is of course likely to make
116.Nm
117rather similar to
118.Nm halt .
119.El
120.Pp
121The
122.Nm fasthalt
123and
124.Nm fastboot
125utilities are nothing more than aliases for the
126.Nm halt
127and
128.Nm
129utilities.
130.Pp
131Normally, the
132.Xr shutdown 8
133utility is used when the system needs to be halted or restarted, giving
134users advance warning of their impending doom and cleanly terminating
135specific programs.
136.Sh SEE ALSO
137.Xr wtmp 5 ,
138.Xr boot 8 ,
139.Xr dumpon 8 ,
140.Xr savecore 8 ,
141.Xr shutdown 8 ,
142.Xr sync 8
143.Sh HISTORY
144A
145.Nm
146command appeared in
147.At v6 .
148