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 booting 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. The interactive boot console is indicated 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. The word
  26 .B boot
  27 will end the console and resume booting the kernel. The boot
  28 console is entered automatically when: boot failed, no
  29 .B bootfile=
  30 parameter was 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 passing it the
  40 .IR plan9.ini (8)
  41 boot parameters. It is chainloaded by
  42 .IR pbs,
  43 wich locates it in the root of the active
  44 FAT partition. The
  45 .B plan9.ini (8)
  46 file is read from the root directory of the FAT
  47 filesystem.
  48 .SH CD-ROM BOOTING
  49 Booting from CD-ROM requires
  50 .IR 9bootiso
  51 to be included in the ISO-9660 image under
  52 .B 386/9bootiso,
  53 set as a non emulation bootblock (see
  54 .IR mk9660 (8)).
  55 The BIOS loads the first 2K of
  56 .B 386/9bootiso
  57 into memory and then executes the program. The remainder
  58 of the file is then read to complete the chainloading process.
  59 Boot parameters are read from
  60 .B cfg/plan9.ini.
  61 .SH NETWORK BOOTING
  62 With a PXE capable BIOS and network card it is possible for
  63 a machine to download
  64 .IR 9bootpxe
  65 and a kernel from a tftp server. The location of
  66 .IR 9bootpxe
  67 is defined by the
  68 .B bootf=/386/9bootpxe
  69 line in the tftp server's
  70 .IR ndb (6)
  71 entry.
  72 .BR
  73 Once started,
  74 .IR 9bootpxe
  75 will read the file
  76 .B /cfg/pxe/$ether
  77 from the tftp server, where
  78 .B $ether
  79 is the MAC address of the client's network card
  80 in lower case hex, and use this as its
  81 .IR plan9.ini (8)
  82 file.
  83 .SH SOURCE
  84 .BR /sys/src/boot/pc .