1.\" $OpenBSD: boot_luna88k.8,v 1.8 2023/01/12 19:37:53 miod Exp $ 2.\" 3.\" Copyright (c) 2004, Miodrag Vallat. 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. Redistribution 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.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25.\" 26.Dd $Mdocdate: January 12 2023 $ 27.Dt BOOT_LUNA88K 8 luna88k 28.Os 29.Sh NAME 30.Nm boot_luna88k 31.Nd luna88k system bootstrapping procedures 32.Sh DESCRIPTION 33.Ss Boot process description 34When powered on, or after a system reboot, the luna88k ROM monitor will 35proceed to its initialization, and will boot the operating system 36configured in nvram if autoboot is enabled. 37.Ss DIP switches description 38The behaviour of the ROM monitor, as well as some kernel options, are 39controlled through the SW1 set of DIP switches on the front panel. 40.Pp 41The switch positions are not the same on LUNA-88K and LUNA-88K2 models. 42On LUNA-88K, a switch is enabled when in the 43.Em down 44position, while on the LUNA-88K2, a switch is enabled when in the 45.Em up 46position. 47.Pp 48The following SW1 switches alter the ROM monitor behaviour: 49.Bl -column "Switch" "interact with ROM monitor" "Disabled" 50.It Sy Switch Ta Sy Enabled Ta Sy Disabled 51.It Li 1 Ta "interact with ROM monitor" Ta "auto-boot" 52.It Li 2 Ta "serial console" Ta "graphics console" 53.El 54.Pp 55The following switches alter the kernel behaviour: 56.Bl -column "Switch" "interact with ROM monitor" "Disabled" 57.It Sy Switch Ta Sy Enabled Ta Sy Disabled 58.It Li 1 Ta "boot in single-user mode" Ta "boot in multi-user mode" 59.It Li 3 Ta "prompt for root device" Ta "do not prompt for root device" 60.It Li 4 Ta "enter UKC mode" Ta "do not enter UKC mode" 61.El 62Note that the same behaviour can be used by passing the 63.Fl s , 64.Fl a , 65and 66.Fl c 67options respectively in the boot loader, rather than using the switches. 68.Pp 69For more details about the 70.Dq User Kernel Configuration 71mode 72.Pq UKC , 73see 74.Xr boot_config 8 . 75.Pp 76Note that the first switch controls both the kernel and the ROM monitor 77behaviour. 78.Ss Abnormal system termination 79In case of system crashes, the kernel will usually enter the kernel 80debugger, 81.Xr ddb 4 , 82unless it is not present in the kernel, or it is disabled via the 83.Em ddb.panic 84sysctl. 85Upon leaving ddb, or if ddb was not entered, the kernel will halt the system 86if it was still in device configuration phase, or attempt a dump to the 87configured dump device, if possible. 88The crash dump will then be recovered by 89.Xr savecore 8 90during the next multi-user boot cycle. 91It is also possible to force other behaviours from ddb. 92.Sh FILES 93.Bl -tag -width /bsd.rd -compact 94.It Pa /bsd 95default system kernel 96.It Pa /bsd.rd 97standalone installation kernel, suitable for disaster recovery 98.El 99.Sh SEE ALSO 100.Xr ddb 4 , 101.Xr boot 8 , 102.Xr boot_config 8 , 103.Xr halt 8 , 104.Xr init 8 , 105.Xr reboot 8 , 106.Xr savecore 8 , 107.Xr shutdown 8 108