Sync usage with man page.
[netbsd-mini2440.git] / distrib / amiga / stand / runbootblock.README
bloba5a1d3a69790ef4c932557f89de85cdbbb07e99b
1 Some Amigas are incapable of booting from partiton utilizing a bootblock.  One
2 example is the PPS Zeus accelerator.  The Zeus has two major problems with
3 booting from a bootblock.  The first (and fatal) one is the driver is just
4 plain buggy and will not work.  The second problem (if the first problem
5 didn't exist) is that the Zeus memory is normally configured during the
6 execution of S:Startup-Sequence using a supplied utility program.  Even if
7 the Zeus would boot from a bootblock, its memory would not get configured.
8 Another example I've run into is the GVP GForce-40.  It will boot from a
9 bootblock, but it appears to only work if there is a filesystem in the RDB
10 blocks for the bootable partition.  I've gotten the GForce-40 to boot directly
11 from the bootblock by installing the BFFSFastFileSystem in the RDB.
13 When I was developing the two-stage boot for NetBSD, I wrote runbootblock.
14 Runbootblock will load and execute an Amiga bootblock program from a disk partition,
15 similar to the process the Amiga ROM will do when booting from the bootblock.
16 This allows "booting" from a NetBSD bootblock when the Amiga is unable to actually
17 boot from a bootblock.
19 runbootblock [-d PPSscsi2.device] [-u 1] [-p root]
21     -d scsi.device      Select device driver name, default PPSSscsi2.device.
22     -u unit             Select SCSI device unit, default 1.
23     -p partition        Select partition name, default is root partition.
25 The following command will load and execute the bootblock on SCSI drive
26 2 from the partition named "swap" (which contains the miniroot filesystem
27 for installing/upgrading NetBSD) on my Zeus.
29         runbootblock -u 2 -p swap