source: final-system/ppc64/yaboot.xml @ c25d12c

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

r3293@server (orig r1525): ken | 2006-05-05 14:04:09 -0700
Get ppc64 final-system mostly working.

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