xref: /netbsd-src/share/man/man8/man8.x68k/loadbsd.8 (revision 9be1ef4029d7119f817bcab363236d233f80c820)
1*9be1ef40Sandvar.\"	$NetBSD: loadbsd.8,v 1.7 2023/12/23 20:15:19 andvar Exp $
2*9be1ef40Sandvar.Dd December 23, 2023
3543ebd63Sitohy.Dt LOADBSD 8 x68k
439b11db8Sgarbled.Os
5543ebd63Sitohy.Sh NAME
6543ebd63Sitohy.Nm loadbsd
7543ebd63Sitohy.Nd load and boot NetBSD/x68k kernel from Human68k
8543ebd63Sitohy.Sh SYNOPSIS
9543ebd63Sitohy.Nm loadbsd.x
10543ebd63Sitohy.Op Fl hvV
11*9be1ef40Sandvar.Op Fl abDNqs
12543ebd63Sitohy.Op Fl r Ar root_device
13543ebd63Sitohy.Ar kernel_file
14543ebd63Sitohy.Sh DESCRIPTION
15543ebd63Sitohy.Nm
16543ebd63Sitohyis a program runs on Human68k.
17543ebd63SitohyIt loads and executes the specified
18543ebd63Sitohy.Nx Ns Tn /x68k
19543ebd63Sitohykernel.
20543ebd63Sitohy.Pp
21543ebd63SitohyThe options (for
22543ebd63Sitohy.Nm
23543ebd63Sitohyitself) are as follows:
24543ebd63Sitohy.Bl -tag -width flag
25543ebd63Sitohy.It Fl h
26543ebd63SitohyShow help and exit.
27*9be1ef40Sandvar.It Fl N
28*9be1ef40SandvarDo not execute the kernel, if specified in combination with boot options.
29543ebd63Sitohy.It Fl v
30543ebd63SitohyEnable verbose mode.
31543ebd63Sitohy.It Fl V
32543ebd63SitohyPrint version of
33543ebd63Sitohy.Nm
34543ebd63Sitohyand exit.
35543ebd63Sitohy.El
36543ebd63Sitohy.Pp
37543ebd63SitohyThe options for
38543ebd63Sitohy.Nx
39543ebd63Sitohykernel are as follows:
40543ebd63Sitohy.Bl -tag -width flag
41543ebd63Sitohy.It Fl a
42543ebd63SitohyAuto (multi-user) boot.
43543ebd63SitohyThis disables
44543ebd63Sitohy.Fl s
45543ebd63Sitohyflag.
46543ebd63Sitohy.It Fl b
47543ebd63SitohyAsk boot device during boot.
48543ebd63SitohyPass
49543ebd63Sitohy.Dv RB_ASKNAME
50543ebd63Sitohyboot flag to the kernel.
51543ebd63Sitohy.It Fl D
52543ebd63SitohyEnter kernel debugger.
53543ebd63SitohyPass
54543ebd63Sitohy.Dv RB_KDB
55543ebd63Sitohyboot flag to the kernel.
56543ebd63Sitohy.It Fl r Ar root_device
57543ebd63SitohySpecify boot device, which shall be mounted as root device.
58543ebd63SitohyThe default device is
59543ebd63Sitohy.Sq Li sd@0,0:a .
60543ebd63SitohyNote that the boot device name is
61543ebd63Sitohy.Em not
62543ebd63Sitohythe same as that of
63543ebd63Sitohy.Nx .
64543ebd63SitohySee
65543ebd63Sitohy.Sx BOOT DEVICE NAMES
66543ebd63Sitohybelow.
67*9be1ef40Sandvar.It Fl q
68*9be1ef40SandvarBoot the system in quiet mode.
69*9be1ef40SandvarPass
70*9be1ef40Sandvar.Dv AB_QUIET
71*9be1ef40Sandvarboot flag to the kernel.
72543ebd63Sitohy.It Fl s
73543ebd63SitohySingle user boot.
74543ebd63SitohyPass
75543ebd63Sitohy.Dv RB_SINGLE
76543ebd63Sitohyboot flag to the kernel.
77543ebd63SitohyThis disables
78543ebd63Sitohy.Fl a
79543ebd63Sitohyflag.
80543ebd63SitohyThis flag is set by default.
81543ebd63Sitohy.El
82543ebd63Sitohy.Pp
83543ebd63SitohyAlthough listed separately, the options may be in any order.
84543ebd63Sitohy.Sh BOOT DEVICE NAMES
85543ebd63SitohyThe format of boot device names is:
86543ebd63Sitohy.Pp
87543ebd63Sitohy.Dl "[/interface/]dev@unit[,lun][:partition]"
88543ebd63Sitohy.Pp
89543ebd63Sitohy.Bl -tag -width Fl
90543ebd63Sitohy.It interface
91543ebd63SitohySCSI interface type.
92543ebd63SitohyOne of:
93543ebd63Sitohy.Sq Li spc@0 ,
94543ebd63Sitohy.Sq Li spc@1 ,
95543ebd63Sitohy.Sq Li mha@0 .
96543ebd63SitohyIf the dev is a SCSI device, and interface is omitted,
97543ebd63Sitohythe current boot interface is used.
98543ebd63Sitohy.It dev
99543ebd63SitohyDevice type.
100543ebd63SitohyOne of:
101543ebd63Sitohy.Sq Li fd
102543ebd63Sitohy(floppy disk drive),
103543ebd63Sitohy.Sq Li sd
104543ebd63Sitohy(SCSI disk),
105543ebd63Sitohy.Sq Li cd
106543ebd63Sitohy(SCSI CD-ROM),
107543ebd63Sitohy.Sq Li md
108543ebd63Sitohy(Memory disk).
109543ebd63Sitohy.It unit
110543ebd63SitohyDevice unit #.
111543ebd63SitohyYou must specify the target SCSI ID if dev is a SCSI device.
112543ebd63Sitohy.It lun
113543ebd63SitohySCSI LUN #.
114543ebd63Sitohy0 is assumed if omitted.
115543ebd63Sitohy.It partition
116543ebd63SitohyPartition letter of device.
117543ebd63SitohyPartition
118543ebd63Sitohy.Sq Li a
119543ebd63Sitohyis used if omitted.
120543ebd63Sitohy.El
121543ebd63Sitohy.Sh FILES
122543ebd63Sitohy.Bl -tag -width /usr/mdec/loadbsd.xxxx -compact
123543ebd63Sitohy.It Pa /usr/mdec/loadbsd.x
124543ebd63SitohyYou will find this program here.
125543ebd63Sitohy.El
126543ebd63Sitohy.Sh SEE ALSO
127543ebd63Sitohy.Xr reboot 2 ,
1283af2acdcSchristos.Xr x68k/boot 8
129543ebd63Sitohy.Sh HISTORY
130543ebd63SitohyThe
131543ebd63Sitohy.Nm
132543ebd63Sitohyutility first appeared in
133543ebd63Sitohy.Nx 1.4 .
1344e2d7523Swiz.Sh BUGS
1354e2d7523Swiz.Nm
1364e2d7523Swizreads the entire kernel image at once,
1374e2d7523Swizand requires enough free area on the main memory.
138