ref: 1a595c50d150b3903e59720cd2061448a718d370
parent: 4dcefa6941fe927195d853acb7a19fb82e5bca70
author: cinap_lenrek <cinap_lenrek@centraldogma>
date: Fri Apr 15 16:48:57 EDT 2011
update manpages for 9boot
--- /dev/null
+++ b/sys/man/8/9boot
@@ -1,0 +1,87 @@
+.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)
+boot parameters and boot a kernel. It interprets the
+.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
+was read. Then a interactive boot console is shown with a
+.B >
+prompt. The syntax of the boot console is the same as in
+the
+.IR plan9.ini (8)
+file. The word
+.B clear
+will reset all current parameters and
+.B boot
+will end the console and start booting the kernel. The boot
+console is entered automatically when boot failed, no
+.B bootfile=
+parameter is specified or no
+.IR plan9.ini (8)
+was found.
+.SH FAT BOOTING
+The
+.IR 9bootfat
+program is responsible for loading the kernel from
+the
+.IR 9fat
+partition into memory and pass it the
+.IR plan9.ini (8)
+boot parameters. It gets chainloaded by
+.IR pbs
+wich locates it in the root of the active
+FAT partition as
+.B 9BOOTFAT
+file.
+Then
+.B plan9.ini
+is read from the root directory of the FAT
+filesystem.
+.SH CDROM BOOTING
+Booting from cdrom requires
+.IR 9bootiso
+to be included in the iso image under
+.B 386/9bootiso
+and also
+set as a non emulation bootblock see
+.IR mk9660 (8) .
+The BIOS loads the first 2K of
+.B 386/9bootiso
+into memory and passes execution to it. The program
+then reads the rest of its code from the file to chainload itself.
+Boot parameters are read from
+.B cfg/plan9.ini
+file.
+.SH NETWORK BOOTING
+With a PXE capable BIOS and network card, it is possible for
+a machine to download
+.IR 9bootpxe
+from a tftp server and load the kernel from there. The
+.B bootf=/386/9bootpxe
+in the machines
+.IR ndb (6)
+entry will tell the PXE BIOS to use it.
+.BR
+Once started,
+.IR 9bootpxe
+will read the file
+.B /cfg/pxe/$ether
+from the tftp server, where
+.B $ether
+is the mac address of the used network card
+in lower case hex, and use it as
+.IR plan9.ini (8)
+file.
+.SH SOURCE
+.BR /sys/src/boot/pc .
--- a/sys/man/8/booting
+++ b/sys/man/8/booting
@@ -24,9 +24,10 @@
other methods of rebooting are mentioned for some machines.
.SS PCs
To boot a PC, it is necessary to get
-.B /386/9load
+.B /386/9bootfat
+.B /386/9bootiso
or
-.B /386/9pxeload
+.B /386/9bootpxe
loaded into memory.
There are many ways to do this. A Plan 9 boot floppy prepared by
.B format
@@ -33,11 +34,11 @@
(see
.IR prep (8))
will load
-.B 9load
+.B 9bootfat
when the PC is reset or powered on.
Other methods are described in
-.IR 9load (8).
-.B 9load
+.IR 9boot (8).
+.B 9boot
then locates and loads a Plan 9 kernel, using configuration information
from the file
.B plan9.ini
@@ -45,7 +46,7 @@
.B 9fat
configuration partition or on a DOS file system.
See
-.IR 9load (8)
+.IR 9boot (8)
for details.
.PP
Once the kernel is booted, it behaves like the others.
@@ -252,7 +253,7 @@
.
.SH "SEE ALSO"
.IR ndb (6),
-.IR 9load (8),
+.IR 9boot (8),
.IR boot (8),
.IR init (8),
.IR plan9.ini (8)
--- a/sys/man/8/plan9.ini
+++ b/sys/man/8/plan9.ini
@@ -43,9 +43,7 @@
Not all elements are relevant to all devices; the relevant values
and their defaults are defined below in the description of each device.
.PP
-The file is used by
-.B 9load
-and the kernel to configure the hardware available.
+The file is used by the kernel to configure the hardware available.
The information it contains is also passed to the boot
process, and subsequently other programs,
as environment variables
@@ -397,6 +395,8 @@
.
.SS DISKS, TAPES
(S)ATA controllers are autodetected.
+.SS \fL*nodma=\fP
+disable DMA on ata devices.
.SS \fLusbX=type=uhci\fP
.SS \fLusbX=type=ohci\fP
This specifies the settings for a USB UHCI or OHCI controller.
@@ -582,23 +582,9 @@
.SS BOOTING
.SS \fLbootfile=value\fP
This is used to direct the actions of
-.IR 9load (8)
-by naming the device and file from which to load the kernel.
-.SS \fLrootdir=dir\fP
-.SS \fLrootspec=spec\fP
-These are used by
-.IR 9load (8)
-to identify the directory
-.I dir
-to make the root directory for the kernel, and the
-file system specifier
-.I spec
-(see
-.B mount
-in
-.IR bind (2))
-on which it can be found.
-These are usually used to test variant file systems for distributions, etc.
+.IR 9boot (8)
+by naming the file from which to load the kernel in
+the current BIOS boot device.
.SS \fLbootargs=value\fP
The value of this variable is passed to
.IR boot (8)
@@ -834,74 +820,6 @@
.I unit
is the numeric unit id.
This variant syntax is a vestige of the file server kernel's origins.
-.SH Multiple Configurations
-.PP
-A
-.B plan9.ini
-file may contain multiple configurations,
-each within a block beginning with a line
-.EX
- [tag]
-.EE
-A special block with the tag
-.B menu
-gives a list of blocks from which the user may
-interactively select the contents of
-.BR plan9.ini .
-There may also be multiple blocks with the tag
-.B common
-which will be included in all selections;
-if any lines appear in
-.B plan9.ini
-before the first block,
-they are treated as a
-.B common
-block.
-.LP
-Within the
-.B menu
-block the following configuration lines are allowed:
-.SS \fLmenuitem=tag[, description]
-The block identified by
-.B tag
-will appear in the presented menu.
-The menu entry will consist of the
-.B tag
-unless the optional
-.B description
-is given.
-.SS \fLmenudefault=tag[, timeout]
-Identifies a default block to be given in the
-menu selection prompt.
-If the optional
-.B timeout
-is given (in seconds),
-the default block will be selected if there is no user
-input within the timeout period.
-.SS \fLmenuconsole=value[, baud]
-Selects a serial console upon which to present the menu
-as no
-.B console
-or
-.B baud
-configuration information will have been processed yet
-(the
-.B plan9.ini
-contents are still to be decided...).
-.LP
-In response to the menu being printed,
-the user is prompted to select a menu item from the list.
-If the numeric response is followed by a
-.BR p ,
-the selected configuration is printed and the menu presented
-again.
-.LP
-The line
-.EX
- menuitem=tag
-.EE
-is prefixed to the selected configuration as an aid to
-user-level initialization scripts.
.SH EXAMPLES
.PP
A representative
@@ -908,7 +826,7 @@
.BR plan9.ini :
.IP
.EX
-% cat /n/c:/plan9.ini
+% cat /n/9fat:/plan9.ini
ether0=type=3C509
mouseport=ps2
modemport=1
@@ -915,76 +833,11 @@
serial0=type=generic port=0x3E8 irq=5
monitor=445x
vgasize=1600x1200x8
+bootfile=/386/9pcf
%
.EE
-.PP
-Minimum CONFIG.SYS and AUTOEXEC.BAT files to use
-COM2 as a console:
-.IP
-.EX
-% cat /n/c:/config.sys
-SHELL=COMMAND.COM COM2 /P
-% cat /n/c:/autoexec.bat
-@ECHO OFF
-PROMPT $p$g
-PATH C:\eDOS;C:\eBIN
-mode com2:96,n,8,1,p
-SET TEMP=C:\eTMP
-%
-.EE
-.PP
-Simple
-.B plan9.ini
-with multiple configurations:
-.IP
-.EX
-[menu]
-menuitem=vga, Plan 9 with VGA
-menuitem=novga, Plan 9 no automatic VGA
-menudefault=vga
-
-[vga]
-monitor=multisync135
-vgasize=1024x768x8
-
-[novga]
-
-[common]
-ether0=type=i82557
-audio0=type=sb16 port=0x220 irq=5 dma=1
-.EE
-.PP
-With this, the following menu will be presented on boot:
-.IP
-.EX
-Plan 9 Startup Menu:
-====================
- 1. Plan 9 with VGA
- 2. Plan 9 no automatic VGA
-Selection[default==1]:
-.EE
-.PP
-Selecting item 1 generates the following
-.B plan9.ini
-to be used by the remainder of the bootstrap process:
-.IP
-.EX
-menuitem=vga
-monitor=multisync135
-vgasize=1024x768x8
-ether0=type=i82557
-audio0=type=sb16 port=0x220 irq=5 dma=1
-.EE
-.PP
-and selecting item 2:
-.IP
-.EX
-menuitem=novga
-ether0=type=i82557
-audio0=type=sb16 port=0x220 irq=5 dma=1
-.EE
.SH "SEE ALSO"
-.IR 9load (8),
+.IR 9boot (8),
.IR booting (8),
.IR boot (8)
.SH BUGS