diff options
author | flipk <flipk@cvs.openbsd.org> | 1997-05-01 21:44:23 +0000 |
---|---|---|
committer | flipk <flipk@cvs.openbsd.org> | 1997-05-01 21:44:23 +0000 |
commit | 226bc76e46721ef41afc2d64403fc5da09fc6ac2 (patch) | |
tree | 6d7882624ae3aad3653994ffa7b7abc3d9766eaf /share/man | |
parent | 3d6c14afc89b819d4464b1aca20962a9c08e0a82 (diff) |
document the boot.dos utility (boot kernel directly from MSDOS)
Diffstat (limited to 'share/man')
-rw-r--r-- | share/man/man8/man8.i386/Makefile | 2 | ||||
-rw-r--r-- | share/man/man8/man8.i386/boot.com.8 | 90 |
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 |