| blob | 87f4bd892bf34a963a45037c26868b5f048d436d |
1 '\" te
2 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
3 .\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution.
4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
5 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
6 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7 .TH REBOOT 1M "Feb 21, 2016"
8 .SH NAME
9 reboot \- restart the operating system
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fB/usr/sbin/reboot\fR [\fB-dlnq\fR] [\fIboot_arguments\fR]
14 .fi
16 .LP
17 .nf
18 \fB/usr/sbin/reboot\fR [\fB-f\fR [\fB-e\fR \fIenvironment\fR] | \fB-p\fR] [\fB-dlnq\fR] [\fIboot_arguments\fR]
19 .fi
21 .SH DESCRIPTION
22 .LP
23 The \fBreboot\fR utility restarts the kernel. The kernel is loaded into memory
24 by the PROM monitor, which transfers control to the loaded kernel.
25 .sp
26 .LP
27 On x86 systems, when the \fB-f\fR flag is specified, the running kernel will
28 load the next kernel into memory, then transfer control to the newly loaded
29 kernel. This form of \fBreboot\fR is shown in the second synopsis, above.
30 .sp
31 .LP
32 Although \fBreboot\fR can be run by the super-user at any time,
33 \fBshutdown\fR(1M) is normally used first to warn all users logged in of the
34 impending loss of service. See \fBshutdown\fR(1M) for details.
35 .sp
36 .LP
37 The \fBreboot\fR utility performs a \fBsync\fR(1M) operation on the disks, and
38 then a multi-user reboot is initiated. See \fBinit\fR(1M) for details. On x86
39 systems, reboot may also update the boot archive as needed to ensure a
40 successful reboot.
41 .sp
42 .LP
43 The \fBreboot\fR utility normally logs the reboot to the system log daemon,
44 \fBsyslogd\fR(1M), and places a shutdown record in the login accounting file
45 \fB/var/adm/wtmpx\fR. These actions are inhibited if the \fB-n\fR or \fB-q\fR
46 options are present.
47 .sp
48 .LP
49 Normally, the system reboots itself at power-up or after crashes.
50 .SH OPTIONS
51 .LP
52 The following options are supported:
53 .sp
54 .ne 2
55 .na
56 \fB\fB-d\fR\fR
57 .ad
58 .sp .6
59 .RS 4n
60 Force a system crash dump before rebooting. See \fBdumpadm\fR(1M) for
61 information on configuring system crash dumps.
62 .RE
64 .sp
65 .ne 2
66 .na
67 \fB\fB-e\fR\fR
68 .ad
69 .sp .6
70 .RS 4n
71 If \fB-f\fR is present, reboot to the specified boot environment.
72 .RE
74 .sp
75 .ne 2
76 .na
77 \fB\fB-f\fR\fR
78 .ad
79 .sp .6
80 .RS 4n
81 Fast reboot, bypassing firmware and boot loader. The new kernel will be loaded
82 into memory by the running kernel, and control will be transferred to the newly
83 loaded kernel. If disk or kernel arguments are specified, they must be
84 specified before other boot arguments.
85 .sp
86 This option is currently available only on x86 systems.
87 .sp
88 Service \fBsvc:/system/boot-config:default\fR is enabled by default. It
89 requires \fBsolaris.system.shutdown\fR as \fBaction_authorization\fR and
90 \fBvalue_authorization\fR. When the \fBconfig/fastreboot_default\fR property is
91 set to \fBtrue\fR, \fBreboot\fR will behave as \fBreboot\fR \fB-f\fR. The value
92 of this property can be changed using \fBsvccfg\fR(1M) and \fBsvcadm\fR(1M), to
93 control the default reboot behavior.
94 .sp
95 See \fBEXAMPLES\fR for details.
96 .RE
98 .sp
99 .ne 2
100 .na
101 \fB\fB-l\fR\fR
102 .ad
103 .sp .6
104 .RS 4n
105 Suppress sending a message to the system log daemon, \fBsyslogd\fR(1M) about
106 who executed \fBreboot\fR.
107 .RE
109 .sp
110 .ne 2
111 .na
112 \fB\fB-n\fR\fR
113 .ad
114 .sp .6
115 .RS 4n
116 Avoid calling \fBsync\fR(2) and do not log the reboot to \fBsyslogd\fR(1M) or
117 to \fB/var/adm/wtmpx\fR. The kernel still attempts to sync filesystems prior to
118 reboot, except if the \fB-d\fR option is also present. If \fB-d\fR is used with
119 \fB-n\fR, the kernel does not attempt to sync file systems.
120 .RE
122 .sp
123 .ne 2
124 .na
125 \fB\fB-p\fR\fR
126 .ad
127 .sp .6
128 .RS 4n
129 Reboot to prom. This flag can be used to reboot the system through firmware
130 without changing the default reboot behavior as denoted by the
131 \fBconfig/fastreboot_default\fR property setting in \fBsystem/boot-config\fR
132 service.
133 .sp
134 This option is currently available only on x86 systems. The \fB-p\fR and
135 \fB-f\fR options are mutually exclusive.
136 .RE
138 .sp
139 .ne 2
140 .na
141 \fB\fB-q\fR\fR
142 .ad
143 .sp .6
144 .RS 4n
145 Quick. Reboot quickly and ungracefully, without shutting down running processes
146 first.
147 .RE
149 .SH OPERANDS
150 .LP
151 The following operands are supported:
152 .sp
153 .ne 2
154 .na
155 \fB\fIboot_arguments\fR\fR
156 .ad
157 .sp .6
158 .RS 4n
159 An optional \fIboot_arguments\fR specifies arguments to the \fBuadmin\fR(2)
160 function that are passed to the boot program and kernel upon restart. The form
161 and list of arguments is described in the \fBboot\fR(1M) and \fBkernel\fR(1M)
162 man pages.. If the arguments are specified, whitespace between them is replaced
163 by single spaces unless the whitespace is quoted for the shell. If the
164 \fIboot_arguments\fR begin with a hyphen, they must be preceded by the \fB--\fR
165 delimiter (two hyphens) to denote the end of the \fBreboot\fR argument list.
166 .RE
168 .SH EXAMPLES
169 .LP
170 \fBExample 1 \fRPassing the \fB-r\fR and \fB-v\fR Arguments to \fBboot\fR
171 .sp
172 .LP
173 In the following example, the delimiter \fB--\fR (two hyphens) must be used to
174 separate the options of \fBreboot\fR from the arguments of \fBboot\fR(1M).
176 .sp
177 .in +2
178 .nf
179 example# \fBreboot -dl -- -rv\fR
180 .fi
181 .in -2
182 .sp
184 .LP
185 \fBExample 2 \fRRebooting Using a Specific Disk and Kernel
186 .sp
187 .LP
188 The following example reboots using a specific disk and kernel.
190 .sp
191 .in +2
192 .nf
193 example# \fBreboot disk1 kernel.test/unix\fR
194 .fi
195 .in -2
196 .sp
198 .LP
199 \fBExample 3 \fRFast Rebooting
200 .sp
201 .LP
202 The following examples use the \fB-f\fR option to perform fast reboots.
204 .sp
205 .LP
206 If service \fBsvc:/system/boot-config:default\fR is enabled and property
207 \fBconfig/fastreboot_default\fR is set to \fBtrue\fR, the \fB-f\fR option can
208 be omitted.
210 .sp
211 .LP
212 The following command reboots to the default entry in the boot
213 menu file \fBmenu.lst\fR.
215 .sp
216 .in +2
217 .nf
218 example# \fBreboot -f\fR
219 .fi
220 .in -2
221 .sp
223 .sp
224 .LP
225 The following command reboots to another UFS root disk.
227 .sp
228 .in +2
229 .nf
230 example# \fBreboot -f -- '/dev/dsk/c1d0s0'\fR
231 .fi
232 .in -2
233 .sp
235 .sp
236 .LP
237 The following command reboots to another ZFS root pool.
239 .sp
240 .in +2
241 .nf
242 example# \fBreboot -f -- 'rpool/ROOT/root2'\fR
243 .fi
244 .in -2
245 .sp
247 .sp
248 .LP
249 The following command reboots to \fBmykernel\fR on the same disk with \fB-k\fR
250 option.
252 .sp
253 .in +2
254 .nf
255 example# \fBreboot -f -- '/platform/i86pc/mykernel/amd64/unix -k'\fR
256 .fi
257 .in -2
258 .sp
260 .sp
261 .LP
262 The following command reboots to \fBmykernel\fR off another root disk mounted
263 on \fB/mnt\fR.
265 .sp
266 .in +2
267 .nf
268 example# \fBreboot -f -- '/mnt/platform/i86pc/mykernel/amd64/unix -k'\fR
269 .fi
270 .in -2
271 .sp
273 .sp
274 .LP
275 The following command reboots to \fB/platform/i86pc/kernel/$ISADIR/unix\fR on
276 another boot environment named \fBsecond_root\fR.
278 .sp
279 .in +2
280 .nf
281 example# \fBreboot -f -e second_root\fR
282 .fi
283 .in -2
284 .sp
286 .sp
287 .LP
288 The following command reboots to the same kernel with \fB-kv\fR options.
290 .sp
291 .in +2
292 .nf
293 example# \fBreboot -f -- '-kv'\fR
294 .fi
295 .in -2
296 .sp
298 .sp
299 .LP
300 The following commands disable the fast-reboot-by-default behavior.
302 .sp
303 .in +2
304 .nf
305 example# \fBsvccfg -s "system/boot-config:default" \e\fR
306 \fBsetprop config/fastreboot_default=false\fR
307 example# \fBsvcadm refresh svc:/system/boot-config:default\fR
308 .fi
309 .in -2
310 .sp
312 .sp
313 .LP
314 The following commands re-enable the fast-reboot-by-default behavior.
316 .sp
317 .in +2
318 .nf
319 example# \fBsvccfg -s "system/boot-config:default" \e\fR
320 \fBsetprop config/fastreboot_default=true\fR
321 example# \fBsvcadm refresh svc:/system/boot-config:default\fR
322 .fi
323 .in -2
324 .sp
326 .LP
327 \fBExample 4 \fRRebooting to a Particular Boot Menu Entry
328 .sp
329 .LP
330 The following commands will reboot to entry \fB2\fR in the boot menu.
332 .sp
333 .in +2
334 .nf
335 example# \fBbootadm list-menu\fR
336 the location for the active menu is: /rpool/boot/menu.lst
337 Index Default Dataset Menu
338 0 - rpool/ROOT/test-182 test-182
339 1 * rpool/ROOT/test-183 test-183
340 2 - rpool/ROOT/test-183 test-183
341 example# \fBreboot 2\fR
342 .fi
343 .in -2
344 .sp
346 .SH FILES
347 .ne 2
348 .na
349 \fB\fB/var/adm/wtmpx\fR\fR
350 .ad
351 .sp .6
352 .RS 4n
353 login accounting file
354 .RE
356 .SH SEE ALSO
357 .LP
358 \fBmdb\fR(1), \fBboot\fR(1M), \fBdumpadm\fR(1M), \fBfsck\fR(1M),
359 \fBhalt\fR(1M), \fBinit\fR(1M), \fBkernel\fR(1M), \fBshutdown\fR(1M),
360 \fBsvcadm\fR(1M), \fBsvccfg\fR(1M), \fBsync\fR(1M), \fBsyslogd\fR(1M),
361 \fBsync\fR(2), \fBuadmin\fR(2), \fBreboot\fR(3C), \fBattributes\fR(5)
362 .SH NOTES
363 .LP
364 The \fBreboot\fR utility does not execute the scripts in
365 \fB/etc/rc\fInum\fR.d\fR or execute shutdown actions in \fBinittab\fR(4). To
366 ensure a complete shutdown of system services, use \fBshutdown\fR(1M) or
367 \fBinit\fR(1M) to reboot a Solaris system.