source: final-system/ppc/yaboot.xml @ 3d23af3

Last change on this file since 3d23af3 was 3d23af3, checked in by Jim Gifford <clfs@…>, 16 years ago

r3373@server (orig r1556): ken | 2006-05-10 15:15:06 -0700
Improve yaboot.conf and add examples of sata paths, drop reference to pegasos ppc for lack of information, and correct my attempts to spell Open Firmware as one word.

  • Property mode set to 100644
File size: 5.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-yaboot" role="wrap">
9  <?dbhtml filename="yaboot.html"?>
10
11  <title>Yaboot-&yaboot-version;</title>
12
13  <indexterm zone="ch-system-yaboot">
14    <primary sortas="a-Yaboot">Yaboot</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Yaboot package contains a PowerPC Boot Loader for machines using
21    Open Firmware such as NewWorld Macintoshes.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Yaboot</title>
27
28    <para os="a">Yaboot has a compilation error. The following patch properly
29    fixes the issue:</para>
30
31<screen os="b"><userinput>patch -Np1 -i ../&yaboot-fix-patch;</userinput></screen>
32
33    <para os="c">The following patch removes a redundant test which prevents
34    <command>ofpath</command> from executing against SATA disks:</para>
35
36<screen os="d"><userinput>patch -Np1 -i ../&yaboot-sata-patch;</userinput></screen>
37
38    <para os="e">The supplied man pages have <filename
39    class="directory">/usr/local</filename> in the text. This sed will correct
40    that:</para>
41
42<screen os="f"><userinput>sed -i 's%/usr/local%/usr%' man/*</userinput></screen>
43
44    <para os="g">Compile the package:</para>
45
46<screen os="h"><userinput>make PREFIX=/usr</userinput></screen>
47
48    <para os="i">Install the package:</para>
49
50<screen os="j"><userinput>make PREFIX=/usr install</userinput></screen>
51
52  </sect2>
53
54  <sect2 id="contents-yaboot" role="content">
55    <title>Contents of Yaboot</title>
56
57    <segmentedlist>
58      <segtitle>Installed programs</segtitle>
59      <segtitle>Installed files</segtitle>
60
61      <seglistitem>
62        <seg>addnote, mkofboot (link to ybin), ofboot, ofpath, yaboot,
63        yabootconfig, ybin</seg>
64        <seg>yaboot.conf</seg>
65      </seglistitem>
66    </segmentedlist>
67
68    <variablelist>
69      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
70      <?dbfo list-presentation="list"?>
71      <?dbhtml list-presentation="table"?>
72
73      <varlistentry id="addnote">
74        <term><command>addnote</command></term>
75  <listitem>
76    <para>For IBM CHRP machines, add a PT_NOTE program header
77    entry to an elf file so that it can be booted.</para>
78    <indexterm zone="ch-system-yaboot addnote">
79      <primary sortas="b-addnote">addnote</primary>
80    </indexterm>
81  </listitem>
82      </varlistentry>
83
84      <varlistentry id="mkofboot">
85        <term><command>mkofboot</command></term>
86        <listitem>
87          <para>Format the bootstrap partition and install the yaboot
88          boot loader.</para>
89          <indexterm zone="ch-system-yaboot mkofboot">
90            <primary sortas="b-mkofboot">mkofboot</primary>
91          </indexterm>
92        </listitem>
93      </varlistentry>
94
95      <varlistentry id="ofboot">
96        <term><command>ofboot</command></term>
97        <listitem>
98          <para>Script to format the boot menu using yaboot.conf and
99    write the resulting Open Firmware code to the bootstrap.</para>
100          <indexterm zone="ch-system-yaboot ofboot">
101            <primary sortas="b-ofboot">ofboot</primary>
102          </indexterm>
103        </listitem>
104      </varlistentry>
105
106      <varlistentry id="ofpath">
107        <term><command>ofpath</command></term>
108        <listitem>
109          <para>Determine Open Firmware path corresponding to a device
110    node.</para>
111          <indexterm zone="ch-system-yaboot ofpath">
112            <primary sortas="b-ofpath">ofpath</primary>
113          </indexterm>
114        </listitem>
115      </varlistentry>
116
117      <varlistentry id="yaboot">
118        <term><command>yaboot</command></term>
119        <listitem>
120          <para>Open Firmware boot loader.</para>
121          <indexterm zone="ch-system-yaboot yaboot">
122            <primary sortas="b-yaboot">yaboot</primary>
123          </indexterm>
124        </listitem>
125      </varlistentry>
126
127      <varlistentry id="yabootconfig">
128        <term><command>yabootconfig</command></term>
129        <listitem>
130          <para>Generate and install a simple yaboot.conf.</para>
131          <indexterm zone="ch-system-yaboot yabootconfig">
132            <primary sortas="b-yabootconfig">yabootconfig</primary>
133          </indexterm>
134        </listitem>
135      </varlistentry>
136
137      <varlistentry id="ybin">
138        <term><command>ybin</command></term>
139        <listitem>
140          <para>Shell script to update or install the boot loader
141    on a bootstrap partition.</para>
142          <indexterm zone="ch-system-yaboot ybin">
143            <primary sortas="b-ybin">ybin</primary>
144          </indexterm>
145        </listitem>
146      </varlistentry>
147
148      <varlistentry id="yaboot.conf">
149        <term><filename>yaboot.conf</filename></term>
150        <listitem>
151          <para>Configuration file used by <command>ybin</command> to determine
152    how to install <command>yaboot</command> on the bootstrap partition.</para>
153          <indexterm zone="ch-system-yaboot yaboot.conf">
154            <primary sortas="e-yaboot.conf">yaboot.conf</primary>
155          </indexterm>
156        </listitem>
157      </varlistentry>
158
159    </variablelist>
160
161  </sect2>
162
163</sect1>
Note: See TracBrowser for help on using the repository browser.