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

Contents of /xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (show annotations) (download) (as text)
Mon Aug 30 17:44:00 2004 UTC (13 years, 11 months ago) by neysx
Branch: MAIN
Changes since 1.1: +5 -6 lines
File MIME type: application/xml
#62186: Fixed language mistakes all over the place thanks to John Richards

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v 1.1 2004/08/05 13:07:33 swift Exp $ -->
8
9 <sections>
10 <section>
11 <title>Timezone</title>
12 <body>
13
14 <p>
15 You first need to select your timezone so that your system knows where
16 it is located. Look for your timezone in
17 <path>/usr/share/zoneinfo</path>, then make a symlink to
18 <path>/etc/localtime</path> using <c>ln</c>:
19 </p>
20
21 <pre caption="Setting the timezone information">
22 # <i>ls /usr/share/zoneinfo</i>
23 <comment>(Suppose you want to use GMT)</comment>
24 # <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i>
25 </pre>
26
27 </body>
28 </section>
29 <section>
30 <title>Installing the Sources</title>
31 <subsection>
32 <title>Choosing a Kernel</title>
33 <body>
34
35 <p>
36 The core around which all distributions are built is the Linux kernel.
37 It is the layer between the user programs and your system hardware.
38 Gentoo provides its users several possible kernel sources. A full
39 listing with description is available at the <uri
40 link="/doc/en/gentoo-kernel.xml">Gentoo Kernel Guide</uri>.
41 </p>
42
43 <p>
44 For PPC64 you should use <c>gentoo-dev-sources</c>. So let's continue with
45 <c>emerge</c>'ing the kernel sources:
46 </p>
47
48 <pre caption="Installing a kernel source">
49 # <i>emerge gentoo-dev-sources</i>
50 </pre>
51
52 <p>
53 When you take a look in <path>/usr/src</path> you should see a symlink
54 called <path>linux</path> pointing to your kernel source:
55 </p>
56
57 <pre caption="Viewing the kernel source symlink">
58 # <i>ls -l /usr/src/linux</i>
59 lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux
60 -&gt; linux-2.6.7-gentoo-r8
61 </pre>
62
63 <p>
64 If this isn't the case (i.e. the symlink points to a different kernel
65 source) change the symlink before you continue:
66 </p>
67
68 <pre caption="Changing the kernel source symlink">
69 # <i>rm /usr/src/linux</i>
70 # <i>cd /usr/src</i>
71 # <i>ln -s linux-2.6.7-gentoo-r8 linux</i>
72 </pre>
73
74 <p>
75 Now it is time to configure and compile your kernel source. There is the
76 ability to use "genkernel" which would create a generic kernel like the
77 ones used on the live cds, but it is not fully functional for PPC64 at
78 the moment.
79 </p>
80
81 <p>
82 Continue now with <uri link="#manual">Manual Configuration</uri>.
83 </p>
84
85 </body>
86 </subsection>
87 </section>
88 <section id="manual">
89 <title>Manual Configuration</title>
90 <subsection>
91 <title>Introduction</title>
92 <body>
93
94 <p>
95 Manually configuring a kernel is often seen as the most difficult procedure a
96 Linux users ever has to perform. Nothing is less true -- after configuring a
97 couple of kernels you don't even remember that it was difficult ;)
98 </p>
99
100 <p>
101 However, one thing <e>is</e> true: you must know your system when you
102 start configuring a kernel manually. Most information can be gathered by
103 viewing the contents of <path>/proc/pci</path> (or by using <c>lspci</c>
104 if available). You can also run <c>lsmod</c> to see what kernel modules
105 the LiveCD uses (it might provide you with a nice hint on what to
106 enable).
107 </p>
108
109 <p>
110 Now go to your kernel source directory and execute <c>make
111 menuconfig</c>. This will fire up an ncurses-based configuration menu.
112 </p>
113
114 <pre caption="Invoking menuconfig">
115 # <i>cd /usr/src/linux</i>
116 # <i>make menuconfig</i>
117 </pre>
118
119 <p>
120 You will be greeted with several configuration sections. We'll first
121 list some options you must activate (otherwise Gentoo will not function,
122 or not function properly without additional tweaks).
123 </p>
124
125 </body>
126 </subsection>
127 <subsection>
128 <title>Activating Required Options</title>
129 <body>
130
131 <p>
132 First of all, activate the use of development and experimental
133 code/drivers. You need this, otherwise some very important code/drivers
134 won't show up:
135 </p>
136
137 <pre caption="Selecting experimental code/drivers">
138 Code maturity level options ---&gt;
139 [*] Prompt for development and/or incomplete code/drivers
140 </pre>
141
142 <p>
143 Now go to <c>File Systems</c> and select support for the filesystems you
144 use. <e>Don't</e> compile them as modules, otherwise your Gentoo system
145 will not be able to mount your partitions. Also select <c>Virtual
146 memory</c>, <c>/proc file system</c>, <c>/dev file system</c> +
147 <c>Automatically mount at boot</c> and <c>/dev/pts file system for
148 Unix98 PTYs</c>:
149 </p>
150
151 <pre caption="Selecting necessary file systems">
152 File systems ---&gt;
153 [*] Virtual memory file system support (former shm fs)
154 [*] /proc file system support
155 [*] /dev file system support (EXPERIMENTAL)
156 [*] Automatically mount at boot
157 [*] /dev/pts file system for Unix98 PTYs
158
159 <comment>(Select one or more of the following options as needed by your system)</comment>
160 &lt;*&gt; Reiserfs support
161 &lt;*&gt; Ext3 journalling file system support
162 &lt;*&gt; JFS filesystem support
163 &lt;*&gt; Second extended fs support
164 &lt;*&gt; XFS filesystem support
165 </pre>
166
167 <note>
168 You will find some of the mentioned options under <c>Pseudo
169 filesystems</c> which is a subpart of <c>File systems</c>.
170 </note>
171
172 <p>
173 If you are using PPPoE to connect to the Internet or you are using a
174 dial-up modem, you will need the following options in the kernel (you
175 will find the mentioned options under <c>Networking support</c> which is
176 a subpart of <c>Device Drivers</c>):
177 </p>
178
179 <pre caption="Selecting PPPoE necessary drivers">
180 Network device support ---&gt;
181 &lt;*&gt; PPP (point-to-point protocol) support
182 &lt;*&gt; PPP support for async serial ports
183 &lt;*&gt; PPP support for sync tty ports
184 </pre>
185
186 <p>
187 The two compression options won't harm but are not definitely needed, neither
188 does the <c>PPP over Ethernet</c> option, that might only be used by
189 <c>rp-pppoe</c> when configured to do kernel mode PPPoE.
190 </p>
191
192 <p>
193 If you require it, don't forget to include support in the kernel for your
194 ethernet card.
195 </p>
196
197 <p>
198 Disable ADB raw keycodes:
199 </p>
200
201 <pre caption="Disabling ADB raw keycodes">
202 Macintosh Device Drivers ---&gt;
203 [ ] Support for ADB raw keycodes
204 </pre>
205
206 <p>
207 Also choose the correct RTC support (<e>disable</e> the <c>Enhanced RTC</c>
208 option):
209 </p>
210
211 <pre caption="Activating the correct RTC option">
212 Character devices ---&gt;
213 [ ] Enhanced RTC
214
215 General setup ---&gt;
216 [*] Support for /dev/rtc
217 </pre>
218
219 <p>
220 When you're done configuring your kernel, continue with <uri
221 link="#compiling">Compiling and Installing</uri>.
222 </p>
223
224 </body>
225 </subsection>
226 <subsection id="compiling">
227 <title>Compiling and Installing</title>
228 <body>
229
230 <p>
231 Now that your kernel is configured, it is time to compile and install it. Exit
232 the configuration and run <c>make</c> and <c>make modules_install</c>:
233 </p>
234
235 <pre caption="Compiling the kernel">
236 (Apple/IBM) # <i>make &amp;&amp; make modules_install</i>
237 </pre>
238
239 <p>
240 When the kernel has finished compiling, copy the kernel image to
241 <path>/boot</path>.
242 </p>
243
244 <pre caption="Installing the kernel">
245 (Apple/IBM) # <i>cp vmlinux /boot/kernel-2.6.7-gentoo-r8</i>
246 </pre>
247
248 <p>
249 Also don't forget to copy over the system map:
250 </p>
251
252 <pre caption="Copying the system map">
253 # <i>cp System.map /boot/System.map-2.6.7</i>
254 </pre>
255
256 <p>
257 It is also wise to copy over your kernel configuration file to
258 <path>/boot</path>, just in case :)
259 </p>
260
261 <pre caption="Backing up your kernel configuration">
262 # <i>cp .config /boot/config-2.6.7-gentoo-r8</i>
263 </pre>
264
265 <p>
266 Now continue with <uri link="#kernel_modules">Configuring the Modules</uri>.
267 </p>
268
269 </body>
270 </subsection>
271 </section>
272 <section id="kernel_modules">
273 <title>Configuring the Modules</title>
274 <body>
275
276 <p>
277 You should list the modules you want automatically loaded in
278 <path>/etc/modules.autoload.d/kernel-2.6</path>. You can add extra
279 options to the modules too if you want.
280 </p>
281
282 <p>
283 To view all available modules, run the following <c>find</c> command. Don't
284 forget to substitute "&lt;kernel version&gt;" with the version of the kernel you
285 just compiled:
286 </p>
287
288 <pre caption="Viewing all available modules">
289 # <i>find /lib/modules/&lt;kernel version&gt;/ -type f -iname '*.o' -or -iname '*.ko'</i>
290 </pre>
291
292 <p>
293 For instance, to automatically load the <c>3c59x.o</c> module, edit the
294 <path>kernel-2.6</path> file and enter the module name in it.
295 </p>
296
297 <pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
298 # <i>nano -w /etc/modules.autoload.d/kernel-2.6</i>
299 </pre>
300
301 <pre caption="/etc/modules.autoload.d/kernel-2.6">
302 3c59x
303 </pre>
304
305 <p>
306 Now run <c>modules-update</c> to commit your changes to the
307 <path>/etc/modules.conf</path> file:
308 </p>
309
310 <pre caption="Running modules-update">
311 # <i>modules-update</i>
312 </pre>
313
314 <p>
315 Continue the installation with <uri link="?part=1&amp;chap=8">Configuring
316 your System</uri>.
317 </p>
318
319 </body>
320 </section>
321 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20