source: final-system/ppc/yaboot.xml @ da23eb8

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

r3360@server (orig r1549): ken | 2006-05-10 09:56:16 -0700
Make yaboot work in ppc64 final-system, and label ppc64 as working in the main index.

  • Property mode set to 100644
File size: 5.4 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    OpenFirmware such as NewWorld Macintoshes.</para>
22
23    <segmentedlist>
24      <segtitle>&dependencies;</segtitle>
25
26      <seglistitem>
27        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep,
28        Make, Ncurses, and Sed</seg>
29      </seglistitem>
30    </segmentedlist>
31
32  </sect2>
33
34  <sect2 role="installation">
35    <title>Installation of Yaboot</title>
36
37    <para os="a">Yaboot has a compilation error. The following patch properly
38    fixes the issue:</para>
39
40<screen os="b"><userinput>patch -Np1 -i ../&yaboot-fix-patch;</userinput></screen>
41
42    <para os="c">The following patch removes a redundant test which prevents
43    <command>ofpath</command> from executing against SATA disks:</para>
44
45<screen os="d"><userinput>patch -Np1 -i ../&yaboot-sata-patch;</userinput></screen>
46
47    <para os="e">The supplied man pages have <filename
48    class="directory">/usr/local</filename> in the text. This sed will correct
49    that:</para>
50
51<screen os="f"><userinput>sed -i 's%/usr/local%/usr%' man/*</userinput></screen>
52
53    <para os="g">Compile the package:</para>
54
55<screen os="h"><userinput>make PREFIX=/usr</userinput></screen>
56
57    <para os="i">Install the package:</para>
58
59<screen os="j"><userinput>make PREFIX=/usr install</userinput></screen>
60
61  </sect2>
62
63  <sect2 id="contents-yaboot" role="content">
64    <title>Contents of Yaboot</title>
65
66    <segmentedlist>
67      <segtitle>Installed programs</segtitle>
68      <segtitle>Installed files</segtitle>
69
70      <seglistitem>
71        <seg>addnote, mkofboot (link to ybin), ofboot, ofpath, yaboot,
72        yabootconfig, ybin</seg>
73        <seg>yaboot.conf</seg>
74      </seglistitem>
75    </segmentedlist>
76
77    <variablelist>
78      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
79      <?dbfo list-presentation="list"?>
80      <?dbhtml list-presentation="table"?>
81
82      <varlistentry id="addnote">
83        <term><command>addnote</command></term>
84  <listitem>
85    <para>For IBM CHRP machines, add a PT_NOTE program header
86    entry to an elf file so that it can be booted.</para>
87    <indexterm zone="ch-system-yaboot addnote">
88      <primary sortas="b-addnote">addnote</primary>
89    </indexterm>
90  </listitem>
91      </varlistentry>
92
93      <varlistentry id="mkofboot">
94        <term><command>mkofboot</command></term>
95        <listitem>
96          <para>Format the bootstrap partition and install the yaboot
97          boot loader.</para>
98          <indexterm zone="ch-system-yaboot mkofboot">
99            <primary sortas="b-mkofboot">mkofboot</primary>
100          </indexterm>
101        </listitem>
102      </varlistentry>
103
104      <varlistentry id="ofboot">
105        <term><command>ofboot</command></term>
106        <listitem>
107          <para>Script to format the boot menu using yaboot.conf and
108    write the resulting OpenFirmware code to the bootstrap.</para>
109          <indexterm zone="ch-system-yaboot ofboot">
110            <primary sortas="b-ofboot">ofboot</primary>
111          </indexterm>
112        </listitem>
113      </varlistentry>
114
115      <varlistentry id="ofpath">
116        <term><command>ofpath</command></term>
117        <listitem>
118          <para>Determine OpenFirmware path corresponding to a device
119    node.</para>
120          <indexterm zone="ch-system-yaboot ofpath">
121            <primary sortas="b-ofpath">ofpath</primary>
122          </indexterm>
123        </listitem>
124      </varlistentry>
125
126      <varlistentry id="yaboot">
127        <term><command>yaboot</command></term>
128        <listitem>
129          <para>OpenFirmware boot loader.</para>
130          <indexterm zone="ch-system-yaboot yaboot">
131            <primary sortas="b-yaboot">yaboot</primary>
132          </indexterm>
133        </listitem>
134      </varlistentry>
135
136      <varlistentry id="yabootconfig">
137        <term><command>yabootconfig</command></term>
138        <listitem>
139          <para>Generate and install a simple yaboot.conf.</para>
140          <indexterm zone="ch-system-yaboot yabootconfig">
141            <primary sortas="b-yabootconfig">yabootconfig</primary>
142          </indexterm>
143        </listitem>
144      </varlistentry>
145
146      <varlistentry id="ybin">
147        <term><command>ybin</command></term>
148        <listitem>
149          <para>Shell script to update or install the boot loader
150    on a bootstrap partition.</para>
151          <indexterm zone="ch-system-yaboot ybin">
152            <primary sortas="b-ybin">ybin</primary>
153          </indexterm>
154        </listitem>
155      </varlistentry>
156
157      <varlistentry id="yaboot.conf">
158        <term><filename>yaboot.conf</filename></term>
159        <listitem>
160          <para>Configuration file used by <command>ybin</command> to determine
161    how to install <command>yaboot</command> on the bootstrap partition.</para>
162          <indexterm zone="ch-system-yaboot yaboot.conf">
163            <primary sortas="e-yaboot.conf">yaboot.conf</primary>
164          </indexterm>
165        </listitem>
166      </varlistentry>
167
168    </variablelist>
169
170  </sect2>
171
172</sect1>
Note: See TracBrowser for help on using the repository browser.