Gentoo Archives: gentoo-doc-cvs

From: Sven Vermeulen <swift@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-install-ppc-kernel.xml
Date: Thu, 21 Aug 2008 14:47:26
Message-Id: E1KWBRb-0006vC-6l@stork.gentoo.org
1 swift 08/08/21 14:47:23
2
3 Modified: hb-install-ppc-kernel.xml
4 Log:
5 Some coding style changes (trailing whitespace, no tabs)
6
7 Revision Changes Path
8 1.60 xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?rev=1.60&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?rev=1.60&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml?r1=1.59&r2=1.60
13
14 Index: hb-install-ppc-kernel.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v
17 retrieving revision 1.59
18 retrieving revision 1.60
19 diff -u -r1.59 -r1.60
20 --- hb-install-ppc-kernel.xml 21 Aug 2008 14:44:44 -0000 1.59
21 +++ hb-install-ppc-kernel.xml 21 Aug 2008 14:47:23 -0000 1.60
22 @@ -4,7 +4,7 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.59 2008/08/21 14:44:44 swift Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.60 2008/08/21 14:47:23 swift Exp $ -->
28
29 <sections>
30
31 @@ -41,9 +41,9 @@
32 <p>
33 The core around which all distributions are built is the Linux kernel. It is the
34 layer between the user programs and your system hardware. Gentoo provides its
35 -users several possible kernels to choose from. A full listing with description
36 -is available at the
37 -<uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel Guide</uri>.
38 +users several possible kernels to choose from. A full listing with description
39 +is available at the
40 +<uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel Guide</uri>.
41 </p>
42
43 <p>
44 @@ -67,16 +67,16 @@
45 </pre>
46
47 <p>
48 -Now it is time to configure and compile your kernel source. You can use
49 -<c>genkernel</c> for this, which will build a generic kernel as used by the
50 +Now it is time to configure and compile your kernel source. You can use
51 +<c>genkernel</c> for this, which will build a generic kernel as used by the
52 Installation CD. We explain the "manual" configuration first though, as it is
53 a more efficient configuration.
54 </p>
55
56 <p>
57 If you want to manually configure your kernel, continue now with <uri
58 -link="#manual">Default: Manual Configuration</uri>. If you want to use
59 -<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
60 +link="#manual">Default: Manual Configuration</uri>. If you want to use
61 +<c>genkernel</c> you should read <uri link="#genkernel">Alternative: Using
62 genkernel</uri> instead.
63 </p>
64
65 @@ -97,13 +97,13 @@
66
67 <p>
68 However, one thing <e>is</e> true: you must know your system when you start
69 -configuring a kernel manually. Most information can be gathered by emerging
70 -pciutils (<c>emerge pciutils</c>) which contains the program
71 +configuring a kernel manually. Most information can be gathered by emerging
72 +pciutils (<c>emerge pciutils</c>) which contains the program
73 <c>lspci</c>. You will now be able to use <c>lspci</c> within the chrooted
74 environment. You may safely ignore any <e>pcilib</e> warnings (such as pcilib:
75 cannot open /sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively,
76 you can run <c>lspci</c> from a <e>non-chrooted</e> environment. The results
77 -are the same. You can also run <c>lsmod</c> to see what kernel modules the
78 +are the same. You can also run <c>lsmod</c> to see what kernel modules the
79 Installation CD uses (it might provide you with a nice hint on what to enable).
80 Another place to look for clues as to what components to enable is to check the
81 kernel message logs from the successful boot that got you this far. Type
82 @@ -215,14 +215,14 @@
83 <p>
84 At this time, full kernel preemption may still be unstable on PPC and may cause
85 compilation failures and random segfaults. It is <e>strongly</e> suggested
86 -that you do not use this feature. Both <e>Voluntary Preemption</e> and
87 +that you do not use this feature. Both <e>Voluntary Preemption</e> and
88 <e>No Forced Preemption</e> should be safe.
89 </p>
90
91 <pre caption="Ensure the Preemptible Kernel Option is Off">
92 Kernel options ---&gt;
93 <comment>(Select One)</comment>
94 - Preemption Model
95 + Preemption Model
96 (X) No Forced Preemption (Server)
97 (X) Voluntary Kernel Preemption (Desktop)
98 </pre>
99 @@ -293,7 +293,7 @@
100 <body>
101
102 <p>
103 -Now that your kernel is configured, it is time to compile and install it. Exit
104 +Now that your kernel is configured, it is time to compile and install it. Exit
105 the configuration menu and run the following commands:
106 </p>
107
108 @@ -304,7 +304,7 @@
109 <p>
110 When the kernel has finished compiling, copy the kernel image to
111 <path>/boot</path> as shown below. If you have a separate boot partition, as
112 -on Pegasos computers, be sure that it is mounted properly. If you are using
113 +on Pegasos computers, be sure that it is mounted properly. If you are using
114 BootX to boot, we'll copy the kernel later.
115 </p>
116
117 @@ -323,7 +323,7 @@
118 <comment>(Apple/IBM)</comment>
119 # <i>cp vmlinux /boot/<keyval id="kernel-name"/></i>
120 <comment>(Pegasos)</comment>
121 -# <i>cp arch/powerpc/boot/images/zImage /boot/<keyval id="kernel-name" /></i>
122 +# <i>cp arch/powerpc/boot/images/zImage /boot/<keyval id="kernel-name" /></i>
123 </pre>
124
125 <p>
126 @@ -358,7 +358,7 @@
127 </pre>
128
129 <p>
130 -Next, copy over the kernel configuration used by the Installation CD to the
131 +Next, copy over the kernel configuration used by the Installation CD to the
132 location where genkernel looks for the default kernel configuration:
133 </p>
134
135 @@ -367,7 +367,7 @@
136 </pre>
137
138 <p>
139 -If you are using firewire or USB to boot, you'll need to add modules to the
140 +If you are using firewire or USB to boot, you'll need to add modules to the
141 initrd. Edit <path>/usr/share/genkernel/ppc/modules_load</path> and change
142 <c>MODULES_FIREWIRE="ieee1394 ohci1394 sbp2"</c> for firewire support or
143 <c>MODULES_USB="usbcore ohci-hcd ehci-hcd usb-storage"</c> for USB support.
144 @@ -384,21 +384,21 @@
145 <pre caption="Removing /boot from /etc/fstab on machines without a boot partition">
146 # <i>nano -w /etc/fstab</i>
147 <comment>Remove this line</comment>
148 -/dev/BOOT /boot ext2 noauto,noatime 1 2
149 +/dev/BOOT /boot ext2 noauto,noatime 1 2
150 </pre>
151
152 <p>
153 Now, compile your kernel sources by running <c>genkernel --genzimage all</c>.
154 For Pegasos, we will need to use a different config and create a zImage instead
155 -of the vmlinux kernel used on Apple machines. Be aware, as <c>genkernel</c>
156 -compiles a kernel that supports almost all hardware, this compilation can take
157 +of the vmlinux kernel used on Apple machines. Be aware, as <c>genkernel</c>
158 +compiles a kernel that supports almost all hardware, this compilation can take
159 quite a while to finish!
160 </p>
161
162 <p>
163 Note that, if your partition where the kernel should be located doesn't use ext2
164 or ext3 as filesystem you might need to manually configure your kernel using
165 -<c>genkernel --menuconfig all</c> and add support for your
166 +<c>genkernel --menuconfig all</c> and add support for your
167 filesystem <e>in</e> the kernel (i.e. <e>not</e> as a module). Users of EVMS2 or
168 LVM2 will probably want to add <c>--evms2</c> or <c>--lvm2</c> as an argument as
169 well.
170 @@ -413,12 +413,12 @@
171 </pre>
172
173 <p>
174 -Once <c>genkernel</c> completes, a kernel, full set of modules and
175 -<e>initial root disk</e> (initrd) will be created. We will use the kernel
176 +Once <c>genkernel</c> completes, a kernel, full set of modules and
177 +<e>initial root disk</e> (initrd) will be created. We will use the kernel
178 and initrd when configuring a boot loader later in this document. Write
179 down the names of the kernel and initrd as you will need them when writing
180 -the bootloader configuration file. The initrd will be started immediately after
181 -booting to perform hardware autodetection (just like on the Installation CD)
182 +the bootloader configuration file. The initrd will be started immediately after
183 +booting to perform hardware autodetection (just like on the Installation CD)
184 before your "real" system starts up. Be sure to also copy down the required
185 boot arguments, these are required for a successful boot with genkernel.
186 </p>