ISOBOOT(8)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

🌸 isoBOOT(8) 🌸

okay bestie, welcome to the isoboot page 💅 this is a System Manager's Manual entry, section 8, and it's genuinely iconic — it's the little boot blob that makes hybrid ISO/USB images actually boot on BIOS machines. buckle up 🎀

✨ NAME ✨

isoboot — boot code for hybrid ISO/USB images on BIOS-based computers 🖥️💖

🦋 DESCRIPTION 🦋

so here's the vibe: isoboot is what you use on BIOS-based computers to boot from an ISO image that's been written to a USB flash drive or some other HDD-like device. no cap, that's the whole point 🫶

and how does it get there? isoboot is installed in a freebsd-boot partition with mkimg(1). that's it, that's the install ✨

🧚 IMPLEMENTATION NOTES 🧚

okay this is the part where I need you to lock in, because it's lowkey the coolest bit 🔥

the El Torito standard for bootable CDs gives you a 32KB "System Area" right at the beginning of an image. 32KB. tiny. and yet.

so to make an image that the BIOS can boot either as a CD-ROM ("ISO") or as a more HDD-like image (e.g. on a USB flash drive), you literally need both:

  • a standard El Torito boot catalog containing a HDD-style partition table
  • boot code

both. together. in the same image. it's giving hybrid main character energy 👑

and isoboot itself? it's intended to be placed in a GPT partition, so that the system can find the standard FreeBSD loader(8) in the ISO filesystem later in the image. yes — later in the image. the loader is chilling further down and isoboot goes and finds it 💖

👑 BOOTING 👑

so what does isoboot actually do at boot time? bestie, it's simple and slay:

it looks for an ISO filesystem image on the device it was booted from 🌈

then it seeks to read either the primary FreeBSD loader(8) or the kernel from there 🎀

that's it. that's the whole job. and it ate. 💅

🌸 SEE ALSO 🌸

💜 HISTORY 💜

isoboot appeared in FreeBSD 12.0. a legend was born ✨

🍓 AUTHORS 🍓

this manual page was written by Benno Rice <benno@FreeBSD.org> 🫶 thank you Benno, genuinely 💖

ngl this page is short but it's doing a LOT of heavy lifting so your USB stick can boot. respect the 32KB system area fr fr 😭💀

okay that's the whole page bestie, ily, go make a hybrid image 🦋✨

Debian · March 30, 2018 · ISOBOOT(8) — and that's the sign-off, mwah 💋🎀

📦 where this page comes from