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