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