1.\" $NetBSD: dosboot.8,v 1.2 2014/08/16 08:43:12 apb Exp $ 2.\" 3.\" Copyright (c) 1997 4.\" Matthias Drochner. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25.\" SUCH DAMAGE. 26.\" 27.\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 28.\" 29.Dd August 16, 2014 30.Dt DOSBOOT 8 x86 31.Os 32.Sh NAME 33.Nm dosboot 34.Nd boot NetBSD/x86 from DOS 35.Sh SYNOPSIS 36.Nm 37.Op Fl u 38.Op Fl c Ar command 39.Op Fl i 40.Op Ar path Op Fl adqsv 41.Sh DESCRIPTION 42.Nm 43is an 44.Tn MS-DOS 45program. 46It is a boot loader for 47.Nx Ns Tn /x86 48designed to permit 49.Nx 50to be booted directly from 51.Tn MS-DOS . 52By default, it boots a file with name 53.Pa NETBSD 54in the current 55.Tn MS-DOS 56directory. 57.Nm 58shares common code with the standard boot loader, 59.Xr boot 8 . 60.Pp 61The recognized options are: 62.Bl -tag -width "-adqsv" -offset 04n 63.It Fl c 64Execute 65.Ar command 66(see below). 67.It Fl i 68Enter interactive mode. 69.Nm 70will present a prompt, allowing input of commands (see below). 71.It Fl u 72Boot from a UFS file system instead of an 73.Tn MS-DOS 74file system. 75.It Ar path 76Specifies the kernel file. 77In 78.Tn MS-DOS 79mode (default) a normal 80.Tn MS-DOS 81filename (with or without drive specification) is accepted. 82In UFS mode (after 83.Fl u 84or after a 85.Ic mode ufs 86command), a path in a 87.Nx 88file system is expected. 89By default, the file is looked up in partition 90.Sq a 91of the first hard disk. 92Another device or partition can be specified 93by prepending a block device name in terms of 94.Nx , 95followed by a colon (see 96.Xr boot 8 97and examples). 98.It Fl adqsv 99Flags passed to the kernel, see 100.Xr boot 8 . 101.El 102.Pp 103The commands accepted after the 104.Fl c 105flag or in interactive mode are: 106.\" NOTE: some of this text is duplicated in the MI boot.8 107.\" and in other x86-specific *boot.8 files; 108.\" please try to keep all relevant files synchronized. 109.Bl -tag -width 04n -offset 04n 110.It Ic boot Oo Va device : Oc Ns Oo Va filename Oc Oo Fl 1234abcdmqsvxz Oc 111Boot 112.Nx . 113See 114.Cm boot 115in 116.Xr boot 8 117for full details. 118.It Ic dev Op device 119Set the default device and partition for subsequent file system operations. 120Without an operand, print the current setting. 121This setting doesn't apply to 122.Tn MS-DOS 123mode. 124.It Ic help 125Print an overview about commands and arguments. 126.It Ic ls Op Pa path 127Print a directory listing of 128.Pa path , 129containing inode number, filename and file type. 130This command works in UFS mode only. 131.Pa path 132can contain a device specification. 133.It Ic mode Va fstype 134Switch file system type; 135.Va fstype 136should be one of 137.Ar dos 138or 139.Ar ufs . 140.It Ic quit 141Leave the 142.Nm 143program and exit to 144.Tn MS-DOS . 145.El 146.Pp 147.Nm 148is also installed in the 149.Xr release 7 150hierarchy, under 151.Pa installation/misc/dosboot.com . 152.Sh FILES 153.Pa /usr/mdec/dosboot.com 154.Sh EXAMPLES 155To boot a 156.Nx 157kernel located on 158.Tn MS-DOS 159drive D, one would issue: 160.Bd -literal -offset indent 161dosboot D:\eNODOS\eNETBSD 162.Ed 163.Pp 164To boot from a 165.Nx 166floppy into single user mode, type e.g.: 167.Bd -literal -offset indent 168dosboot -u fd0a:netbsd -s 169.Ed 170.Sh SEE ALSO 171.Xr release 7 , 172.Xr boot 8 173.Sh HISTORY 174The 175.Nx Ns Tn /x86 176.Nm 177command first appeared in 178.Nx 1.3 . 179.Sh BUGS 180.Nm 181assumes that the processor is in real mode at startup. 182It does not work well in the presence of 183.Tn MS-DOS 184extenders and memory managers. 185.Pp 186.Nm 187does not run directly under 188.Tn Windows 95 . 189.Pp 190In UFS mode, files can only be loaded from devices known to the BIOS. 191The device names do not necessarily comply with the names later 192used by the booted 193.Nx 194kernel. 195.Pp 196In 197.Tn MS-DOS 198mode, no useful boot device specification is passed to 199.Nx . 200It is necessary to have the root device hardwired into the kernel 201configuration or to enter it manually. 202