MKUSBBOOT(8) MKUSBBOOT(8)
NAME
mkusbboot - generate bootable USB disk image
SYNOPSIS
mkusbboot [ -p proto ] [ -r root ] [ -s size ]
DESCRIPTION
Mkusbboot generates a bootable disk image, called image,
from the filesystem at root (by default /n/boot), using the
mkfs(8) prototype file proto and files in
/sys/lib/sysconfig/usb.
The image will be exactly size*1,000,000 bytes long. By
default, it will be 1,900,000,000 bytes long, so it should
fit on so-called 2 GB USB devices. When building from
/n/sources/plan9, the image defaults to 900,000,000 bytes
long, to fit so-called 1 GB USB devices.
The image contains 9fat and fossil(4) file systems and is
configured to be bootable as a CPU server with serial con-
sole on 386 (with optional VGA) or amd64 machines, when
copied to a USB disk. There is an nvram partition, ini-
tially zeroed.
EXAMPLES
Create a bootable USB flash drive from the local Plan 9
installation.
mkusbboot
pump <image >/dev/sdU0.0/data
FILES
image the resulting disk image
/sys/lib/sysconfig/usb
plan9.ini and fossil.conf for the gener-
ated system
/sys/lib/sysconfig/proto/stand-usb
default proto
/env/objtype architecture of the boot programs in the
disk image
/tmp/9load
/srv/fossil
/srv/fossil.open
/srv/fscons
/srv/fscons.open files created while executing
SOURCE
/rc/bin/mkusbboot
SEE ALSO
Page 1 Plan 9 (printed 10/30/25)
MKUSBBOOT(8) MKUSBBOOT(8)
usb(4), boot(8), diskparts(8), loadfossil(8), partfs(8),
plan9.ini(8), prep(8)
BUGS
Due to name clashes in /srv, should be run only on machines
with no running fossil instance named `fossil'.
Not all BIOSes can reliably read from USB devices. Your
mileage may vary.
Page 2 Plan 9 (printed 10/30/25)