/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.21 Revision 1.22
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v 1.21 2006/06/12 10:18:17 neysx Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v 1.22 2006/08/30 22:52:28 nightmorph Exp $ -->
8 8<!-- :vim:ts=2:sts=2:et:tw=80: -->
9<sections> 9<sections>
10 10
11<version>1.16</version> 11<version>7.0</version>
12<date>2006-02-27</date> 12<date>2006-08-30</date>
13 13
14<section> 14<section>
15<title>Timezone</title> 15<title>Timezone</title>
16<body> 16<body>
17 17
27# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i> 27# <i>cp /usr/share/zoneinfo/GMT /etc/localtime</i>
28</pre> 28</pre>
29 29
30</body> 30</body>
31</section> 31</section>
32
32<section> 33<section>
33<title>Installing the Sources</title> 34<title>Installing the Sources</title>
34<subsection> 35<subsection>
35<title>Choosing a Kernel</title> 36<title>Choosing a Kernel</title>
36<body> 37<body>
43Guide</uri>. 44Guide</uri>.
44</p> 45</p>
45 46
46<p> 47<p>
47MIPS-based systems have just the one kernel tree to choose from, 48MIPS-based systems have just the one kernel tree to choose from,
48<c>mips-sources</c>. Special patches are needed to make certain systems work. 49<c>mips-sources</c>. <!--Special patches are needed to make certain systems work.
49The table below displays the USE flags required to enable the patchsets. Note 50The table below displays the USE flags required to enable the patchsets. Note
50that Indy, Indigo2 (R4k) and Challenge S systems do not require any additional 51that Indy, Indigo2 (R4k) and Challenge S systems do not require any additional
51patchsets. 52patchsets.--> This patchset differs from the ones available for other
53architectures, in that it has lots of patches specific to the MIPS architecture.
52</p> 54</p>
53 55
56<!--
54<table> 57<table>
55<tr> 58<tr>
56 <th>USE flag</th> 59 <th>USE flag</th>
57 <th>System</th> 60 <th>System</th>
58</tr> 61</tr>
70</tr> 73</tr>
71<tr> 74<tr>
72 <ti><c>ip30</c></ti> 75 <ti><c>ip30</c></ti>
73 <ti>SGI Octane/Octane2 support (1)</ti> 76 <ti>SGI Octane/Octane2 support (1)</ti>
74</tr> 77</tr>
75</table> 78</table>-->
76 79
77<note> 80<note>
78The <c>USE="-doc"</c> disables the generation of kernel API documentation, 81The <c>USE="-doc"</c> disables the generation of kernel API documentation,
79which would otherwise pull in numerous dependancies not required for this step. 82which would otherwise pull in numerous dependancies not required for this step.
80</note> 83</note>
81 84
82<pre caption="Setting USE flags and merging kernel sources..."> 85<pre caption="Merging kernel sources...">
86<!-- Done by profile?
83<comment>(Substitute cobalt with the appropriate USE flag for your system if required)</comment> 87<comment>(Substitute cobalt with the appropriate USE flag for your system if required)</comment>
84# <i>mkdir /etc/portage</i> 88# <i>mkdir /etc/portage</i>
85# <i>echo "sys-kernel/mips-sources cobalt" &gt;&gt; /etc/portage/package.use</i> 89# <i>echo "sys-kernel/mips-sources cobalt" &gt;&gt; /etc/portage/package.use</i>
86 90-->
87<comment>(Unpack &amp; install the kernel sources)</comment> 91<comment>(Unpack &amp; install the kernel sources)</comment>
88# <i>USE="-doc" emerge mips-sources</i> 92# <i>USE="-doc" emerge mips-sources</i>
89</pre> 93</pre>
90 94
91<impo> 95<impo>
92(1) On the Origin 200/2000, Indigo2 Impact (R10000), Octane/Octane2 and O2, a 96<!--(1)--> On the Origin 200/2000, Indigo2 Impact (R10000), Octane/Octane2 and
9364-bit kernel is required to boot these systems. For these machines, you should 97O2, a 64-bit kernel is required to boot these systems. For these machines, you
94switch to the <path>default-linux/mips/mips64/RELEASE</path> profile by 98should <!--switch to the <path>default-linux/mips/mips64/RELEASE</path>
95altering the <path>/etc/make.profile</path> symlink. Then you can <c>emerge 99profile by altering the <path>/etc/make.profile</path> symlink.
100Then you can --><c>emerge
96gcc-mips64</c> to create a cross-compiler for building 64-bit kernels. 101kgcc64</c> to create a cross-compiler for building 64-bit kernels.
97</impo> 102</impo>
98 103
99<impo> 104<!--<impo>
100(2) The Indigo2 Impact is a special case in that it requires special patch to 105(2) The Indigo2 Impact is a special case in that it requires special patch to
101be applied to <c>gcc</c> before it will build an IP28 kernel correctly. This 106be applied to <c>gcc</c> before it will build an IP28 kernel correctly. This
102patch adds support for the <c>-mip28-cache-barriers</c> CFLAG, which is used 107patch adds support for the <c>-mip28-cache-barriers</c> CFLAG, which is used
103when building kernels to work around the inherent hardware bug brought on by 108when building kernels to work around the inherent hardware bug brought on by
104speculative execution. This USE flag can be set in <path>/etc/make.conf</path>. 109speculative execution. This USE flag can be set in <path>/etc/make.conf</path>.
105This is done for you by setting your profile to 110This is done for you by setting your profile to
106<path>default-linux/mips/mips64/ip28/RELEASE</path>, which also takes care of 111<path>default-linux/mips/mips64/ip28/RELEASE</path>, which also takes care of
107(1). 112(1).
108</impo> 113</impo>-->
109 114
110<pre caption="Changing Profiles and installing gcc-mips64..."> 115<pre caption="Installing kgcc64...">
111<comment>(This assumes PORTDIR is in the usual location; /usr/portage)</comment> 116<!--<comment>(This assumes PORTDIR is in the usual location; /usr/portage)</comment>
112# <i>rm /etc/make.profile</i> 117# <i>rm /etc/make.profile</i>
113# <i>ln -s /usr/portage/profiles/default-linux/mips/mips64/2005.0</i> <comment>(or .../mips64/ip28/2005.0)</comment> 118# <i>ln -s /usr/portage/profiles/default-linux/mips/mips64/2005.0</i> <comment>(or .../mips64/ip28/2005.0)</comment>
114 119
115<comment>(Install the 64-bit kernel toolchain)</comment> 120<comment>(Install the 64-bit kernel toolchain)</comment>
116# <i>emerge gcc-mips64</i> 121--># <i>emerge kgcc64</i>
117</pre> 122</pre>
118 123
119<p> 124<p>
120When you take a look in <path>/usr/src</path> you should see a symlink called 125When you take a look in <path>/usr/src</path> you should see a symlink called
121<path>linux</path> pointing to your kernel source. In this case, the installed 126<path>linux</path> pointing to your kernel source. In this case, the installed
122kernel source points to <c>mips-sources-2.4.24</c>. Your version may be 127kernel source points to <c>mips-sources-2.6.13.4</c>. Your version may be
123different, so keep this in mind. 128different, so keep this in mind.
124</p> 129</p>
125 130
126<pre caption="Viewing the kernel source symlink"> 131<pre caption="Viewing the kernel source symlink">
127# <i>ls -l /usr/src/linux</i> 132# <i>ls -l /usr/src/linux</i>
277compiling the kernel. This should be turned off, even if cross-compiling. 282compiling the kernel. This should be turned off, even if cross-compiling.
278Instead, if you do need to call a cross-compiler, specify the prefix using the 283Instead, if you do need to call a cross-compiler, specify the prefix using the
279<c>CROSS_COMPILE</c> variable as shown in the next section. 284<c>CROSS_COMPILE</c> variable as shown in the next section.
280</impo> 285</impo>
281 286
287<impo>
288There is a known issue with JFS and ALSA on Octane systems where the ALSA fails
289to work. Given the experimental nature of JFS on MIPS, it is recommended that
290people avoid using JFS for the time being.
291</impo>
292
282</body> 293</body>
283</subsection> 294</subsection>
284<subsection id="compiling"> 295<subsection id="compiling">
285<title>Compiling and Installing</title> 296<title>Compiling and Installing</title>
286<body> 297<body>
341 352
342<comment>(Cobalt Servers -- Compressing the kernel image)</comment> 353<comment>(Cobalt Servers -- Compressing the kernel image)</comment>
343# <i>gzip -9v /boot/kernel-2.6.13.4</i> 354# <i>gzip -9v /boot/kernel-2.6.13.4</i>
344</pre> 355</pre>
345 356
346<!--
347Moot point, now that we use arcboot on SGI, and CoLo on Cobalts
348<p>
349If your system doesn't boot ELF kernels, compile the
350kernel using <c>make vmlinux.ecoff</c> instead of <c>make vmlinux</c>. The
351kernel image will be saved as <path>arch/mips/boot/vmlinux.ecoff</path> instead
352of <path>vmlinux</path>.
353</p>
354-->
355</body> 357</body>
356</subsection> 358</subsection>
357</section> 359</section>
358<section id="kernel_modules"> 360<section id="kernel_modules">
359<title>Installing Separate Kernel Modules</title> 361<title>Installing Separate Kernel Modules</title>

Legend:
Removed from v.1.21  
changed lines
  Added in v.1.22

  ViewVC Help
Powered by ViewVC 1.1.20