xref: /plan9/sys/man/8/mkusbboot (revision 0a75e54a195f699ff0426de1f8ba80514066a83b)
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 ), but could be
.BR /n/sources/plan9 ),
using the mkfs (8) prototype file proto and files in /sys/lib/sysconfig/usb . The default boot program 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.
.EX mkusbboot pump <image >/dev/sdU0.0/data

Create a bootable disk from the local Plan 9 installation.

.EX mkusbboot -b /386/9load pump <image >/dev/sdC0/data
FILES
.TF /srv/fscons.open

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

0

/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 .LR fossil and thus no /srv/fossil , /srv/fossil.open , etc.

Not all BIOSes can reliably read from USB devices. Your mileage may vary.