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-06-12 14:33:14 +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
|
|
|
|
|
the amount of usable system memory, do some low level system
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
The syntax of the boot console is the same as in
|
2011-04-15 20:48:57 +00:00
|
|
|
the
|
|
|
|
|
.IR plan9.ini (8)
|
2011-06-12 14:33:14 +00:00
|
|
|
file.
|
|
|
|
|
.BR
|
|
|
|
|
The word
|
|
|
|
|
.B clear [
|
|
|
|
|
.I prefix
|
|
|
|
|
]
|
|
|
|
|
can be used to remove parameters from the current configuration.
|
|
|
|
|
If a
|
|
|
|
|
.IR prefix
|
|
|
|
|
is specified, the first parameter that matches the prefix
|
|
|
|
|
is removed. If the
|
|
|
|
|
.IR prefix
|
|
|
|
|
argument is omited, the whole configuration will be reset.
|
|
|
|
|
.BR
|
|
|
|
|
The word
|
2011-04-15 20:48:57 +00:00
|
|
|
.B boot
|
2011-06-12 14:33:14 +00:00
|
|
|
will end the console and resume booting the kernel.
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
FAT16/32 partition (
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR 9fat
|
2011-06-12 14:33:14 +00:00
|
|
|
) 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
|
|
|
|
|
the kernel directly, the bootsector (
|
|
|
|
|
.IR pbs
|
|
|
|
|
) of the FAT partition loads
|
|
|
|
|
a 2nd stage bootloader
|
|
|
|
|
.IR 9bootfat
|
|
|
|
|
from the root directory of the filesystem.
|
2011-04-17 08:17:01 +00:00
|
|
|
.SH CD-ROM BOOTING
|
2011-06-12 14:33:14 +00:00
|
|
|
Booting from CD-ROM requires only
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR 9bootiso
|
2011-04-17 08:17:01 +00:00
|
|
|
to be included in the ISO-9660 image under
|
|
|
|
|
.B 386/9bootiso,
|
2011-04-18 01:18:36 +00:00
|
|
|
set as a non emulation bootblock (see
|
|
|
|
|
.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
|
|
|
|
|
.IR dhcpd (8),
|
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
|
|
|
|
|
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
|
|
|
|
|
in lower case hex, and use 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
|
|
|
|
|
.TP
|
|
|
|
|
.B /386/pbs
|
|
|
|
|
.TP
|
|
|
|
|
.B /386/9bootfat
|
|
|
|
|
.TP
|
|
|
|
|
.B /386/9bootiso
|
|
|
|
|
.TP
|
|
|
|
|
.B /386/9bootpxe
|
2011-06-12 14:48:03 +00:00
|
|
|
.SH SOURCE
|
|
|
|
|
.BR /sys/src/boot/pc .
|
2011-06-12 14:33:14 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.IR plan9.ini (8)
|
