man(1) Manual page archive


     MKUSBBOOT(8)                                         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 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 con-
          sole on 386 (with optional VGA) or amd64 machines, when
          copied to a (possibly USB) disk.  There is an nvram parti-
          tion, 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 gener-
                            ated 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

     MKUSBBOOT(8)                                         MKUSBBOOT(8)

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

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