Sync usage with man page.
[netbsd-mini2440.git] / share / man / man8 / man8.x68k / loadbsd.8
blobdc1cbd7c8a2e20c865441e483987f69340223ba2
1 .\"     $NetBSD: loadbsd.8,v 1.3 2001/04/12 13:37:25 wiz Exp $
2 .Dd August 13, 1998
3 .Dt LOADBSD 8 x68k
4 .Os
5 .Sh NAME
6 .Nm loadbsd
7 .Nd load and boot NetBSD/x68k kernel from Human68k
8 .Sh SYNOPSIS
9 .Nm loadbsd.x
10 .Op Fl hvV
11 .Op Fl abDs
12 .Op Fl r Ar root_device
13 .Ar kernel_file
14 .Sh DESCRIPTION
15 .Nm
16 is a program runs on Human68k.
17 It loads and executes the specified
18 .Nx Ns Tn /x68k
19 kernel.
20 .Pp
21 The options (for
22 .Nm
23 itself) are as follows:
24 .Bl -tag -width flag
25 .It Fl h
26 Show help and exit.
27 .It Fl v
28 Enable verbose mode.
29 .It Fl V
30 Print version of
31 .Nm
32 and exit.
33 .El
34 .Pp
35 The options for
36 .Nx
37 kernel are as follows:
38 .Bl -tag -width flag
39 .It Fl a
40 Auto (multi-user) boot.
41 This disables
42 .Fl s
43 flag.
44 .It Fl b
45 Ask boot device during boot.
46 Pass
47 .Dv RB_ASKNAME
48 boot flag to the kernel.
49 .It Fl d
50 Use compiled-in rootdev.
51 Pass
52 .Dv RB_DFLTROOT
53 boot flag to the kernel.
54 .It Fl D
55 Enter kernel debugger.
56 Pass
57 .Dv RB_KDB
58 boot flag to the kernel.
59 .It Fl r Ar root_device
60 Specify boot device, which shall be mounted as root device.
61 The default device is
62 .Sq Li sd@0,0:a .
63 Note that the boot device name is
64 .Em not
65 the same as that of
66 .Nx .
67 See
68 .Sx BOOT DEVICE NAMES
69 below.
70 .It Fl s
71 Single user boot.
72 Pass
73 .Dv RB_SINGLE
74 boot flag to the kernel.
75 This disables
76 .Fl a
77 flag.
78 This flag is set by default.
79 .El
80 .Pp
81 Although listed separately, the options may be in any order.
82 .Sh BOOT DEVICE NAMES
83 The format of boot device names is:
84 .Pp
85 .Dl "[/interface/]dev@unit[,lun][:partition]"
86 .Pp
87 .Bl -tag -width Fl
88 .It interface
89 SCSI interface type.
90 One of:
91 .Sq Li spc@0 ,
92 .Sq Li spc@1 ,
93 .Sq Li mha@0 .
94 If the dev is a SCSI device, and interface is omitted,
95 the current boot interface is used.
96 .It dev
97 Device type.
98 One of:
99 .Sq Li fd
100 (floppy disk drive),
101 .Sq Li sd
102 (SCSI disk),
103 .Sq Li cd
104 (SCSI CD-ROM),
105 .Sq Li md
106 (Memory disk).
107 .It unit
108 Device unit #.
109 You must specify the target SCSI ID if dev is a SCSI device.
110 .It lun
111 SCSI LUN #.
112 0 is assumed if omitted.
113 .It partition
114 Partition letter of device.
115 Partition
116 .Sq Li a
117 is used if omitted.
119 .Sh FILES
120 .Bl -tag -width /usr/mdec/loadbsd.xxxx -compact
121 .It Pa /usr/mdec/loadbsd.x
122 You will find this program here.
124 .Sh SEE ALSO
125 .Xr reboot 2 ,
126 .Xr boot 8
127 .Sh HISTORY
130 utility first appeared in
131 .Nx 1.4 .
132 .Sh BUGS
134 reads the entire kernel image at once,
135 and requires enough free area on the main memory.