1.\" $NetBSD: boot.8,v 1.3 1999/12/30 22:31:18 simonb Exp $ 2.\" 3.\" Copyright (c) 1990, 1991 The Regents of the University of California. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to Berkeley by 7.\" the Systems Programming Group of the University of Utah Computer 8.\" Science Department. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 3. All advertising materials mentioning features or use of this software 19.\" must display the following acknowledgement: 20.\" This product includes software developed by the University of 21.\" California, Berkeley and its contributors. 22.\" 4. Neither the name of the University nor the names of its contributors 23.\" may be used to endorse or promote products derived from this software 24.\" without specific prior written permission. 25.\" 26.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 27.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 28.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 29.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 30.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 31.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 32.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 33.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 34.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 35.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 36.\" SUCH DAMAGE. 37.\" 38.\" From: 39.\" @(#)boot_hp300.8 8.2 (Berkeley) 4/19/94 40.\" 41.Dd May 8, 1997 42.Dt boot 8 amiga 43.Os 44.Sh NAME 45.Nm boot 46.Nd 47system bootstrapping procedures 48.Sh DESCRIPTION 49.Sy Power fail and crash recovery 50.Pp 51When the 52.Nx 53kernel is booted normally (using one of the two methods discussed below), 54it initializes itself and proceeds to boot the system. An automatic 55consistency check of the file systems takes place, and unless this 56fails, the system comes up to multi-user operations. The proper way 57to shut the system down is with the 58.Xr shutdown 8 59command. 60.Pp 61If the system crashes, it will enter the kernel debugger, 62.Xr ddb 8 , 63if it is configured in the kernel. If the debugger is not present, 64or the debugger is exited, the system will attempt a dump to the 65configured dump device (which will be automatically recovered with 66.Xr savecore 8 67during the next boot cycle). After the dump is complete (successful 68or not), the system will attempt a reboot. 69.Pp 70.Sy Booting NetBSD using the bootloader 71.Pp 72When a bootable 73.Nx 74partition is created by means of HDTOOLBOX or another RDB editing program 75and a bootblock has been copied there by 76.Xr installboot 8 77and the boot priority of the 78.Nx 79partion is either the highest or the 80.Nx 81partition is selected by means of the boot menu, 82the Amiga ROM will automatically start the 83.Nx 84bootloader. By default it will, after a short timeout, load the kernel image 85.Pa /netbsd 86and attempt to boot it into multi-user mode. This behaviour can be changed by 87typing in an alternate command sequence. The command line looks like: 88.Bd -ragged -offset indent 89.Ar kernel-path 90.Op Fl abknpstADZ 91.Op Fl c Ar model 92.Op Fl m Ar memsize 93.Op Fl n Ar memsegments 94.Op Fl I Ar mask 95.Op Fl S Ar amount 96.Op Fl T Ar amount 97.Ed 98 99.Bl -tag -width flag 100.It kernel-path 101This gives you the opportunity to boot another kernel, say: 102/netbsd.old. 103The default is 104/netbsd 105 106.It Fl a 107Autoboot into multi-user mode (default). 108.It Fl b 109Ask for the root device the kernel must use. 110.It Fl c Ar model 111force machine 112.Ar model . 113Use 32000+(Qlogic chip revision) for the DraCo. 114.It Fl k 115Reserve the first 4M of fastmem. 116.It Fl m Ar memsize 117Force fastmem size to be 118.Ar memsize 119kBytes. 120.It Fl n 121maximum number of 122.Ar segments 123of memory to use, encoded as follows: 0 (default): 1 segment, 1: 1242 segments, 2: 3 or more segments. 125.It Fl p 126Select kernel load segment by priority instead of size. 127.It Fl b 128Ask for a root device 129.It Fl s 130Boot into single-user mode 131.It Fl D 132Enter the kernel debugger (best used with -S) 133.It Fl I Ar mask 134inhibit sync negotiation as follows: The 135.Ar mask 136is a bitmap expressed in C notation (e.g., 0xff) 137with 4*8bits, each bit, if set to 1, disabling sync negotiation for 138the corresponding target. Note that this only applies to (some of the) 139real SCSI busses, but not, e.g., to internal IDE. The bytes are used up 140from right to left by SCSI bus drivers using this convention. 141.It Fl S 142Load the kernel symbols 143.El 144 145.Pp 146.Sy Booting NetBSD using the loadbsd program 147.Pp 148When you want (or have to) start 149.Nx 150from AmigaOS, you have to use the 151.Xr loadbsd 152program that is supplied in the utils directory of the distribution. 153The loadbsd command line specification is: 154.Bd -ragged -offset indent 155.Nm loadbsd 156.Op Fl abknpstADZ 157.Op Fl c Ar model 158.Op Fl m Ar memsize 159.Op Fl n Ar memsegments 160.Op Fl I Ar mask 161.Op Fl S Ar amount 162.Op Fl T Ar amount 163.Ar kernel-path 164.Ed 165.Pp 166Description of options: 167.Bl -tag -width flag 168.It Fl a 169Autoboot into multi-user mode. 170.It Fl b 171Ask for the root device the kernel must use. 172.It Fl c 173force machine model. 174.It Fl k 175Reserve the first 4M of fastmem. 176.It Fl m 177Force fastmem size to be 178.Ar memsize 179kBytes. 180.It Fl n 181maximum number of 182.Ar segments 183of memory to use, encoded as follows: 0 (default): 1 segment, 1: 1842 segments, 2: 3 or more segments. 185.It Fl p 186Select kernel load segment by priority instead of size. 187.It Fl s 188Boot into single-user mode. 189.It Fl t 190Test loading of the kernel but don't start 191.Nx . 192.It Fl A 193enable AGA modes. 194.It Fl D 195Enter the kernel debugger after booting. Best with -S. 196.It Fl I Ar mask 197inhibit sync negotiation as follows: The 198.Ar mask 199is a bitmap expressed in hexadecimal (e.g., ff) 200with 4*8bits, each bit, if set to 1, disabling sync negotiation for 201the corresponding target. Note that this only applies to (some of the) 202real SCSI busses, but not, e.g., to internal IDE. The bytes are used up 203from right to left by SCSI bus drivers using this convention. 204.It Fl S 205include kernel debug symbols (for use by -D). 206.It Fl Z 207Force load via chip memory. Won't work if kernel is larger than the chip 208memory size or on the DraCo. 209.El 210.Pp 211Note: Because the loadbsd program can only read kernels from a AmigaOS 212filesystem, the file 213.Ar /netbsd 214is often not the same as the actual kernel booted. This can cause some 215programs to fail. However, note that you can use third-party Berkeley 216filesystems such as bffs to access the NetBSD root partition from AmigaOS. 217.Sh FILES 218.Bl -tag -width /usr/mdec/xxboot -compact 219.It Pa /netbsd 220system kernel 221.It Pa /usr/mdec/xxboot 222RDB device boot block 223.It Pa /usr/mdec/fdboot 224floppy disk boot block 225.El 226.Sh BUGS 227Due to code size restrictions, you can't currently use a old-style file 228system (created with 229.Xr newfs 230-O 231or with 232.Nx 0.9 ) 233with the boot block. You can use 234.Xr loadbsd 235to boot from AmigaOS, or upgrade the file system with 236.Ar fsck_ffs -c 2 . 237.Sh SEE ALSO 238.Xr ddb 8 , 239.Xr fsck_ffs 8 , 240.Xr installboot 8 , 241.Xr newfs 8 , 242.Xr savecore 8 , 243.Xr shutdown 8 244 245