share/man/man8/man8.i386/dosboot.8

   1 .\"     $NetBSD: dosboot.8,v 1.19 2009/03/11 19:26:09 joerg 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 October 13, 2008
  30 .Dt DOSBOOT 8 i386
  31 .Os
  32 .Sh NAME
  33 .Nm dosboot
  34 .Nd boot NetBSD/i386 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
  43 is an
  44 .Tn MS-DOS
  45 program.
  46 It is a boot loader for
  47 .Nx Ns Tn /i386
  48 designed to permit
  49 .Nx
  50 to be booted directly from
  51 .Tn MS-DOS .
  52 By default, it boots a file with name
  53 .Pa NETBSD
  54 in the current
  55 .Tn MS-DOS
  56 directory.
  57 .Nm
  58 shares common code with the standard boot loader,
  59 .Xr boot 8 .
  60 .Pp
  61 The recognized options are:
  62 .Bl -tag -width -ads -offset 04n
  63 .It Fl c
  64 Execute
  65 .Ar command
  66 (see below).
  67 .It Fl i
  68 Enter interactive mode.
  69 .Nm
  70 will present a prompt, allowing input of commands (see below).
  71 .It Fl u
  72 Boot from a UFS filesystem instead of an
  73 .Tn MS-DOS
  74 filesystem.
  75 .It Ar path
  76 Specifies the kernel file.
  77 In
  78 .Tn MS-DOS
  79 mode (default) a normal
  80 .Tn MS-DOS
  81 filename (with or without drive specification) is accepted.
  82 In UFS mode (after
  83 .Fl u
  84 or after a
  85 .Ic mode ufs
  86 command), a path in a
  87 .Nx
  88 filesystem is expected.
  89 By default, the file is looked up in partition
  90 .Sq a
  91 of the first harddisk.
  92 Another device or partition can be specified
  93 by prepending a block device name in terms of
  94 .Nx ,
  95 followed by a colon (see
  96 .Xr boot 8
  97 and examples).
  98 .It Fl adqsv
  99 Flags passed to the kernel, see
 100 .Xr boot 8 .
 101 .El
 102 .Pp
 103 The commands accepted after the
 104 .Fl c
 105 flag or in interactive mode are:
 106 .\" NOTE: some of this text is duplicated in the MI boot.8
 107 .\" and in other i386-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 : Ns Oc Oo Va filename Oc Oo Fl 1234abcdmqsvxz Oc
 111 Boot
 112 .Nx .
 113 See
 114 .Cm boot
 115 in
 116 .Xr boot 8
 117 for full details.
 118 .It Ic dev Op device
 119 Set the default device and partition for subsequent filesystem operations.
 120 Without an operand, print the current setting.
 121 This setting doesn't apply to
 122 .Tn MS-DOS
 123 mode.
 124 .It Ic help
 125 Print an overview about commands and arguments.
 126 .It Ic ls Op Pa path
 127 Print a directory listing of
 128 .Pa path ,
 129 containing inode number, filename and file type.
 130 This command works in UFS mode only.
 131 .Pa path
 132 can contain a device specification.
 133 .It Ic mode Va fstype
 134 Switch filesystem type;
 135 .Va fstype
 136 should be one of
 137 .Ar dos
 138 or
 139 .Ar ufs .
 140 .It Ic quit
 141 Leave the
 142 .Nm
 143 program and exit to
 144 .Tn MS-DOS .
 145 .El
 146 .Pp
 147 .Nm
 148 is also installed in the
 149 .Xr release 7
 150 hierarchy, under
 151 .Pa installation/misc/dosboot.com .
 152 .Sh FILES
 153 .Pa /usr/mdec/dosboot.com
 154 .Sh EXAMPLES
 155 To boot a
 156 .Nx
 157 kernel located on
 158 .Tn MS-DOS
 159 drive D, one would issue:
 160 .Bd -literal -offset indent
 161 dosboot D:\eNODOS\eNETBSD
 162 .Ed
 163 .Pp
 164 To boot from a
 165 .Nx
 166 floppy into single user mode, type e.g.:
 167 .Bd -literal -offset indent
 168 dosboot -u fd0a:netbsd -s
 169 .Ed
 170 .Sh SEE ALSO
 171 .Xr release 7 ,
 172 .Xr boot 8 ,
 173 .Xr w95boot 8
 174 .Sh HISTORY
 175 The
 176 .Nx Ns Tn /i386
 177 .Nm
 178 command first appeared in
 179 .Nx 1.3 .
 180 .Sh BUGS
 181 .Nm
 182 assumes that the processor is in real mode at startup.
 183 It does not work well in the presence of
 184 .Tn MS-DOS
 185 extenders and memory managers.
 186 .Pp
 187 .Nm
 188 does not run directly under
 189 .Tn Windows 95 .
 190 See
 191 .Xr w95boot 8
 192 for a method of starting
 193 .Nx
 194 from
 195 .Tn Windows 95
 196 using dosboot.
 197 .Pp
 198 In UFS mode, files can only be loaded from devices known to the BIOS.
 199 The device names do not necessarily comply with the names later
 200 used by the booted
 201 .Nx
 202 kernel.
 203 .Pp
 204 In
 205 .Tn MS-DOS
 206 mode, no useful boot device specification is passed to
 207 .Nx .
 208 It is necessary to have the root device hardwired into the kernel
 209 configuration or to enter it manually.