term% cat index.txt MKUSBBOOT(8) System Manager's Manual MKUSBBOOT(8)
NAME
mkusbboot - generate bootable USB or other disk image for PC
SYNOPSIS
mkusbboot [ -b boot ] [ -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 default boot pro‐
gram is /386/9loadusb.
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 console on 386 (with optional
VGA) or amd64 machines, when copied to a (possibly USB) disk. There is
an nvram partition, initially zeroed.
EXAMPLES
Create a bootable USB flash drive from the local Plan 9 installation.
mkusbboot
pump <image >/dev/sdU0.0/data
Create a bootable disk from the local Plan 9 installation.
mkusbboot -b /386/9load
pump <image >/dev/sdC0/data
FILES
image the resulting disk image
/sys/lib/sysconfig/usb
plan9.ini and fossil.conf for the generated system
/sys/lib/sysconfig/proto/stand-usb
default proto
/env/objtype
architecture of the default kernel in the disk image
/tmp/9load
files created while executing
/tmp/9pccpuf.gz
/srv/fossil
/srv/fossil.open
/srv/fscons
/srv/fscons.open
SOURCE
/rc/bin/mkusbboot
SEE ALSO
usb(4), boot(8), 9boot(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 and thus no /srv/fossil, /srv/fos‐
sil.open, etc.
Not all BIOSes can reliably read from USB devices. Your mileage may
vary.
MKUSBBOOT(8)