bztsrc--bootboot/x86_64-bios
bzt 47c01213e5 Use correct CRLFs in BIOS version 2022-12-27 13:46:05 +01:00
..
Makefile
OLVASSEL.md
README.md
boot.asm
bootboot.asm Use correct CRLFs in BIOS version 2022-12-27 13:46:05 +01:00
bootboot.inc
fs.inc More file system stuff 2021-03-25 08:30:25 +01:00
mkboot.c
tinf.inc

README.md

BOOTBOOT BIOS / Multiboot / El Torito / Expansion ROM / Linux boot Implementation

See BOOTBOOT Protocol for common details.

On BIOS based systems, the same image can be loaded via Multiboot, chainload from MBR, VBR (GPT hybrid booting) or from CDROM boot record via boot.bin, run as a BIOS Expansion ROM (so not only the ramdisk can be in ROM, but the loader as well), or can be loaded as a Linux kernel (by ISOLINUX, LoadLin etc.).

Machine state

IRQs masked. GDT unspecified, but valid, IDT unset. SSE, SMP enabled. Code is running in supervisor mode in ring 0 on all cores.

Installation

  1. BIOS disk / cdrom: copy bootboot.bin to FS0:\BOOTBOOT.BIN. You can place it inside your INITRD partition or outside of partition area as well (with dd conv=notrunc seek=x). Finally install boot.bin in the El Torito Boot catalog with "no emulation" or in Master Boot Record (or in Volume Boot Record if you have a boot manager), saving bootboot.bin's first sector's LBA number in a dword at 0x1B0. The mkboot utility will do that for you.

  2. BIOS ROM: install bootboot.bin in a BIOS Expansion ROM.

  3. GRUB: specify bootboot.bin as a Multiboot "kernel" in grub.cfg, or you can also chainload boot.bin. You can load the initrd and the environment file as modules (in this order). If no modules given, they will be loaded from disk as usual. Example:

menuentry "MyKernel" {
    multiboot /bootboot.bin         # the loader
    module /bootboot/initrd         # first module is the initrd (optional)
    module /bootboot/config         # second module is the environment file (optional)
    boot
}

Limitations

  • As it boots in protected mode, it only maps the first 4G of RAM.
  • Compressed initrd in ROM is limited to ~96k.
  • The CMOS nvram does not store timezone, so always GMT+0 returned in bootboot.timezone.
  • Only supports SHA-XOR-CBC, no AES