~ubuntu-branches/debian/jessie/arcboot/jessie

« back to all changes in this revision

Viewing changes to debian/arcboot.8

  • Committer: Bazaar Package Importer
  • Author(s): Guido Guenther
  • Date: 2004-03-02 12:01:14 UTC
  • Revision ID: james.westby@ubuntu.com-20040302120114-0pukal9hlpt3k0l7
Tags: 0.3.8.1
correct subarch detection for IP32

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH "ARCBOOT" "8" "10 February 2002" "" ""
 
2
.SH NAME
 
3
arcboot \- bootloader for SGI/MIPS IP22 machines
 
4
.SH SYNOPSIS
 
5
 
 
6
\fB/usr/sbin/arcboot\fR <device>
 
7
 
 
8
.SH "DESCRIPTION"
 
9
.PP
 
10
\fBarcboot\fR is the bootloader used on SGI/MIPS IP22 machines. It currently
 
11
supports booting the kernel from an ext{2,3} filesystem and usually resides in
 
12
the volume header of a disk with a SGI disklabel.
 
13
.SH "USAGE"
 
14
.PP
 
15
<device> is the device name of the disk containing the volume header
 
16
\fBarcboot\fR should go into. To use \fBarcboot\fR you have to  modify
 
17
the following PROM variables:
 
18
.P
 
19
\fIsetenv OSLoader arcboot\fR
 
20
.P
 
21
\fIsetenv SystemPartition scsi(0)disk(X)rdisk(0)partition(8)\fR
 
22
.P
 
23
\fIsetenv OSLoadPartition scsi(0)disk(Y)rdisk(0)partition(Z)\fR
 
24
.P
 
25
\fIsetenv OSLoadFilename label_or_filename
 
26
.P
 
27
(where "X" is the scsi ID of the disk \fBarcboot\fR resides on and "Y" and "Z"
 
28
are the scsi ID and partition number of the partition \fB/etc/arcboot.conf\fR
 
29
resides on). Note that \fB/etc/arcboot.conf\fR and the directory your kernels
 
30
are in (usually /boot/) have to be on the same partition.  On boot
 
31
\fBarcboot\fR looks at the \fIOSLoadFilename\fR PROM variable and tries to find
 
32
a label with the same name in \fB/etc/arcboot.conf\fR.
 
33
 
 
34
.SH "Configuration File"
 
35
An entry in \fB/etc/arcboot.conf\fR has the following format:
 
36
.P
 
37
label=<label>
 
38
 image=<kernel>
 
39
 append=<boot options>
 
40
 
 
41
<label> is referenced by \fIOSLoadFilename\fR, <image> is the path to the
 
42
kernel(again relative to \fIOSLoadPartition\fR) and <boot options> are the
 
43
options appended to the kernel's command line.
 
44
 
 
45
.SH "Example"
 
46
label=linux
 
47
 image=/boot/vmlinux-2.4.17
 
48
 append="root=/dev/sda1 console=ttyS0"
 
49
 
 
50
.SH "Notes"
 
51
arcboot only loads ELF kernels. It doesn't handle ECOFF kernels to keep arcboot
 
52
as small as possible and because ECOFF kernels on mips don't contain any symbol
 
53
information which makes debugging more difficult.
 
54
 
 
55
.SH "Files"
 
56
.BR /etc/arcboot.conf
 
57
\fBarcboot\fR's configuration file
 
58
.P
 
59
.BR /usr/share/doc/arcboot/README
 
60
more details on howto setup arcboot
 
61
.PP
 
62
.SH "SEE ALSO"
 
63
.PP
 
64
dvhtool(1), elf2ecoff(8), tip22(8)
 
65
.SH "AUTHORS"
 
66
Arcboot is based on the arc bootloader for SGI Visual workstations written
 
67
by Ralf B�chle <ralf@gnu.org>. Modifications for IP22 by Guido G�nther
 
68
<agx@sigxcpu.org>.