Kittens in section 8.

3 files changed, 128 insertions, 3 deletions

diff --git a/share/man/man8/Makefile b/share/man/man8/Makefile
index 85c10635523..ca491014b15 100644
--- a/share/man/man8/Makefile
+++ b/share/man/man8/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.46 2004/01/06 08:01:10 deraadt Exp $
+#	$OpenBSD: Makefile,v 1.47 2004/02/13 11:23:50 miod Exp $
 #	$NetBSD: Makefile,v 1.13 1996/03/28 21:36:40 mark Exp $
 #	@(#)Makefile	8.1 (Berkeley) 6/5/93
 
@@ -16,7 +16,8 @@ MLINKS+=daily.8 weekly.8 daily.8 monthly.8
 MLINKS+=rc.8 rc.local.8 rc.8 rc.securelevel.8
 MLINKS+=rc.conf.8 rc.conf.local.8
 
-SUBDIR=	man8.alpha man8.hp300 man8.hppa man8.i386 man8.mac68k man8.mvme68k \
-	man8.mvme88k man8.macppc man8.pegasos man8.sparc man8.sparc64 man8.vax
+SUBDIR=	man8.alpha man8.cats man8.hp300 man8.hppa man8.i386 \
+	man8.mac68k man8.macppc man8.mvme68k man8.mvme88k \
+	man8.pegasos man8.sparc man8.sparc64 man8.vax
 
 .include <bsd.prog.mk>
diff --git a/share/man/man8/man8.cats/Makefile b/share/man/man8/man8.cats/Makefile
new file mode 100644
index 00000000000..332180d3ee6
--- /dev/null
+++ b/share/man/man8/man8.cats/Makefile
@@ -0,0 +1,7 @@
+#	$OpenBSD: Makefile,v 1.1 2004/02/13 11:23:52 miod Exp $
+
+# TODO: MAKEDEV.8
+MAN=	boot_cats.8
+MANSUBDIR=cats
+
+.include <bsd.prog.mk>
diff --git a/share/man/man8/man8.cats/boot_cats.8 b/share/man/man8/man8.cats/boot_cats.8
new file mode 100644
index 00000000000..7ebca7cb16e
--- /dev/null
+++ b/share/man/man8/man8.cats/boot_cats.8
@@ -0,0 +1,117 @@
+.\"	$OpenBSD: boot_cats.8,v 1.1 2004/02/13 11:23:52 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. Redistributions 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 February 13, 2004
+.Dt BOOT_CATS 8 cats
+.Os
+.Sh NAME
+.Nm boot_cats
+.Nd CATS system bootstrapping procedures
+.Sh DESCRIPTION
+.Ss System startup
+When powered on, after a panic, or if the system is rebooted via
+.Xr reboot 8
+or
+.Xr shutdown 8 ,
+the Cyclone or ABLE firmware will proceed to its initialization,
+and will try to boot an operating system if autoboot is enabled.
+Cyclone firmware must be upgraded to ABLE before
+.Ox
+can be run.
+.Ss Boot process options
+The ABLE firmware will attempt to boot the commandline stored in the
+.Em boot.cmd
+environment variable.
+Autoboot is enabled by setting the
+.Em boot.auto
+environment variable to
+.Sq true ,
+and will start after
+.Em boot.timeout
+seconds.
+.Pp
+The kernel will be passed the argument string managed by the
+.Em showargs
+and
+.Em setargs
+firmware commands.
+The expected syntax for
+.Ox
+kernels is one or more option letters from the following list,
+prefixed by a dash
+.Pq - :
+.Bl -tag -width "XXX" -offset indent -compact
+.Pp
+.It Cm a
+Prompt for the root filesystem device after the devices have been configured.
+.It Cm c
+Enter the
+.Dq User Kernel Configuration
+mode upon startup
+.Pq Xr boot_config 8 .
+.It Cm d
+Enter the debugger,
+.Xr ddb 4 ,
+as soon as the kernel console has been initialized.
+.It Cm f
+Use the
+.Xr footbridge 4
+serial port
+.Pq Xr fcom 4
+as the console.
+.It Cm s
+Boot the system single-user.
+.It Cm v
+Use the
+.Xr vga 4
+graphics display as the console, if available.
+.El
+.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 reboot 8 ,
+.Xr savecore 8 ,
+.Xr shutdown 8