reboot(1m) - osol9

1reboot(1M)              System Administration Commands              reboot(1M)
2
3
4

NAME

6       reboot - restart the operating system
7

SYNOPSIS

9       /usr/sbin/reboot [-dlnq] [boot_arguments]
10
11
12       /usr/sbin/reboot [-f [-e environment] | -p] [-dlnq] [boot_arguments]
13
14

DESCRIPTION

16       The  reboot utility restarts the kernel. The kernel is loaded into mem‐
17       ory by the PROM monitor, which transfers control to the loaded kernel.
18
19
20       On x86 systems, when the -f flag is specified, the running kernel  will
21       load  the  next  kernel into memory, then transfer control to the newly
22       loaded kernel. This form of reboot is shown  in  the  second  synopsis,
23       above.
24
25
26       Although  reboot can be run by the super-user at any time, shutdown(1M)
27       is normally used first to warn all users logged  in  of  the  impending
28       loss of service. See shutdown(1M) for details.
29
30
31       The reboot utility performs a sync(1M) operation on the disks, and then
32       a multi-user reboot is initiated. See init(1M) for details. On x86 sys‐
33       tems,  reboot  may  also  update the boot archive as needed to ensure a
34       successful reboot.
35
36
37       The reboot utility normally logs the reboot to the system  log  daemon,
38       syslogd(1M),  and places a shutdown record in the login accounting file
39       /var/adm/wtmpx. These actions are inhibited if the -n or -q options are
40       present.
41
42
43       Normally, the system reboots itself at power-up or after crashes.
44

OPTIONS

46       The following options are supported:
47
48       -d
49
50           Force  a  system  crash  dump before rebooting. See dumpadm(1M) for
51           information on configuring system crash dumps.
52
53
54       -e
55
56           If -f is present, reboot to the specified boot environment.
57
58
59       -f
60
61           Fast reboot, bypassing firmware and boot  loader.  The  new  kernel
62           will  be loaded into memory by the running kernel, and control will
63           be transferred to the newly loaded kernel. If disk or kernel  argu‐
64           ments are specified, they must be specified before other boot argu‐
65           ments.
66
67           This option is currently available only on x86 systems.
68
69           Service svc:/system/boot-config:default is enabled by  default.  It
70           requires   solaris.system.shutdown   as   action_authorization  and
71           value_authorization. When the config/fastreboot_default property is
72           set  to  true,  reboot  will behave as reboot -f. The value of this
73           property can be changed using svccfg(1M) and svcadm(1M), to control
74           the default reboot behavior.
75
76           See EXAMPLES for details.
77
78
79       -l
80
81           Suppress  sending  a  message to the system log daemon, syslogd(1M)
82           about who executed reboot.
83
84
85       -n
86
87           Avoid calling sync(2) and do not log the reboot to  syslogd(1M)  or
88           to  /var/adm/wtmpx.  The  kernel still attempts to sync filesystems
89           prior to reboot, except if the -d option is also present. If -d  is
90           used with -n, the kernel does not attempt to sync file systems.
91
92
93       -p
94
95           Reboot  to prom. This flag can be used to reboot the system through
96           firmware without changing the default reboot behavior as denoted by
97           the  config/fastreboot_default property setting in system/boot-con‐
98           fig service.
99
100           This option is currently available only on x86 systems. The -p  and
101           -f options are mutually exclusive.
102
103
104       -q
105
106           Quick.  Reboot quickly and ungracefully, without shutting down run‐
107           ning processes first.
108
109

OPERANDS

111       The following operands are supported:
112
113       boot_arguments
114
115           An optional boot_arguments specifies  arguments  to  the  uadmin(2)
116           function  that  are  passed  to  the  boot  program and kernel upon
117           restart. The form  and  list  of  arguments  is  described  in  the
118           boot(1M) and kernel(1M) man pages.. If the arguments are specified,
119           whitespace between them is replaced by  single  spaces  unless  the
120           whitespace  is  quoted  for  the shell. If the boot_arguments begin
121           with a hyphen, they must be  preceded  by  the  --  delimiter  (two
122           hyphens) to denote the end of the reboot argument list.
123
124

