sys/man/8/9boot

   1 .TH 9BOOT 8
   2 .SH NAME
   3 9bootfat, 9bootiso, 9bootpxe \- bootloaders for pc FAT, ISO and PXE network booting
   4 .SH SYNOPSIS
   5 started by BIOS or chainloaded by partition bootsector
   6 .SH DESCRIPTION
   7 The bootloader is responsible for reading the
   8 .IR plan9.ini (8)
   9 boot parameters and boot a kernel. It interprets the
  10 .B bootfile=
  11 parameter as a file path on the current boot media
  12 to locate the kernel image. The path should be in all
  13 lower case except for
  14 .IR 9bootpxe
  15 wich supports case sensitive file names. Read parameters
  16 are echoed on the console. The boot procedure
  17 can be interrupted by pressing any key after the configuration
  18 was read. Then a interactive boot console is shown with a
  19 .B >
  20 prompt. The syntax of the boot console is the same as in
  21 the
  22 .IR plan9.ini (8)
  23 file. The word
  24 .B clear
  25 will reset all current parameters and
  26 .B boot
  27 will end the console and start booting the kernel. The boot
  28 console is entered automatically when boot failed, no
  29 .B bootfile=
  30 parameter is specified or no
  31 .IR plan9.ini (8)
  32 was found.
  33 .SH FAT BOOTING
  34 The
  35 .IR 9bootfat
  36 program is responsible for loading the kernel from
  37 the
  38 .IR 9fat
  39 partition into memory and pass it the
  40 .IR plan9.ini (8)
  41 boot parameters. It gets chainloaded by
  42 .IR pbs
  43 wich locates it in the root of the active
  44 FAT partition as
  45 .B 9BOOTFAT
  46 file.
  47 Then
  48 .B plan9.ini
  49 is read from the root directory of the FAT
  50 filesystem.
  51 .SH CDROM BOOTING
  52 Booting from cdrom requires
  53 .IR 9bootiso
  54 to be included in the iso image under
  55 .B 386/9bootiso
  56 and also
  57 set as a non emulation bootblock see
  58 .IR mk9660 (8) .
  59 The BIOS loads the first 2K of
  60 .B 386/9bootiso
  61 into memory and passes execution to it. The program
  62 then reads the rest of its code from the file to chainload itself.
  63 Boot parameters are read from
  64 .B cfg/plan9.ini
  65 file.
  66 .SH NETWORK BOOTING
  67 With a PXE capable BIOS and network card, it is possible for
  68 a machine to download
  69 .IR 9bootpxe
  70 from a tftp server and load the kernel from there. The
  71 .B bootf=/386/9bootpxe
  72 in the machines
  73 .IR ndb (6)
  74 entry will tell the PXE BIOS to use it.
  75 .BR
  76 Once started,
  77 .IR 9bootpxe
  78 will read the file
  79 .B /cfg/pxe/$ether
  80 from the tftp server, where
  81 .B $ether
  82 is the mac address of the used network card
  83 in lower case hex, and use it as
  84 .IR plan9.ini (8)
  85 file.
  86 .SH SOURCE
  87 .BR /sys/src/boot/pc .