document the boot.dos utility (boot kernel directly from MSDOS)

2 files changed, 91 insertions, 1 deletions

diff --git a/share/man/man8/man8.i386/Makefile b/share/man/man8/man8.i386/Makefile
index 499800136d5..65e196e7fa4 100644
--- a/share/man/man8/man8.i386/Makefile
+++ b/share/man/man8/man8.i386/Makefile
@@ -1,7 +1,7 @@
 #	@(#)Makefile	5.1 (Berkeley) 3/22/91
 #	$NetBSD: Makefile,v 1.5 1995/09/06 21:36:35 jtc Exp $
 
-MAN=	MAKEDEV.8
+MAN=	MAKEDEV.8 boot.com.8
 MLINKS=	MAKEDEV.8 makedev.8
 MANSUBDIR=/i386
 
diff --git a/share/man/man8/man8.i386/boot.com.8 b/share/man/man8/man8.i386/boot.com.8
new file mode 100644
index 00000000000..cd70c5ed2f4
--- /dev/null
+++ b/share/man/man8/man8.i386/boot.com.8
@@ -0,0 +1,90 @@
+.\"     $OpenBSD: boot.com.8,v 1.1 1997/05/01 21:44:22 flipk Exp $
+.\"
+.\" Copyright (c) 1989, 1990, 1993
+.\"     The Regents of the University of California.  All rights reserved.
+.\"
+.\" This code is derived from software contributed to Berkeley by
+.\" the Institute of Electrical and Electronics Engineers, Inc.
+.\"
+.\" 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"     This product includes software developed by the University of
+.\"     California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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.
+.\"
+.\"     @(#)cat.1       8.3 (Berkeley) 5/2/95
+.\"
+.Dd April 28, 1997
+.Dt BOOT.COM 8 i386
+.Os OpenBSD
+.Sh NAME
+.Nm BOOT.COM
+.Nd Boot an OpenBSD kernel from MS-DOS
+.Sh SYNOPSIS
+.Nm BOOT
+.Sh DESCRIPTION
+The
+.Nm
+utility, executed from an MS-DOS prompt, will load a kernel stored
+in the DOS partition, effectively booting OpenBSD.  There are no
+command line arguments.
+.Pp
+.Nm
+functions identically to the standalone bootblocks, except that it
+only loads files on a DOS partition.  After printing the `Boot:'
+prompt, there is a timeout of several seconds.  If no key is pressed in
+that time, the default kernel
+.Em bsd
+is loaded from the root directory of the DOS C: partition.
+.Sh CAVEATS
+The file 
+.Pa /usr/mdec/boot.com
+and a valid kernel file must be copied to the root directory
+of the DOS C: partition.
+.Pp
+If the desired FFS root filesystem is not on the first drive in the
+system, the
+.Fl r
+flag (use the kernel's compiled-in default root device)
+must be supplied when booting the kernel, i.e.:
+.Pp
+.Bd -literal -offset indent
+Boot: [[[wd(0,a)]bsd][-abcdrs]] : bsd -r
+.Ed
+.Sh BUGS
+.Nm
+will not load kernels compressed with
+.Xr gzip 1 ,
+or ramdisk kernels larger than 3M in size.
+.Pp
+.Nm
+always assumes the kernel is in the root directory of the DOS drive; to
+load a kernel from the current directory, the name must be entered at
+the `Boot:' prompt with no leading slashes.
+.Pp
+Loading a kernel from anywhere
+other than the root directory or the current directory is not supported.
+.Sh FILES
+.Pa /usr/mdec/boot.com