EXAMPLES

126       Example 1 Passing the -r and -v Arguments to boot
127
128
129       In  the  following example, the delimiter -- (two hyphens) must be used
130       to separate the options of reboot from the arguments of boot(1M).
131
132
133         example# reboot -dl -- -rv
134
135
136
137       Example 2 Rebooting Using a Specific Disk and Kernel
138
139
140       The following example reboots using a specific disk and kernel.
141
142
143         example# reboot disk1 kernel.test/unix
144
145
146
147       Example 3 Fast Rebooting
148
149
150       The following examples use the -f option to perform fast reboots.
151
152
153
154       If service svc:/system/boot-config:default is enabled and property con‐
155       fig/fastreboot_default is set to true, the -f option can be omitted.
156
157
158
159       The  following  command  reboots  to the default entry in the GRUB (see
160       grub(5)) menu file menu.lst.
161
162
163         example# reboot -f
164
165
166
167
168       The following command reboots to another UFS root disk.
169
170
171         example# reboot -f -- '/dev/dsk/c1d0s0'
172
173
174
175
176       The following command reboots to another ZFS root pool.
177
178
179         example# reboot -f -- 'rpool/ROOT/root2'
180
181
182
183
184       The following command reboots to mykernel on  the  same  disk  with  -k
185       option.
186
187
188         example# reboot -f -- '/platform/i86pc/mykernel/amd64/unix -k'
189
190
191
192
193       The following command reboots to mykernel off another root disk mounted
194       on /mnt.
195
196
197         example# reboot -f -- '/mnt/platform/i86pc/mykernel/amd64/unix -k'
198
199
200
201
202       The following command reboots to /platform/i86pc/kernel/$ISADIR/unix on
203       another boot environment named second_root.
204
205
206         example# reboot -f -e second_root
207
208
209
210
211       The following command reboots to the same kernel with -kv options.
212
213
214         example# reboot -f -- '-kv'
215
216
217
218
219       The following commands disable the fast-reboot-by-default behavior.
220
221
222         example# svccfg -s "system/boot-config:default" \
223         setprop config/fastreboot_default=false
224         example# svcadm refresh svc:/system/boot-config:default
225
226
227
228
229       The following commands re-enable the fast-reboot-by-default behavior.
230
231
232         example# svccfg -s "system/boot-config:default" \
233         setprop config/fastreboot_default=true
234         example# svcadm refresh svc:/system/boot-config:default
235
236
237
238       Example 4 Rebooting to a Particular GRUB Menu
239
240
241       The following commands will reboot to entry 2 in the GRUB menu.
242
243
244         example# bootadm list-menu
245           the location for the active GRUB menu is: /rpool/boot/grub/menu.lst
246           default 0
247           timeout 10
248           0 zfsbe1
249           1 zfsbe1 failsafe
250           2 zfsbe2
251           3 zfsbe2 Solaris xVM
252           4 zfsbe2 failsafe
253         example# reboot 2
254
255
256

FILES

258       /var/adm/wtmpx
259
260           login accounting file
261
262

ATTRIBUTES

264       See attributes(5) for descriptions of the following attributes:
265
266
267
268
269       ┌─────────────────────────────┬─────────────────────────────┐
270       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
271       ├─────────────────────────────┼─────────────────────────────┤
272       │Availability                 │SUNWcsu                      │
273       └─────────────────────────────┴─────────────────────────────┘
274

NOTES

281       The reboot utility does not execute the scripts in /etc/rcnum.d or exe‐
282       cute shutdown actions in inittab(4). To ensure a complete  shutdown  of
283       system  services, use shutdown(1M) or init(1M) to reboot a Solaris sys‐
284       tem.
285
286
287
288SunOS 5.11                        24 Aug 2009                       reboot(1M)