1.\" $NetBSD: boot.8,v 1.15 2014/08/16 08:43:12 apb Exp $ 2.\" 3.\" Copyright (c) 1980, 1991, 1993 4.\" The Regents of the University of California. 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. Neither the name of the University nor the names of its contributors 15.\" may be used to endorse or promote products derived from this software 16.\" without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 31.\" 32.Dd August 16, 2014 33.Dt BOOT 8 x68k 34.Os 35.Sh NAME 36.Nm boot 37.Nd system bootstrapping procedures 38.Sh DESCRIPTION 39.Ss Power fail and crash recovery 40Normally, the system will reboot itself at power-up or after crashes. 41An automatic consistency check of the file systems will be performed, 42and unless this fails, the system will resume multi-user operations. 43.Ss Cold starts 44The X68000/X68030 system boots from the device 45which is determined by the configuration of 46battery-backuped SRAM. 47By default, the boot ROM attempts to boot from 48floppy disk drives (from 0 to 3) first, 49and then attempts to boot from hard disk (SASI or SCSI). 50On the 51.Nx Ns Tn /x68k , 52booting from SCSI disks (sd??) 53and 2HD floppy disks (fd?a, fd?c) is currently supported. 54.Ss Bootstrapping from a floppy 55When the floppy disk is selected as the boot device, the initial 56program loader of the IOCS (firmware) reads the 57.Pa fdboot_ufs 58program at the top of the disk, and then the fdboot_ufs program loads the 59.Pa /boot 60program from the FFS or LFS file system. 61Normally, the 62.Pa /boot 63program then loads the 64.Nx 65kernel 66.Pa /netbsd 67from the same floppy. 68In addition, the 69.Pa /boot 70program has abilities to uncompress gzip'ed kernels, to read 71the kernel from other disks of other file systems etc (see below). 72.Pp 73For floppy disks, 74.Pa fdboot_ustar 75is also provided to read large 76kernels which do not fit one a single floppy. 77.Ss Bootstrapping from a SCSI hard disk 78When a SCSI hard disk is selected as the boot device, the initial 79program loader on the SCSI host adapter's ROM reads the 80operating system-independent IPL menu program at the top of the disk. 81The IPL menu program recognizes the partition table, and selects the partition 82to read the operating system kernel. 83During this phase, when the HELP key on the keyboard is pressed, 84the IPL menu program displays the partition menu of that disk to 85prompt the user to select the boot partition (although the 86.Nx 87implementation of the IPL menu, 88.Pa /usr/mdec/mboot , 89does not have this functionality). 90.Pp 91Next, the IPL menu reads the OS-dependent boot program from the 92top of the selected partition. 93For 94.Nx 95FFS/LFS file systems 96.Pa sdboot_ufs 97is used. 98The 99.Pa sdboot_ufs 100program then loads the 101.Pa /boot 102program from that partition. 103.Ss Normal Operation 104Once running, a banner similar to the following will appear: 105.Bd -literal -offset indent 106NetBSD Multi-boot, Revision 1.1 107(user@buildhost, builddate) 108Press return to boot now, any other key for boot menu 109booting sd0a:netbsd - starting in 5 110.Ed 111.Pp 112After a countdown, the system image listed will be loaded. 113(In the example above, it will be 114.Dq Li sd0a:netbsd 115which is the file 116.Nm netbsd 117on partition 118.Dq a 119of the 120.Nx 121SCSI hard disk of ID 0. 122Pressing a key within the time limit will enter interactive mode. 123.Ss Interactive mode 124In interactive mode, the boot loader will present a prompt, allowing 125input of these commands: 126.Bl -tag -width helpx -offset indent 127.It Ic boot Oo Ar device : Oc Ns Oo Ar filename Oc Oo Fl adqsv Oc 128The default 129.Ar device 130will be set to the disk that the boot loader was 131loaded from. 132To boot from an alternate disk, the full name of the device should 133be given at the prompt. 134.Ar device 135is of the form 136.Xo 137.Ar xd Ns Oo 138.Ar N Ns Oo 139.Ar x 140.Oc 141.Oc 142.Xc 143where 144.Ar xd 145is the device from which to boot, 146.Ar N 147is the unit number, and 148.Ar x 149is the partition letter. 150.Pp 151The following list of supported devices may vary from installation to 152installation: 153.Pp 154.Bl -hang -compact 155.It sd 156SCSI disks on a controller recognized by the IOCS. 157The unit number is the SCSI ID. 158.It fd 159Floppy drives as numbered by the IOCS. 160.El 161.Pp 162The default 163.Ar filename 164is 165.Pa netbsd ; 166if the boot loader fails to successfully 167open that image, it then tries 168.Pa netbsd.gz 169(expected to be a kernel image compressed by 170.Xr gzip 1 ) . 171Alternate system images can be loaded by just specifying the name of the image. 172.Pp 173Options are: 174.Bl -tag -width xxx 175.It Fl a 176Prompt for the root file system device, the system crash dump 177device, and the path to 178.Xr init 8 . 179.It Fl d 180Bring the system up in debug mode. 181Here it waits for a kernel debugger connect; see 182.Xr ddb 4 . 183.It Fl q 184Boot the system in quiet mode. 185.It Fl s 186Bring the system up in single-user mode. 187.It Fl v 188Boot the system in verbose mode. 189.El 190.It Ic help 191Print an overview about commands and arguments. 192.It Ic ls Op Pa path 193Print a directory listing of 194.Pa path , 195containing inode number, filename and file type. 196.Pa path 197can contain a device specification. 198.It Ic halt 199Reboot the system. 200.El 201.Ss Model-specific notes 202Note for X68030+MC68030 systems: 203Nothing special to be attended to; you can boot 204.Nx 205just like as 206other operating systems such as Human68k and OS-9. 207.Pp 208Note for X68030/040turbo(68040 accelerator by BEEPs) systems: 209.Nx 210can boot under 040 mode. 211It can also boot under 030 mode if you have MC68030 on the board. 212.Pp 213Note for X68000/Xellent30(68030 accelerator by TSR)+MC68030 systems: 214In order to boot 215.Nx , 216you must choose 030 mode by using 217.Pa CH30.SYS , 218which must reside in the battery-backuped SRAM. 219.Pp 220Note for X68000/Jupiter-X(68040/060 accelerator by FTZ-net) systems: 221The system must be in 040/060 processor mode. 222.Sh FILES 223.Bl -tag -width /usr/mdec/xxboot_ufs -compact 224.It Pa /netbsd 225system code 226.It Pa /netbsd.gz 227gzip-compressed system code 228.It Pa /usr/mdec/xxboot_ufs 229boot block (read by installboot), xx is disktype 230.It Pa /usr/mdec/boot 231source of /boot (can be just copied to the root directory) 232.It Pa /boot 233main part of the boot program 234.El 235.Sh SEE ALSO 236.Xr reboot 2 , 237.Xr disklabel 8 , 238.Xr halt 8 , 239.Xr reboot 8 , 240.Xr shutdown 8 241.\" installboot(8) must be written 242