xfnw/plan9fox
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

9boot(8): improve efi documentation

Browse source
This commit is contained in:
cinap_lenrek 2014-11-02 21:22:03 +01:00
parent c82569c6dd
commit 9916e03947
1 changed files with 46 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
sys/man/8/9boot
View file

@ -2,7 +2,7 @@
.SH NAME .SH NAME
9bootfat, 9bootiso, 9bootpxe, bootia32.efi, bootx64.efi, efiboot.fat \- PC bootloader for FAT, ISO and PXE network booting 9bootfat, 9bootiso, 9bootpxe, bootia32.efi, bootx64.efi, efiboot.fat \- PC bootloader for FAT, ISO and PXE network booting
.SH SYNOPSIS .SH SYNOPSIS
Started by PC BIOS or chainloaded by partition bootsector Started by PC BIOS/EFI or chainloaded by partition bootsector
.SH DESCRIPTION .SH DESCRIPTION
9boot is the bootloader used on PCs to start the Plan 9 kernel. 9boot is the bootloader used on PCs to start the Plan 9 kernel.
Its task is to read and parse the Its task is to read and parse the
@ -66,11 +66,13 @@ from the root directory of the filesystem.
Booting from CD-ROM requires only the Booting from CD-ROM requires only the
.IR 9bootiso .IR 9bootiso
bootloader to be included in the ISO-9660 image under bootloader to be included in the ISO-9660 image under
.B 386/9bootiso, .BR /386/9bootiso ,
set as a non-emulation bootblock (see set as a non-emulation bootblock (see
.B -B
in
.IR mk9660 (8)). .IR mk9660 (8)).
Boot parameters are read from Boot parameters are read from
.B cfg/plan9.ini. .BR /cfg/plan9.ini .
.SH NETWORK BOOTING .SH NETWORK BOOTING
With a PXE capable BIOS and network card one can download With a PXE capable BIOS and network card one can download
.IR 9bootpxe .IR 9bootpxe
@ -92,19 +94,47 @@ in lower case hex, and uses this as its
file. file.
.SH EFI BOOTING .SH EFI BOOTING
EFI firmware looks for the files EFI firmware looks for the files
.B bootia32.efi .I bootia32.efi
(for 386) (for 386)
or or
.B bootx64.efi .I bootx64.efi
(for amd64) (for amd64)
in the directory in the boot media and executes them.
For local disk media, these files are located in the directory
.B /efi/boot .B /efi/boot
of the EFI boot partition and executes them. of the
Once started, the file .B FAT
.B /plan9.ini formated boot partition.
is read from the boot partition and interpretated in For
the same way as with .B CD-ROM
BIOS booting. media, the boot partition is provided
as a embedded
.B FAT
filesystem image
.I efiboot.fat
(see the
.B -E
in
.IR mk9660 (8)).
In the network boot case, the
.I bootia32.efi
or
.I bootx64.efi
files are used as the
.B BSP
program instead of
.IR 9bootpxe .
Once started, the boot media
.RB ( PXE ,
.BR ISO ,
.BR FAT )
is discovered and
.IR plan9.ini (8)
configuration is read from from it in the same way as
with the BIOS-based
.I 9boot*
loaders.
.SH FILES .SH FILES
.B /386/pbs .B /386/pbs
.br .br
@ -125,7 +155,10 @@ BIOS booting.
.BR /sys/src/boot/efi .BR /sys/src/boot/efi
.br .br
.SH "SEE ALSO" .SH "SEE ALSO"
.IR plan9.ini (8) .IR plan9.ini (8),
.IR mk9660 (8),
.IR dhcpd (8),
.IR ndb (6)
.SH HISTORY .SH HISTORY
9boot first appeared in 9front (April, 2011). 9boot first appeared in 9front (April, 2011).
EFI support first appeared in 9front (Oct, 2014). EFI support first appeared in 9front (Oct, 2014).