1.\" $NetBSD: installboot.8,v 1.18 2002/02/13 08:18:25 ross Exp $ 2.\" 3.\" Copyright (c) 1996 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Paul Kranenburg. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 3. All advertising materials mentioning features or use of this software 18.\" must display the following acknowledgement: 19.\" This product includes software developed by the NetBSD 20.\" Foundation, Inc. and its contributors. 21.\" 4. Neither the name of The NetBSD Foundation nor the names of its 22.\" contributors may be used to endorse or promote products derived 23.\" from this software without specific prior written permission. 24.\" 25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35.\" POSSIBILITY OF SUCH DAMAGE. 36.\" 37.Dd November 29, 1996 38.Dt INSTALLBOOT 8 amiga 39.Os 40.Sh NAME 41.Nm installboot 42.Nd install a bootstrap on an FFS filesystem partition 43.Sh SYNOPSIS 44.Nm /usr/mdec/installboot 45.Op Fl l Ar newcommandline 46.Ar bootblock 47.Ar device 48.Sh DESCRIPTION 49.Nm installboot 50copies the bootblock to a bootable partition. The 51bootstrap is written into the bootblock area on the partition, right 52in front of the superblock, and hence limited in size to 538192 bytes. 54.Pp 55The bootstrap resides in the first few blocks on the partition 56.Pq as specified by Commodore-Amiga Inc. 57The bootstrap is loaded into memory by the ROM from bootable devices: 58RDB devices, where the partition is marked as bootable, or (not on the 59DraCo) floppy disks in Amiga format (880K/1760k). 60.Pp 61In the presence of more than one bootable partition/floppy disk, the partition 62is chosen by the bootpriority (from the RDB), which can be overridden by 63the operator from the boot menu (on Amiga machines, hold down the outer 64mouse buttons during boot; on DraCo machines, press the left mouse button 65when prompted). 66.Pp 67On RDB devices, the whole bootblock is loaded by the ROM. The number of 68boot blocks in the RDB partition entry must be correct. 69.Pp 70On floppy disks, the ROM always loads the first two blocks (1024 bytes), 71and the bootblock allocates memory and loads the whole bootblock on startup. 72.Pp 73After receiving control, the bootblock uses the stand-alone 74filesystem code in 75.Dq libsa.a 76to load the kernel from the filesystem on the partition it was started from. 77The code for the boot program can be found in 78.Pa /usr/mdec/bootxx_fd 79.Pq floppy disk code 80or 81.Pa /usr/mdec/bootxx_ffs 82.Pq generic RDB disk code . 83.Pp 84The arguments are: 85.Bl -tag -width bootblock 86.It Fl l Ar newcommandline 87Specify a different commandline to replace the default. 88.It Ar bootblock 89The file containing the bootblock (normally /usr/mdec/bootxx_ffs for RDB devices). 90.It Ar device 91The name of the character special device specifying the partition on which the 92bootstrap is to be installed. 93.El 94.Sh EXAMPLES 95The following command will install the 96boot program in the bootblock area on 97.Dq sd0a : 98.Bd -literal -offset indent 99installboot /usr/mdec/bootxx_ffs /dev/rsd0a 100.Ed 101.Sh SEE ALSO 102.Xr dd 1 , 103.Xr boot 8 104.Sh HISTORY 105The 106.Nm 107command first appeared in 108.Nx 1.3 . 109.Sh BUGS 110If 111.Nm 112is accidentally used on the whole disk partition, the RDB will be overwritten, 113making your system unusable after the next reboot. 114.Pp 115Some third-party accelerator boards are not auto-configuring. You won't 116be able to use their memory when booting from the bootblock after a cold 117start. 118.Pp 119Some third-party disk controllers don't support bootblock booting. 120.Pp 121DraCo ROMs don't support bootblock booting from floppy disks. 122.Pp 123Most 68060 boards, unlike the DraCo, don't set the SysBase-\*[Gt]AttnFlags 124bit for the 68060 CPU (a patch program which is called during 125AmigaOS startup does this). You need to add options BB060STUPIDROM 126to your kernel to boot on such a machine. 127.Pp 128There is currently no easy way to edit the RDB from within 129.Nx . 130Therefore, you have to use HDTOOLBOX or a similar tool to 131set the partition to bootable, "use custom bootblocks" and the number 132of bootblocks to 16 (for bootxx_ffs) or 2 (for bootxx_fd), at least the first 133time you install the bootblock. 134.Pp 135As normal dd is used to install the bootblock, you can only install onto 136your currently used root (or any other mounted) partition from single-user 137mode, or while otherwise running in insecure mode. 138