2011-04-15 20:48:57 +00:00
|
|
|
.TH 9BOOT 8
|
|
|
|
|
.SH NAME
|
|
|
|
|
9bootfat, 9bootiso, 9bootpxe \- bootloaders for pc FAT, ISO and PXE network booting
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
started by BIOS or chainloaded by partition bootsector
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The bootloader is responsible for reading the
|
|
|
|
|
.IR plan9.ini (8)
|
2011-04-17 08:17:01 +00:00
|
|
|
boot parameters and booting a kernel. It interprets the
|
2011-04-15 20:48:57 +00:00
|
|
|
.B bootfile=
|
|
|
|
|
parameter as a file path on the current boot media
|
|
|
|
|
to locate the kernel image. The path should be in all
|
|
|
|
|
lower case except for
|
|
|
|
|
.IR 9bootpxe
|
|
|
|
|
wich supports case sensitive file names. Read parameters
|
|
|
|
|
are echoed on the console. The boot procedure
|
|
|
|
|
can be interrupted by pressing any key after the configuration
|
2011-04-17 08:17:01 +00:00
|
|
|
was read. The interactive boot console is indicated with a
|
2011-04-15 20:48:57 +00:00
|
|
|
.B >
|
|
|
|
|
prompt. The syntax of the boot console is the same as in
|
|
|
|
|
the
|
|
|
|
|
.IR plan9.ini (8)
|
|
|
|
|
file. The word
|
|
|
|
|
.B clear
|
2011-04-17 08:17:01 +00:00
|
|
|
will reset all current parameters. The word
|
2011-04-15 20:48:57 +00:00
|
|
|
.B boot
|
2011-04-17 08:17:01 +00:00
|
|
|
will end the console and resume booting the kernel. The boot
|
|
|
|
|
console is entered automatically when: boot failed, no
|
2011-04-15 20:48:57 +00:00
|
|
|
.B bootfile=
|
2011-04-17 08:17:01 +00:00
|
|
|
parameter was specified or no
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR plan9.ini (8)
|
|
|
|
|
was found.
|
|
|
|
|
.SH FAT BOOTING
|
|
|
|
|
The
|
|
|
|
|
.IR 9bootfat
|
|
|
|
|
program is responsible for loading the kernel from
|
|
|
|
|
the
|
|
|
|
|
.IR 9fat
|
2011-04-17 08:17:01 +00:00
|
|
|
partition into memory and passing it the
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR plan9.ini (8)
|
2011-04-17 08:17:01 +00:00
|
|
|
boot parameters. It is chainloaded by
|
|
|
|
|
.IR pbs,
|
2011-04-15 20:48:57 +00:00
|
|
|
wich locates it in the root of the active
|
2011-04-17 08:17:01 +00:00
|
|
|
FAT partition. The
|
2011-05-04 09:02:04 +00:00
|
|
|
.IR plan9.ini (8)
|
2011-04-17 08:17:01 +00:00
|
|
|
file is read from the root directory of the FAT
|
2011-04-15 20:48:57 +00:00
|
|
|
filesystem.
|
2011-04-17 08:17:01 +00:00
|
|
|
.SH CD-ROM BOOTING
|
|
|
|
|
Booting from CD-ROM requires
|
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
|
|
|
The BIOS loads the first 2K of
|
|
|
|
|
.B 386/9bootiso
|
2011-04-17 08:17:01 +00:00
|
|
|
into memory and then executes the program. The remainder
|
|
|
|
|
of the file is then read to complete the chainloading process.
|
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-04-17 08:17:01 +00:00
|
|
|
With a PXE capable BIOS and network card it is possible for
|
2011-04-15 20:48:57 +00:00
|
|
|
a machine to download
|
|
|
|
|
.IR 9bootpxe
|
2011-04-17 08:17:01 +00:00
|
|
|
and a kernel from a tftp server. The location of
|
|
|
|
|
.IR 9bootpxe
|
|
|
|
|
is defined by the
|
2011-04-15 20:48:57 +00:00
|
|
|
.B bootf=/386/9bootpxe
|
2011-04-17 08:17:01 +00:00
|
|
|
line in the tftp server's
|
2011-04-15 20:48:57 +00:00
|
|
|
.IR ndb (6)
|
2011-04-17 08:17:01 +00:00
|
|
|
entry.
|
2011-04-15 20:48:57 +00:00
|
|
|
.BR
|
|
|
|
|
Once started,
|
|
|
|
|
.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.
|
|
|
|
|
.SH SOURCE
|
|
|
|
|
.BR /sys/src/boot/pc .
|
