summaryrefslogtreecommitdiff
path: root/debian/arcboot.8
blob: 533c412cc7854e6a92c629227d9cf4878f0bf234 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
.TH "ARCBOOT" "8" "10 February 2002" "" ""
.SH NAME
arcboot \- bootloader for SGI/MIPS IP22 machines
.SH SYNOPSIS

\fB/usr/sbin/arcboot\fR <device>

.SH "DESCRIPTION"
.PP
\fBarcboot\fR is the bootloader used on SGI/MIPS IP22 machines. It currently
supports booting the kernel from an ext{2,3} filesystem and usually resides in
the volume header of a disk with a SGI disklabel.
.SH "USAGE"
.PP
<device> is the device name of the disk containing the volume header
\fBarcboot\fR should go into. To use \fBarcboot\fR you have to  modify
the following PROM variables:
.P
\fIsetenv OSLoader arcboot\fR
.P
\fIsetenv SystemPartition scsi(0)disk(X)rdisk(0)partition(8)\fR
.P
\fIsetenv OSLoadPartition scsi(0)disk(Y)rdisk(0)partition(Z)\fR
.P
\fIsetenv OSLoadFilename label_or_filename
.P
(where "X" is the scsi ID of the disk \fBarcboot\fR resides on and "Y" and "Z"
are the scsi ID and partition number of the partition \fB/etc/arcboot.conf\fR
resides on). Note that \fB/etc/arcboot.conf\fR and the directory your kernels
are in (usually /boot/) have to be on the same partition.  On boot
\fBarcboot\fR looks at the \fIOSLoadFilename\fR PROM variable and tries to find
a label with the same name in \fB/etc/arcboot.conf\fR.

.SH "Configuration File"
An entry in \fB/etc/arcboot.conf\fR has the following format:
.P
label=<label>
 image=<kernel>
 append=<boot options>

<label> is referenced by \fIOSLoadFilename\fR, <image> is the path to the
kernel(again relative to \fIOSLoadPartition\fR) and <boot options> are the
options appended to the kernel's command line.

.SH "Example"
label=linux
 image=/boot/vmlinux-2.4.17
 append="root=/dev/sda1 console=ttyS0"

.SH "Notes"
arcboot only loads ELF kernels. It doesn't handle ECOFF kernels to keep arcboot
as small as possible and because ECOFF kernels on mips don't contain any symbol
information which makes debugging more difficult.

.SH "Files"
.BR /etc/arcboot.conf
\fBarcboot\fR's configuration file
.P
.BR /usr/share/doc/arcboot/README
more details on howto setup arcboot
.PP
.SH "SEE ALSO"
.PP
dvhtool(1), elf2ecoff(8), tip22(8)
.SH "AUTHORS"
Arcboot is based on the arc bootloader for SGI Visual workstations written
by Ralf Bächle <ralf@gnu.org>. Modifications for IP22 by Guido Günther
<agx@sigxcpu.org>.