2011-04-15 20:48:57 +00:00
|
|
|
.TH 9BOOT 8
|
|
|
|
|
.SH NAME
|
2011-06-12 14:33:14 +00:00
|
|
|
9bootfat, 9bootiso, 9bootpxe \- PC bootloader for FAT, ISO and PXE network booting
|
2011-04-15 20:48:57 +00:00
|
|
|
.SH SYNOPSIS
|
2011-07-13 20:50:06 +00:00
|
|
|
Started by PC BIOS or chainloaded by partition bootsector
|
2011-04-15 20:48:57 +00:00
|
|
|
.SH DESCRIPTION
|
2011-06-12 14:33:14 +00:00
|
|
|
9boot is the bootloader used on PCs to start the Plan 9 kernel.
|
|
|
|
|
Its task is to read and parse the
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR plan9.ini (8)
|
2011-06-12 14:33:14 +00:00
|
|
|
configuration file, gather some basic system information like
|
2011-07-13 20:50:06 +00:00
|
|
|
the amount of usable system memory, do some basic system
|
2011-06-12 14:33:14 +00:00
|
|
|
initialization and load the kernel from the boot media into memory.
|
|
|
|
|
|
|
|
|
|
After reading the configuration, the loader will automatically
|
|
|
|
|
attempt to boot the kernel that was specified by the
|
2011-04-15 20:48:57 +00:00
|
|
|
.B bootfile=
|
2011-06-12 14:33:14 +00:00
|
|
|
parameter. If there is no such parameter, a key
|
|
|
|
|
gets pressed on the keyboard or the kernel file was not
|
|
|
|
|
found then the loader enters the interactive
|
|
|
|
|
boot console.
|
|
|
|
|
|
2013-02-17 08:30:02 +00:00
|
|
|
The syntax of the boot console is the same as in the
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR plan9.ini (8)
|
2013-02-17 08:30:02 +00:00
|
|
|
file with
|
|
|
|
|
.IB key = value
|
|
|
|
|
pairs setting boot parameters. In addition a few command
|
|
|
|
|
words are recognized that are intended for interactive use:
|
|
|
|
|
.TP
|
|
|
|
|
.BI clear [prefix]
|
|
|
|
|
can be used to remove parameters from the configuration.
|
2011-06-12 14:33:14 +00:00
|
|
|
If a
|
|
|
|
|
.IR prefix
|
|
|
|
|
is specified, the first parameter that matches the prefix
|
|
|
|
|
is removed. If the
|
|
|
|
|
.IR prefix
|
2011-07-13 20:50:06 +00:00
|
|
|
argument is omitted, the whole configuration will be reset.
|
2013-02-17 08:30:02 +00:00
|
|
|
.TP
|
|
|
|
|
.B show
|
|
|
|
|
displays the current configuration in memory.
|
|
|
|
|
.TP
|
2011-11-09 14:26:26 +00:00
|
|
|
.B wait
|
2013-02-17 08:30:02 +00:00
|
|
|
will return to the console prompt after processing the
|
|
|
|
|
configuration file preventing automatic boot.
|
|
|
|
|
.TP
|
2011-04-15 20:48:57 +00:00
|
|
|
.B boot
|
2013-02-17 08:30:02 +00:00
|
|
|
will end the console and attempt booting the kernel.
|
|
|
|
|
.SS
|
2011-06-12 14:33:14 +00:00
|
|
|
There are many ways to boot a PC so
|
|
|
|
|
.IR 9boot
|
|
|
|
|
was split into a number of distinct programs one for each boot
|
|
|
|
|
method.
|
2011-04-15 20:48:57 +00:00
|
|
|
.SH FAT BOOTING
|
2011-06-12 14:33:14 +00:00
|
|
|
When booting Plan 9 from a harddisk or USB pen drive, a
|
2011-07-13 20:50:06 +00:00
|
|
|
FAT16/32 partition
|
|
|
|
|
.IR (9fat)
|
|
|
|
|
is used to store the kernel and
|
2011-05-04 09:02:04 +00:00
|
|
|
.IR plan9.ini (8)
|
2011-06-12 14:33:14 +00:00
|
|
|
configuration. Due to size limitations, instead of loading
|
2011-07-13 20:50:06 +00:00
|
|
|
the kernel directly, the bootsector
|
|
|
|
|
.IR (pbs)
|
|
|
|
|
of the FAT partition loads
|
2011-06-12 14:33:14 +00:00
|
|
|
a 2nd stage bootloader
|
2011-07-13 20:50:06 +00:00
|
|
|
.IR (9bootfat)
|
2011-06-12 14:33:14 +00:00
|
|
|
from the root directory of the filesystem.
|
2011-04-17 08:17:01 +00:00
|
|
|
.SH CD-ROM BOOTING
|
2011-07-13 20:50:06 +00:00
|
|
|
Booting from CD-ROM requires only the
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR 9bootiso
|
2011-07-13 20:50:06 +00:00
|
|
|
bootloader to be included in the ISO-9660 image under
|
2011-04-17 08:17:01 +00:00
|
|
|
.B 386/9bootiso,
|
2011-07-13 20:50:06 +00:00
|
|
|
set as a non-emulation bootblock (see
|
2011-04-18 01:18:36 +00:00
|
|
|
.IR mk9660 (8)).
|
2011-04-15 20:48:57 +00:00
|
|
|
Boot parameters are read from
|
2011-04-17 08:17:01 +00:00
|
|
|
.B cfg/plan9.ini.
|
2011-04-15 20:48:57 +00:00
|
|
|
.SH NETWORK BOOTING
|
2011-06-12 14:33:14 +00:00
|
|
|
With a PXE capable BIOS and network card one can download
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR 9bootpxe
|
2011-06-12 14:33:14 +00:00
|
|
|
and boot the kernel from a TFTP server (see
|
2011-07-13 20:50:06 +00:00
|
|
|
.IR dhcpd (8)
|
|
|
|
|
and
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR ndb (6)
|
2011-06-12 14:33:14 +00:00
|
|
|
for details). Once started,
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR 9bootpxe
|
|
|
|
|
will read the file
|
|
|
|
|
.B /cfg/pxe/$ether
|
2012-08-21 12:23:52 +00:00
|
|
|
or, if this file is not present,
|
|
|
|
|
.B /cfg/pxe/default
|
2011-04-15 20:48:57 +00:00
|
|
|
from the tftp server, where
|
|
|
|
|
.B $ether
|
2011-04-17 08:17:01 +00:00
|
|
|
is the MAC address of the client's network card
|
2012-08-21 12:23:52 +00:00
|
|
|
in lower case hex, and uses this as its
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR plan9.ini (8)
|
|
|
|
|
file.
|
2011-06-12 14:33:14 +00:00
|
|
|
.SH FILES
|
|
|
|
|
.B /386/pbs
|
2011-07-13 20:50:06 +00:00
|
|
|
.br
|
2011-06-12 14:33:14 +00:00
|
|
|
.B /386/9bootfat
|
2011-07-13 20:50:06 +00:00
|
|
|
.br
|
2011-06-12 14:33:14 +00:00
|
|
|
.B /386/9bootiso
|
2011-07-13 20:50:06 +00:00
|
|
|
.br
|
2011-06-12 14:33:14 +00:00
|
|
|
.B /386/9bootpxe
|
2011-06-12 14:48:03 +00:00
|
|
|
.SH SOURCE
|
2011-07-13 20:50:06 +00:00
|
|
|
.BR /sys/src/boot/pc
|
2011-06-12 14:33:14 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.IR plan9.ini (8)
|
