1.\" $NetBSD: installboot.8,v 1.2 1996/06/20 19:41:01 leo Exp $ 2.\" 3.\" Copyright (c) 1995 Paul Kranenburg 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Paul Kranenburg. 17.\" 3. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd September 29, 1995 32.Dt INSTALLBOOT 8 33.Os 34.Sh NAME 35.Nm installboot 36.Nd install a bootstrap on an FFS filesystem partition 37.Sh SYNOPSIS 38.Nm installboot 39.Op Fl Ntuv 40.Ar device 41.Sh DESCRIPTION 42.Nm installboot 43prepares the 44.Pq physically 45first partition on a device for boot-strapping from the TOS-ROM. The 46bootstrap is written into the bootblock area on the partition, right 47in front of the disk pack label, and hence limited in size to 48LABELOFFSET bytes. A disk pack label should be created 49.Po 50see 51.Xr disklabel 8 52.Pc 53before installing the bootstrap. 54.Pp 55The bootstrap is split into two parts: a small first-stage program 56that resides in the 57.Pq physically 58first 512 bytes on the device 59.Pq as specified by Atari Corp. , 60and a second-stage program that immediately follows the first-stage 61program. The first-stage program is loaded into memory by the ROM. 62After receiving control, it loads the second-stage program and the 63disk label. The second-stage boot program uses the stand-alone 64filesystem code in 65.Dq libsa.a 66to load the kernel from the root-filesystem on the device. The 67prototype code for the first-stage boot program can be found in 68.Pa /usr/mdec/fdboot 69.Pq floppy disk code , 70.Pa /usr/mdec/sdboot 71.Pq SCSI disk code 72and 73.Pa /usr/mdec/wdboot 74.Pq IDE disk code . 75The second-stage boot program is stored in 76.Pa /usr/mdec/bootxx . 77.Pp 78For backwards compatibility with the vendor specific AHDI disk 79label, a\ special first-stage boot program is provided in 80.Pa /usr/mdec/xxboot.ahdi . 81Together with the general second-stage boot program, it is installed 82in the AHDI partition where the 83.Tn NetBSD 84disk label lives. Furthermore, 85the AHDI specifications require an additional bootstrap, which is 86written into the AHDI root sector 87.Pq disk block zero . 88The prototype code for this AHDI compliant bootstrap can be found in 89.Pa /usr/mdec/sdb00t.ahdi 90and 91.Pa /usr/mdec/wdb00t.ahdi . 92.Pp 93The options are as follows: 94.Bl -tag -width flag 95.It Fl N 96Do not actually write anything on the disk. 97.It Fl t 98Number of tracks per cylinder (IDE disk). 99.It Fl u 100Number of sectors per track (IDE disk). 101.It Fl v 102Verbose mode. 103.El 104.Pp 105The arguments are: 106.Bl -tag -width device 107.It Ar device 108The name of the device on which the bootstrap is to be installed. 109.El 110.Sh EXAMPLES 111The following command will install the first-stage and second-stage 112boot programs in the bootblock area on 113.Dq sd0c : 114.Bd -literal -offset indent 115installboot sd0 116.Ed 117.Sh CAVEATS 118.Nm 119knows too much about kernel internal details, forcing it to 120check the running kernel's release and revision. 121.Pp 122Because neither the floppy disk driver nor 123.Xr disklabel 8 124are capable of creating a disk pack label on a floppy disk, 125.Nm 126has to create a\ fictitious label, that is not used by the kernel. 127.Pp 128Except for installation of the bootcode on floppy, 129.Nm 130automatically sets the boot preference in NVRAM to 131.Tn NetBSD. 132.Sh BUGS 133There is currently no easy way to change the NVRAM preference from within 134.Tn NetBSD. 135.Sh "SEE ALSO" 136.Xr disklabel 8 137.Sh HISTORY 138The 139.Nm 140command first appeared in 141.Nx 1.1 142