isoboot(8)

isoboot8

Boot code for hybrid iso/usb images on bios-based computers

Overview

isoboot is used on BIOS-based computers to boot from an ISO image that has been written to a USB flash drive or other HDD-like device. isoboot is installed in a freebsd-boot partition with mkimg(1).

Implementation notes

The El Torito standard for bootable CDs provides a 32KB "System Area" at the beginning of an image. To create an image that is able to be booted by the BIOS as either a CD-ROM ("ISO") and as a more HDD-like image (e.g. on a USB flash drive) it is necessary to have both a standard El Torito boot catalog containing a HDD-style partition table and boot code. isoboot is intended to be placed in a GPT partition to allow the system to find the standard FreeBSD loader(8) in the ISO filesystem later in the image.

Booting

isoboot looks for an ISO filesystem image on the device it was booted from and seeks to read either the primary FreeBSD loader(8) or kernel from there.

Releases

23 releases since FreeBSD 11.2-RELEASE; the text changed 10 times.

  1. 11.2
  2. 11.3
  3. 11.4
  4. 12.0
  5. 12.1
  6. 12.2
  7. 12.3
  8. 12.4
  9. 13.0–13.2
  10. 13.3–15.1
  11. 16.0

History

isoboot appeared in FreeBSD 12.0.

Authors

This manual page written by Benno Rice ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.