source: BOOK/final-system/ppc64/yaboot.xml @ dabbced

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since dabbced was dabbced, checked in by Joe Ciccone <jciccone@…>, 13 years ago

Change the XInclude schema path from 2003 to 2001. 2003 is depreciated
according to w3.org and 2001 should be used instead.

  • Property mode set to 100644
File size: 3.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/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  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
18  href="../ppc/yaboot.xml"
19  xpointer="xpointer(//*[@role='package'])"/>
20
21  <sect2 role="installation">
22    <title>Installation of Yaboot</title>
23
24    <para>Existing multilib distributions alter gcc to default to 32-bit
25    output.  Because our gcc defaults to 64-bit, we need to pass appropriate
26    options to both the compiler and the linker.  The Makefile already
27    overrides any CC and ignores LDFLAGS in favour of its own variables, so we
28    need to use the following seds for a successful compile and install.</para>
29
30<screen><userinput>sed -i -e "s/\(-print-libgcc-file-name\)/${BUILD32} \1/" \
31    -e "s/\(-Bstatic\)/-melf32ppclinux \1/" Makefile
32</userinput></screen>
33
34    <variablelist os="j">
35      <title>The meaning of the sed parameters:</title>
36
37      <varlistentry>
38        <term><parameter>"s/\(-print-libgcc-file-name\)/${BUILD32} \1/"</parameter></term>
39        <listitem>
40          <para>This picks a convenient place within the Makefile's lgcc
41          variable and inserts the flag to force <command>gcc</command> to
42          create 32-bit code when compiling yaboot.</para>
43        </listitem>
44      </varlistentry>
45      <varlistentry>
46        <term><parameter>"s/\(-Bstatic\)/-melf32ppclinux \1/"</parameter></term>
47        <listitem>
48          <para>This picks the end of the LFLAGS which the Makefile passes to
49          the linker to create the second-stage linux loader, and inserts a
50          flag to force <command>ld</command> to use a suitable 32-bit
51          emulation picked from the output of <command>'ld -V'</command>.</para>
52        </listitem>
53      </varlistentry>
54
55    </variablelist>
56
57    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
58    href="../ppc/yaboot.xml"
59    xpointer="xpointer(//*[@os='a'])"/>
60
61    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
62    href="../ppc/yaboot.xml"
63    xpointer="xpointer(//*[@os='b'])"/>
64
65    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
66    href="../ppc/yaboot.xml"
67    xpointer="xpointer(//*[@os='c'])"/>
68
69<screen os="d"><userinput>CFLAGS="${BUILD32}" make PREFIX=/usr</userinput></screen>
70
71    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
72    href="../ppc/yaboot.xml"
73    xpointer="xpointer(//*[@os='e'])"/>
74
75    <important os="j0">
76      <para>The multilib install of yaboot can fail if you miss any of the
77      patches or seds, or omit the CFLAGS variable. <command>ld</command> will
78      issue warnings, but the install will appear to complete successfully.
79      That would result in an unbootable system, so you need to log the output
80      to check it.</para>
81    </important>
82
83<screen os='f'><userinput>make PREFIX=/usr install 2&gt;&amp;1 | tee instlog</userinput></screen>
84
85    <para os='g'>To ensure that the install was successful, run the following
86    command:</para>
87
88<screen os='h'><userinput>grep 'powerpc:common64' instlog</userinput></screen>
89
90    <para os='i'>If the command gave you <emphasis>any</emphasis> output
91    (... is incompatible with powerpc:common output) the build of yaboot is
92    broken and you will have to correct your error(s) and repeat it.</para>
93
94  </sect2>
95
96  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
97  href="../ppc/yaboot.xml"
98  xpointer="xpointer(id('contents-yaboot'))"/>
99
100</sect1>
Note: See TracBrowser for help on using the repository browser.