SETBOOT Utility
The SETBOOT utility provides a command line interface which enables the
user to configure the parameters associated with the Boot Manager environment.
Invoking the SETBOOT utility is achieved using the following command:
<Drive:><path> SETBOOT parameter <:value>
where parameter:value is one of the following:
IBD:X
Restarts the system from the specified
logical drive, X, without going through the Boot Manager menu. The
parameter X is the drive letter of a startable partition. If Boot
Manager is not present then only drive C can be specified. For example,
to reboot the system immediately from drive D without going through
Boot Manager type:
SETBOOT /IBD:D
/T:x
Sets
the time-out value of the timer for the Boot Manager selection menu. The
specified value of x may be 0 to 999 or NO. A specified value of
nnn is the time in seconds that the Boot Manager selection menu will remain
displayed before automatically starting the default logical drive. A specified
value of 0 seconds bypasses the Boot Manager selection menu entirely, booting
the default system without any intervention. When the time-out value is
NO, the timer is disabled, leaving the Boot Manager selection menu displayed
until the user makes a selection.
/M:m
Sets
the mode for the Boot Manager selection menu:
m
= n sets the mode to display only the boot names of the logical drives
marked bootable. This is the default mode.
m = a (advanced mode) sets the mode
to display additional information such as physical drive, file system type,
etc.
/Q
Queries
the current Boot Manager environment. Returns the default volume boot names,
time-out value, mode, and unattended operation logical drive assignments.
/B
Performs an shutdown
and then reboots the system, booting to the system set to the marked index
value at the time of boot.
Note: This is not the complete system shutdown which can be performed
via the Workplace Shell's desktop context menu. All it does is basically
flushing all file system buffers and close all currently open files. PM
Applications will not receive any message, they will just be cut off, where
ever they were left.
/X:x
This
is an index which indicates the logical drive to Boot Manager from which
the system is to be started:
A
value of 0 sets Boot Manager to attended mode operation and provides for
a default system selection.
A
value of 1 to 3 puts Boot Manager in an unattended operation mode, in which
case all attended mode functions are bypassed, including the selection menu.
This is provided as a mechanism that unattended operation can use to implement
a fallback boot sequence. For example, if an operating system fails to
access a program to set the index, the subsequent boot will attempt to start
the next fallback system (probably a more trusted system) and so on.
Boot Manager will start the system from the logical drive corresponding
to the index and then, before exiting, will decrement the value by 1 so
long as the value is greater than 1. If the value is not set by SETBOOT
before the next boot, Boot Manager will start the system from a different
logical drive.
/N:name
N = 0 assigns
the specified boot name as the default operating system. N
= 1 to 3 specifies the boot name to be started when the corresponding index
is chosen to start.
To
specify the logical drive with the boot name MYSYSTEM as the default operating
system to be started type:
SETBOOT /0:MYSYSTEM
SETBOOT will provide a return code and the requested information. The information
is output to STDOUT and can be piped and redirected.
Return codes are 0 for successful operation and 1 for unsuccessful operation.
[Back: FDISK Program]
[Next: Selecting an Operating System]