sys/man/8/9boot

   1 .TH 9BOOT 8
   2 .SH NAME
   3 9bootfat, 9bootiso, 9bootpxe \- PC bootloader for FAT, ISO and PXE network booting
   4 .SH SYNOPSIS
   5 started by PC BIOS or chainloaded by partition bootsector
   6 .SH DESCRIPTION
   7 9boot is the bootloader used on PCs to start the Plan 9 kernel.
   8 Its task is to read and parse the
   9 .IR plan9.ini (8)
  10 configuration file, gather some basic system information like
  11 the amount of usable system memory, do some low level system
  12 initialization and load the kernel from the boot media into memory.
  13
  14 After reading the configuration, the loader will automatically
  15 attempt to boot the kernel that was specified by the
  16 .B bootfile=
  17 parameter. If there is no such parameter, a key
  18 gets pressed on the keyboard or the kernel file was not
  19 found then the loader enters the interactive
  20 boot console.
  21
  22 The syntax of the boot console is the same as in
  23 the
  24 .IR plan9.ini (8)
  25 file.
  26 .BR
  27 The word
  28 .B clear [
  29 .I prefix
  30 ]
  31 can be used to remove parameters from the current configuration.
  32 If a
  33 .IR prefix
  34 is specified, the first parameter that matches the prefix
  35 is removed. If the
  36 .IR prefix
  37 argument is omited, the whole configuration will be reset.
  38 .BR
  39 The word
  40 .B boot
  41 will end the console and resume booting the kernel.
  42
  43 There are many ways to boot a PC so
  44 .IR 9boot
  45 was split into a number of distinct programs one for each boot
  46 method.
  47 .SH FAT BOOTING
  48 When booting Plan 9 from a harddisk or USB pen drive, a
  49 FAT16/32 partition (
  50 .IR 9fat
  51 ) is used to store the kernel and
  52 .IR plan9.ini (8)
  53 configuration. Due to size limitations, instead of loading
  54 the kernel directly, the bootsector (
  55 .IR pbs
  56 ) of the FAT partition loads
  57 a 2nd stage bootloader
  58 .IR 9bootfat
  59 from the root directory of the filesystem.
  60 .SH CD-ROM BOOTING
  61 Booting from CD-ROM requires only
  62 .IR 9bootiso
  63 to be included in the ISO-9660 image under
  64 .B 386/9bootiso,
  65 set as a non emulation bootblock (see
  66 .IR mk9660 (8)).
  67 Boot parameters are read from
  68 .B cfg/plan9.ini.
  69 .SH NETWORK BOOTING
  70 With a PXE capable BIOS and network card one can download
  71 .IR 9bootpxe
  72 and boot the kernel from a TFTP server (see
  73 .IR dhcpd (8),
  74 .IR ndb (6)
  75 for details). Once started,
  76 .IR 9bootpxe
  77 will read the file
  78 .B /cfg/pxe/$ether
  79 from the tftp server, where
  80 .B $ether
  81 is the MAC address of the client's network card
  82 in lower case hex, and use this as its
  83 .IR plan9.ini (8)
  84 file.
  85 .SH FILES
  86 .TP
  87 .B /386/pbs
  88 .TP
  89 .B /386/9bootfat
  90 .TP
  91 .B /386/9bootiso
  92 .TP
  93 .B /386/9bootpxe
  94 .SH SOURCE
  95 .BR /sys/src/boot/pc .
  96 .SH "SEE ALSO"
  97 .IR plan9.ini (8)