boot(4) boot(4)
NAME
boot - boot options
DESCRIPTION
Options for the boot program can be set or changed with
keywords in /stand/boot. The following keywords are
recognized by boot.
AUTOBOOT=YES or NO
Indicate whether boot is to start loading the kernel
immediately or display a boot prompt first.
AUTOMSG=string
Define this keyword to change the message issued when an
automatic reboot is about to occur. The default message
that this keyword, if defined, will override is
"Automatic Boot Procedure"
BOOTPROMPT=string
Define this keyword to change the default boot string,
used to indicate the beginning of an interactive boot
session.
BOOTMSG=string
Define this keyword to change the default boot message
to string. The default message that this keyword, if
defined, will override is "Booting UnixWare..."
console=device(minor [, params ] )
This overrides the default configuration of the console
device (used for kernel messages, kernel debugger I/O,
/dev/sysmsg, and the console login prompt) specified in
Sassign(4) when the kernel was built. Minor number
minor of the character device device will be used
instead.
The optional parameter string, params, is passed to the
console device driver. Its interpretation is driver-
specific. The parameter string may contain nested
parentheses as long as they are exactly paired.
There is a special console pseudo-device driver which is
useful for remote administration and debugging. This
device is called mirrorcon and is found in the Advanced
Commands package. The parameter string for mirrorcon is
a list of console device specifications, each one in the
Copyright 1994 Novell, Inc. Page 1
boot(4) boot(4)
same form as described above, separated by plus signs
(``+''). All console output will be sent to each of the
specified devices, and any input entered on any of the
devices will be accepted. The minor number for
mirrorcon should always be zero.
An example of using mirrorcon for two devices named kd
and iasy might be:
console=mirrorcon(0,kd(0)+iasy(2,9600N8))
The effect of mirrorcon does not extend to the console
login prompt or use of /dev/console in general.
/dev/console can only be a single device. Whichever
device is first in the parameter string for mirrorcon
will be used for /dev/console.
COPYRIGHT=string
Define this keyword to change the default copyright
line(s) to string. This keyword can be defined multiple
times, to accommodate copyright notices that are more
than one line long.
DEVICENAMES=string
Define this keyword to list the devices attached to the
SCSI bus. string is a comma separated list of SCSI
device names. It defaults to the following:
HBA,DISK,TAPE,PRINTER,PROCESSOR,WORM,CDROM,SCANNER,\
OPTICAL,CHANGER,COMMUNICATION
The order of devices in this list must be maintained.
Only the first 13 characters of any field are used.
dumpdev=device(minor)
This overrides the default configuration of the dump
device (used for storing a system memory dump during a
panic) specified in Sassign(4) when the kernel was
built. Minor number minor of the block device named
device will be used instead.
INITSTATE=sysstate
Define this keyword to specify the system state to enter
after booting. This keyword is passed to /sbin/init and
overrides the system state specified on the initdefault
line in the /etc/inittab file. The value of sysstate
Copyright 1994 Novell, Inc. Page 2
boot(4) boot(4)
can be 0-6, s, or S.
This keyword is particularly useful if a problem causes
your system to fail before it reaches networking state.
For example, if you have selected the wrong video
driver, the graphical login will not start. If you
interrupt a reboot, and define INITSTATE to be s, you
can boot to single-user state, and correct the problem.
KERNEL=filename
Define this keyword to change the name of the kernel
file to boot. As delivered, the default is unix.
During a user-initiated interactive session, the current
value of KERNEL is the default file used when boot times
out.
For example, KERNEL=myunix will direct the boot program
to load the /stand/myunix file.
LUNSEARCH=(c:b,t,l)[, ...]
Define this keyword to specify devices that should not
be accessed beyond LUN 0. The argument c specifies the
controller, b specifies the bus, t the target, and l the
LUN of the device causing problems. The parentheses are
required, but any of the arguments may be omitted. If
omitted, all valid values for that argument are matched.
For example,
LUNSEARCH=(0:0,3),(1)
means that on controller 0, bus 0, the device at target
3 should be accessed only at LUN 0, and all devices on
controller 1 should be accessed only at LUN 0.
The following example limits device searching to LUN 0
for all devices:
LUNSEARCH=()
MEMRANGE=range:flag[,range:flag . . .]
This keyword specifies where to look when sizing memory.
A range is a pair of decimal addresses, separated by a
dash such as 1M-4M. The flag indicates how the range
should be interpreted. The following flags are
recognized:
Copyright 1994 Novell, Inc. Page 3
boot(4) boot(4)
256 - B_MEM_BASE (0x100)
512 - B_MEM_EXPAN (0x200)
8704 - B_MEM_FORCE (0x2000) + B_MEM_EXPAN
If /stand/boot does not exist, the boot program uses the
CMOS values as the maximum when probing for RAM (default
case). If /stand/boot does exist, use the MEMRANGE
entry to override the CMOS values.
If flag is 256 (B_MEM_BASE), this range of memory will
be interpreted by the system as base memory.
If flag is 512 (B_MEM_EXPAN), this range of memory will
be interpreted by the kernel as expanded memory.
If flag is 8704 (B_MEM_FORCE), the kernel will ignore
the CMOS setting for that range. The CMOS setting can
only be ignored for memory above 16MB and only if the
initial address of the range is above 16MB.
In addresses, use ``M'' to indicate megabytes and ``K''
to indicate kilobytes. The first address in the pair is
inclusive; the last address is exclusive. When sizing
the base memory (0-640K usually) the boot code checks
the CMOS for the current base memory setting. If this
value is less than the current base memory value, the
kernel uses this lower value instead of 640K.
Examples :
Probe for the minimum of 4M or the CMOS values:
MEMRANGE=0-640K:256,1M-4M:512
Probe for 64MB and ignore the CMOS values as the
maximum:
MEMRANGE=0-640K:256,1M-16M:512,16M-64M:8704
MIP=filename
Define this keyword to override the default filename for
the Machine-dependent Interface Program. The default is
mip.
REBOOTMSG=string
Define this keyword to change the message issued when a
user requests a reboot. If defined, this keyword will
override the default message, "Press any key to
Copyright 1994 Novell, Inc. Page 4
boot(4) boot(4)
reboot..."
RESMGR=filename
Define this keyword to name the file in /stand from
which to load the Resource Manager database. The
default file is /stand/resmgr. This keyword is useful
if /stand/resmgr gets corrupted. The backup file is
/stand/resmgr.sav.
rootdev=device(minor)
This keyword overrides the default configuration of the
root disk device specified in Sassign(4) when the kernel
was built. Minor number minor of the block device named
device will be used instead.
rootfs=fstype
This keyword overrides the default root filesystem type
built into the kernel from the ROOTFSTYPE tunable
parameter. The root filesystem will be assumed to be of
type fstype instead: (ufs or vxfs, for example.) If
fstype is blank, all configured filesystem types will be
tried until one succeeds in mounting the root
filesystem.
SIP=filename
Define this keyword to override the default filename for
the System-dependent Interface Program. The default is
sip.
SLOWBOOT=val
Define this keyword to designate the length of time, in
seconds, to wait after the beep is sounded before
continuing the booting process. This is useful if you
frequently initiate an interactive boot session in order
to add new parameters or alter existing ones.
Example: SLOWBOOT=5 will cause the boot program to wait
5 seconds after the beep before continuing.
STARTUPMSG=string
Define this keyword to change the last message issued
before user processes are started. The default message
that this keyword, if defined, will override is "The
system is coming up. Please wait."
Copyright 1994 Novell, Inc. Page 5
boot(4) boot(4)
TIMEOUT=number
If boot is waiting for a boot line from the user and
TIMEOUT is set, boot waits for number seconds, then uses
the default boot line defined by KERNEL.
TITLE=string
Define this keyword to change the default product name
to string. The string may contain ``%'' tokens that
will be replaced by information available from the
sysinfo(2) system call as shown in the following table:
%a - SI_ARCHITECTURE string
%i - SI_INITTAB_NAME string
%m - SI_MACHINE string (uname -m)
%n - SI_HOSTNAME string (uname -n)
%p - SI_HW_PROVIDER string
%r - SI_RELEASE string (uname -r)
%s - SI_SYSNAME string (uname -s)
%v - SI_VERSION string (uname -v)
%% - a percent sign
For example, the following string might be used:
UNIX System V Release %r Version %v for the %a Family
This keyword can be defined multiple times, to
accommodate product names that are more than one line
long.
variable=value
All other lines of the form variable=value are passed to
the kernel.
FILES
/stand/boot
REFERENCES
boot(1M)
Copyright 1994 Novell, Inc. Page 6