System Administration Commands reboot(1M)
NAME
reboot - restart the operating system
SYNOPSIS
/usr/sbin/reboot [-dlnq] [bootarguments]
/usr/sbin/reboot [-f [-e environment] [-dlnq] [bootarguments]
DESCRIPTION
The reboot utility restarts the kernel. The kernel is loaded
into memory by the PROM monitor, which transfers control to
the loaded kernel.
On x86 systems, when the -f flag is specified, the running
kernel will load the next kernel into memory, then transfer
control to the newly loaded kernel. This form of reboot is
shown in the second synopsis, above.
Although reboot can be run by the super-user at any time,
shutdown(1M) is normally used first to warn all users logged
in of the impending loss of service. See shutdown(1M) for
details.
The reboot utility performs a sync(1M) operation on the
disks, and then a multi-user reboot is initiated. See
init(1M) for details. On x86 systems, reboot may also update
the boot archive as needed to ensure a successful reboot.
The reboot utility normally logs the reboot to the system
log daemon, syslogd(1M), and places a shutdown record in the
login accounting file /var/adm/wtmpx. These actions are
inhibited if the -n or -q options are present.
Normally, the system reboots itself at power-up or after
crashes.
OPTIONS
The following options are supported:
-d
Force a system crash dump before rebooting. See
dumpadm(1M) for information on configuring system crash
dumps.
SunOS 5.11 Last change: 29 Sep 2008 1
System Administration Commands reboot(1M)
-e
If -f is present, reboot to the specified boot environ-
ment.
-f
Fast reboot, bypassing firmware and boot loader. The new
kernel will be loaded into memory by the running kernel,
and control will be transferred to the newly loaded ker-
nel. If disk or kernel arguments are specified, they
must be specified before other boot arguments.
This option is currently available only on x86 systems.
See EXAMPLES for details.
-l
Suppress sending a message to the system log daemon,
syslogd(1M) about who executed reboot.
-n
Avoid calling sync(2) and do not log the reboot to
syslogd(1M) or to /var/adm/wtmpx. The kernel still
attempts to sync filesystems prior to reboot, except if
the -d option is also present. If -d is used with -n,
the kernel does not attempt to sync filesystems.
-q
Quick. Reboot quickly and ungracefully, without shutting
down running processes first.
OPERANDS
The following operands are supported:
bootarguments
An optional bootarguments specifies arguments to the
uadmin(2) function that are passed to the boot program
and kernel upon restart. The form and list of arguments
is described in the boot(1M) and kernel(1M) man pages..
If the arguments are specified, whitespace between them
is replaced by single spaces unless the whitespace is
quoted for the shell. If the bootarguments begin with a
SunOS 5.11 Last change: 29 Sep 2008 2
System Administration Commands reboot(1M)
hyphen, they must be preceded by the -- delimiter (two
hyphens) to denote the end of the reboot argument list.
EXAMPLES
Example 1 Passing the -r and -v Arguments to boot
In the following example, the delimiter -- (two hyphens)
must be used to separate the options of reboot from the
arguments of boot(1M).
example# reboot -dl -- -rv
Example 2 Rebooting Using a Specific Disk and Kernel
The following example reboots using a specific disk and ker-
nel.
example# reboot disk1 kernel.test/unix
Example 3 Fast Rebooting
The following examples use the f option to perform fast
reboots.
The following command reboots to the same kernel.
example# reboot -f
The following command reboots to another UFS root disk.
example# reboot -f -- '/dev/dsk/c1d0s0'
SunOS 5.11 Last change: 29 Sep 2008 3
System Administration Commands reboot(1M)
The following command reboots to another ZFS root pool.
example# reboot -f -- 'rpool/ROT/root2'
The following command reboots to mykernel on the same disk
with -k option.
example# reboot -f -- '/platform/i86pc/mykernel/amd64/unix -k'
The following command reboots to mykernel off another root
disk mounted on /mnt.
example# reboot -f -- '/mnt/platform/i86pc/mykernel/amd64/unix -k'
The following command reboots to
/platform/i86pc/kernel/$ISADIR/unix on another boot environ-
ment named secondroot.
example# reboot -f -e secondroot
The following command reboots to the same kernel with -kv
options.
example# reboot -f -- '-kv'
FILES
/var/adm/wtmpx
login accounting file
ATRIBUTES
SunOS 5.11 Last change: 29 Sep 2008 4
System Administration Commands reboot(1M)
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
SEE ALSO
mdb(1), boot(1M), dumpadm(1M), fsck(1M), halt(1M), init(1M),
kernel(1M), shutdown(1M), sync(1M), syslogd(1M), sync(2),
uadmin(2), reboot(3C), attributes(5)
NOTES
The reboot utility does not execute the scripts in
/etc/rcnum.d or execute shutdown actions in inittab(4). To
ensure a complete shutdown of system services, use
shutdown(1M) or init(1M) to reboot a Solaris system.
SunOS 5.11 Last change: 29 Sep 2008 5
|
