xref: /openbsd/sys/arch/landisk/stand/xxboot/xxboot.8 (revision d89ec533)
1.\"	$OpenBSD: xxboot.8,v 1.5 2017/07/06 17:24:49 schwarze Exp $
2.\"
3.\" Copyright (c) 2006 Michael Shalayeff
4.\" All rights reserved.
5.\"
6.\" Permission to use, copy, modify, and distribute this software for any
7.\" purpose with or without fee is hereby granted, provided that the above
8.\" copyright notice and this permission notice appear in all copies.
9.\"
10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14.\" WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER IN
15.\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
16.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17.\"
18.Dd $Mdocdate: July 6 2017 $
19.Dt XXBOOT 8 landisk
20.Os
21.Sh NAME
22.Nm xxboot
23.Nd LANDISK-specific primary boot loader
24.Sh DESCRIPTION
25This small program, residing in the reserved sectors at the beginning
26of the root file system of the system, is responsible for loading
27the second-stage
28.Xr boot 8
29program (typically /boot), which in turn will load the kernel.
30.Pp
31To install (or update) the
32.Nm
33program, use
34.Xr disklabel 8
35with the
36.Fl B
37switch.
38.Pp
39When
40.Nm
41receives control from the master boot record (MBR) it will print a banner:
42.Pp
43.Dl OpenBSD MBR
44.Pp
45followed by a little twiddler while reading the second-stage boot.
46.Sh FILES
47.Bl -tag -width /usr/mdec/xxboot -compact
48.It Pa /usr/mdec/mbr
49Master Boot Record block
50.It Pa /usr/mdec/xxboot
51primary bootstrap
52.It Pa /boot
53secondary bootstrap
54.It Pa /bsd
55.Ox
56kernel
57.It Pa /bsd.rd
58.Ox
59kernel for installation/recovery
60.El
61.Sh DIAGNOSTICS
62.Nm
63will print messages indicating errors as returned from the firmware.
64.Sh SEE ALSO
65.Xr boot 8 ,
66.Xr disklabel 8 ,
67.Xr fdisk 8 ,
68.Xr mbr 8
69