diff options
| -rw-r--r-- | share/man/man8/man8.luna88k/Makefile | 5 | ||||
| -rw-r--r-- | share/man/man8/man8.luna88k/boot_luna88k.8 | 108 |
2 files changed, 110 insertions, 3 deletions
diff --git a/share/man/man8/man8.luna88k/Makefile b/share/man/man8/man8.luna88k/Makefile index decdda2df85..f6c6d940bdf 100644 --- a/share/man/man8/man8.luna88k/Makefile +++ b/share/man/man8/man8.luna88k/Makefile @@ -1,7 +1,6 @@ -# $OpenBSD: Makefile,v 1.1 2004/04/21 18:27:18 miod Exp $ +# $OpenBSD: Makefile,v 1.2 2004/08/27 13:29:39 miod Exp $ -# TODO: boot_luna88k -MAN= MAKEDEV.8 +MAN= boot_luna88k.8 MAKEDEV.8 MANSUBDIR=luna88k .include <bsd.prog.mk> diff --git a/share/man/man8/man8.luna88k/boot_luna88k.8 b/share/man/man8/man8.luna88k/boot_luna88k.8 new file mode 100644 index 00000000000..0cc83bd87ad --- /dev/null +++ b/share/man/man8/man8.luna88k/boot_luna88k.8 @@ -0,0 +1,108 @@ +.\" $OpenBSD: boot_luna88k.8,v 1.1 2004/08/27 13:29:39 miod Exp $ +.\" +.\" Copyright (c) 2004, Miodrag Vallat. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistribution of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd August 27, 2004 +.Dt BOOT_LUNA88K 8 luna88k +.Os +.Sh NAME +.Nm boot_luna88k +.Nd luna88k system bootstrapping procedures +.Sh DESCRIPTION +.Ss Boot process description +When powered on, or after a system reboot, the luna88k ROM monitor will +proceed to its initialization, and will boot the operating system +configured in nvram if autoboot is enabled. +.Ss DIP switches description +The behaviour of the ROM monitor, as well as some kernel options, are +controlled through the SW1 set of DIP switches on the front panel. +.Pp +The switch positions are not the same on Luna-88k and Luna-88k2 models. +On Luna-88k, a switch is enabled when in the +.Em down +position, while on the Luna-88k2, a switch is enabled when in the +.Em up +position. +.Pp +The following switches alter the ROM monitor behaviour: +.Bl -column "Switch" "XXXXXXXXXXXXXXXXXXXXXXXXX" "X" +.It Li Switch Ta Enabled Ta Disabled +.It " " +.It Li 1 Ta interact with ROM monitor Ta auto-boot +.It Li 2 Ta serial console Ta graphics console +.El +.Pp +The following switches alter the kernel behaviour: +.Bl -column "Switch" "XXXXXXXXXXXXXXXXXXXXXXXXX" "X" +.It Li Switch Ta Enabled Ta Disabled +.It " " +.It Li 1 Ta "boot in single-user mode" Ta "boot in multi-user mode" +.It Li 3 Ta "prompt for root device" Ta "do not prompt for root device" +.It Li 4 Ta "enter UKC mode" Ta "do not enter UKC mode" +.El +.Pp +For more details about the +.Dq User Kernel Configuration +mode +.Pq UKC , +see +.Xr boot_config 8 . +.Pp +Note that the first switch controls both the kernel and the ROM monitor +behaviour. +.Pp +.Ss Abnormal system termination +In case of system crashes, the kernel will usually enter the kernel +debugger, +.Xr ddb 4 , +unless it is not present in the kernel, or it is disabled via the +.Em ddb.panic +sysctl. +Upon leaving ddb, or if ddb was not entered, the kernel will halt the system +if it was still in device configuration phase, or attempt a dump to the +configured dump device, if possible. +The crash dump will then be recovered by +.Xr savecore 8 +during the next multi-user boot cycle. +It is also possible to force other behaviours from ddb. +.Sh FILES +.Bl -tag -width /bsd -compact +.It Pa /bsd +default system kernel +.El +.Sh SEE ALSO +.Xr ddb 4 , +.Xr boot_config 8 , +.Xr halt 8 , +.Xr init 8 , +.\" .Xr installboot 8 , +.Xr reboot 8 , +.Xr savecore 8 , +.Xr shutdown 8 +.Sh CAVEATS +There is currently no standalone bootloader program on the Luna88k. +The +.Ox +kernel is loaded directly from the ROM monitor. +Because of this, kernel symbols are not available. |