source: BOOK/final-system/ppc64-64/yaboot.xml@ 6b5c3ff7

clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 6b5c3ff7 was eaf863f, checked in by William Harrington <kb0iic@…>, 11 years ago

Fix misspelling.

  • Property mode set to 100644
File size: 4.2 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>Yaboot defaults to build as 32bit, so we need to pass appropriate
25 options to both the compiler and the linker. To prevent the build from
26 failing due to compiler warnings, the -Werror flag is removed. The
27 Makefile already overrides any CC and ignores LDFLAGS in favour of
28 its own variables, so we need to use the following seds for a
29 successful compile and install.</para>
30
31<screen><userinput>sed -i -e "s/m32/m64/g" \
32 -e "s/-Werror//" \
33 -e "s/elf32ppclinux/elf64ppc/" Makefile
34</userinput></screen>
35
36 <variablelist os="j">
37 <title>The meaning of the sed parameters:</title>
38
39 <varlistentry>
40 <term><parameter>"s/m32/m64/g"</parameter></term>
41 <listitem>
42 <para>Replaces -m32 with -m64 to force <command>gcc</command> to
43 create 64-bit code when compiling yaboot.</para>
44 </listitem>
45 </varlistentry>
46 <varlistentry>
47 <term><parameter>"s/-Werror//"</parameter></term>
48 <listitem>
49 <para>This deletes the -Werror flag from the Makefile.</para>
50 </listitem>
51 </varlistentry>
52 <varlistentry>
53 <term><parameter>"s/elf32ppclinux/elf64ppc/"</parameter></term>
54 <listitem>
55 <para>This replaces the 32 bit emulation with a 64 bit emulation
56 flag to force <command>ld</command> to use a suitable 64-bit
57 emulation picked from the output of <command>'ld -V'</command>.</para>
58 </listitem>
59 </varlistentry>
60
61 </variablelist>
62
63 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
64 href="../ppc/yaboot.xml"
65 xpointer="xpointer(//*[@os='p3'])"/>
66
67 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
68 href="../ppc/yaboot.xml"
69 xpointer="xpointer(//*[@os='p4'])"/>
70
71 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
72 href="../ppc/yaboot.xml"
73 xpointer="xpointer(//*[@os='p5'])"/>
74
75 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
76 href="../ppc/yaboot.xml"
77 xpointer="xpointer(//*[@os='p6'])"/>
78
79 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
80 href="../ppc/yaboot.xml"
81 xpointer="xpointer(//*[@os='a'])"/>
82
83 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
84 href="../ppc/yaboot.xml"
85 xpointer="xpointer(//*[@os='b'])"/>
86
87 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
88 href="../ppc/yaboot.xml"
89 xpointer="xpointer(//*[@os='c'])"/>
90
91<screen os="d"><userinput>make PREFIX=/usr</userinput></screen>
92
93 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
94 href="../ppc/yaboot.xml"
95 xpointer="xpointer(//*[@os='e'])"/>
96
97 <important os="j0">
98 <para>The install of yaboot can fail if you miss any of the
99 patches or seds. <command>ld</command> will issue warnings,
100 but the install will appear to complete successfully. That
101 would result in an unbootable system, so you need to log the
102 output to check it.</para>
103 </important>
104
105<screen os='f'><userinput>make PREFIX=/usr install 2&gt;&amp;1 | tee instlog</userinput></screen>
106
107 <para os='g'>To ensure that the install was successful, run the following
108 command:</para>
109
110<screen os='h'><userinput>grep 'powerpc:common64' instlog</userinput></screen>
111
112 <para os='i'>If the command gave you <emphasis>any</emphasis> output
113 (... is incompatible with powerpc:common output) the build of yaboot is
114 broken and you will have to correct your error(s) and repeat it.</para>
115
116 </sect2>
117
118 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
119 href="../ppc/yaboot.xml"
120 xpointer="xpointer(id('contents-yaboot'))"/>
121
122</sect1>
Note: See TracBrowser for help on using the repository browser.