summaryrefslogtreecommitdiff
path: root/share/man
diff options
context:
space:
mode:
authorflipk <flipk@cvs.openbsd.org>1997-05-01 21:44:23 +0000
committerflipk <flipk@cvs.openbsd.org>1997-05-01 21:44:23 +0000
commit226bc76e46721ef41afc2d64403fc5da09fc6ac2 (patch)
tree6d7882624ae3aad3653994ffa7b7abc3d9766eaf /share/man
parent3d6c14afc89b819d4464b1aca20962a9c08e0a82 (diff)
document the boot.dos utility (boot kernel directly from MSDOS)
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man8/man8.i386/Makefile2
-rw-r--r--share/man/man8/man8.i386/boot.com.890
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