diff options
author | Michael Witten <mfwitten@gmail.com> | 2012-04-01 21:07:52 -0400 |
---|---|---|
committer | Jiri Kosina <jkosina@suse.cz> | 2012-04-17 04:23:33 -0400 |
commit | 3773b4540721a2e8d4b957f4619ada4bf0bc8e45 (patch) | |
tree | a87e2b2e5dd4d0ebb2970e5e0271f17c5d7124b4 /README | |
parent | 7f65e924c0cfe0896e31ce3e162b4d10df87ccfe (diff) |
README: Remove sporadic tabs
Indentation was already done mainly with spaces, so this commit
removes the tabs and makes some of the whitespace more consistent.
Signed-off-by: Michael Witten <mfwitten@gmail.com>
Acked-by: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Jiri Kosina <jkosina@suse.cz>
Diffstat (limited to 'README')
-rw-r--r-- | README | 140 |
1 files changed, 70 insertions, 70 deletions
@@ -1,4 +1,4 @@ | |||
1 | Linux kernel release 3.x <http://kernel.org/> | 1 | Linux kernel release 3.x <http://kernel.org/> |
2 | 2 | ||
3 | These are the release notes for Linux version 3. Read them carefully, | 3 | These are the release notes for Linux version 3. Read them carefully, |
4 | as they tell you what this is all about, explain how to install the | 4 | as they tell you what this is all about, explain how to install the |
@@ -62,11 +62,11 @@ INSTALLING the kernel source: | |||
62 | directory where you have permissions (eg. your home directory) and | 62 | directory where you have permissions (eg. your home directory) and |
63 | unpack it: | 63 | unpack it: |
64 | 64 | ||
65 | gzip -cd linux-3.X.tar.gz | tar xvf - | 65 | gzip -cd linux-3.X.tar.gz | tar xvf - |
66 | 66 | ||
67 | or | 67 | or |
68 | 68 | ||
69 | bzip2 -dc linux-3.X.tar.bz2 | tar xvf - | 69 | bzip2 -dc linux-3.X.tar.bz2 | tar xvf - |
70 | 70 | ||
71 | Replace "X" with the version number of the latest kernel. | 71 | Replace "X" with the version number of the latest kernel. |
72 | 72 | ||
@@ -80,11 +80,11 @@ INSTALLING the kernel source: | |||
80 | install by patching, get all the newer patch files, enter the | 80 | install by patching, get all the newer patch files, enter the |
81 | top level directory of the kernel source (linux-3.X) and execute: | 81 | top level directory of the kernel source (linux-3.X) and execute: |
82 | 82 | ||
83 | gzip -cd ../patch-3.x.gz | patch -p1 | 83 | gzip -cd ../patch-3.x.gz | patch -p1 |
84 | 84 | ||
85 | or | 85 | or |
86 | 86 | ||
87 | bzip2 -dc ../patch-3.x.bz2 | patch -p1 | 87 | bzip2 -dc ../patch-3.x.bz2 | patch -p1 |
88 | 88 | ||
89 | Replace "x" for all versions bigger than the version "X" of your current | 89 | Replace "x" for all versions bigger than the version "X" of your current |
90 | source tree, _in_order_, and you should be ok. You may want to remove | 90 | source tree, _in_order_, and you should be ok. You may want to remove |
@@ -105,7 +105,7 @@ INSTALLING the kernel source: | |||
105 | process. It determines the current kernel version and applies any | 105 | process. It determines the current kernel version and applies any |
106 | patches found. | 106 | patches found. |
107 | 107 | ||
108 | linux/scripts/patch-kernel linux | 108 | linux/scripts/patch-kernel linux |
109 | 109 | ||
110 | The first argument in the command above is the location of the | 110 | The first argument in the command above is the location of the |
111 | kernel source. Patches are applied from the current directory, but | 111 | kernel source. Patches are applied from the current directory, but |
@@ -113,8 +113,8 @@ INSTALLING the kernel source: | |||
113 | 113 | ||
114 | - Make sure you have no stale .o files and dependencies lying around: | 114 | - Make sure you have no stale .o files and dependencies lying around: |
115 | 115 | ||
116 | cd linux | 116 | cd linux |
117 | make mrproper | 117 | make mrproper |
118 | 118 | ||
119 | You should now have the sources correctly installed. | 119 | You should now have the sources correctly installed. |
120 | 120 | ||
@@ -137,8 +137,8 @@ BUILD directory for the kernel: | |||
137 | place for the output files (including .config). | 137 | place for the output files (including .config). |
138 | Example: | 138 | Example: |
139 | 139 | ||
140 | kernel source code: /usr/src/linux-3.X | 140 | kernel source code: /usr/src/linux-3.X |
141 | build directory: /home/name/build/kernel | 141 | build directory: /home/name/build/kernel |
142 | 142 | ||
143 | To configure and build the kernel, use: | 143 | To configure and build the kernel, use: |
144 | 144 | ||
@@ -161,76 +161,76 @@ CONFIGURING the kernel: | |||
161 | 161 | ||
162 | - Alternative configuration commands are: | 162 | - Alternative configuration commands are: |
163 | 163 | ||
164 | "make config" Plain text interface. | 164 | "make config" Plain text interface. |
165 | 165 | ||
166 | "make menuconfig" Text based color menus, radiolists & dialogs. | 166 | "make menuconfig" Text based color menus, radiolists & dialogs. |
167 | 167 | ||
168 | "make nconfig" Enhanced text based color menus. | 168 | "make nconfig" Enhanced text based color menus. |
169 | 169 | ||
170 | "make xconfig" X windows (Qt) based configuration tool. | 170 | "make xconfig" X windows (Qt) based configuration tool. |
171 | 171 | ||
172 | "make gconfig" X windows (Gtk) based configuration tool. | 172 | "make gconfig" X windows (Gtk) based configuration tool. |
173 | 173 | ||
174 | "make oldconfig" Default all questions based on the contents of | 174 | "make oldconfig" Default all questions based on the contents of |
175 | your existing ./.config file and asking about | 175 | your existing ./.config file and asking about |
176 | new config symbols. | 176 | new config symbols. |
177 | 177 | ||
178 | "make silentoldconfig" | 178 | "make silentoldconfig" |
179 | Like above, but avoids cluttering the screen | 179 | Like above, but avoids cluttering the screen |
180 | with questions already answered. | 180 | with questions already answered. |
181 | Additionally updates the dependencies. | 181 | Additionally updates the dependencies. |
182 | 182 | ||
183 | "make defconfig" Create a ./.config file by using the default | 183 | "make defconfig" Create a ./.config file by using the default |
184 | symbol values from either arch/$ARCH/defconfig | 184 | symbol values from either arch/$ARCH/defconfig |
185 | or arch/$ARCH/configs/${PLATFORM}_defconfig, | 185 | or arch/$ARCH/configs/${PLATFORM}_defconfig, |
186 | depending on the architecture. | 186 | depending on the architecture. |
187 | 187 | ||
188 | "make ${PLATFORM}_defconfig" | 188 | "make ${PLATFORM}_defconfig" |
189 | Create a ./.config file by using the default | 189 | Create a ./.config file by using the default |
190 | symbol values from | 190 | symbol values from |
191 | arch/$ARCH/configs/${PLATFORM}_defconfig. | 191 | arch/$ARCH/configs/${PLATFORM}_defconfig. |
192 | Use "make help" to get a list of all available | 192 | Use "make help" to get a list of all available |
193 | platforms of your architecture. | 193 | platforms of your architecture. |
194 | 194 | ||
195 | "make allyesconfig" | 195 | "make allyesconfig" |
196 | Create a ./.config file by setting symbol | 196 | Create a ./.config file by setting symbol |
197 | values to 'y' as much as possible. | 197 | values to 'y' as much as possible. |
198 | 198 | ||
199 | "make allmodconfig" | 199 | "make allmodconfig" |
200 | Create a ./.config file by setting symbol | 200 | Create a ./.config file by setting symbol |
201 | values to 'm' as much as possible. | 201 | values to 'm' as much as possible. |
202 | 202 | ||
203 | "make allnoconfig" Create a ./.config file by setting symbol | 203 | "make allnoconfig" Create a ./.config file by setting symbol |
204 | values to 'n' as much as possible. | 204 | values to 'n' as much as possible. |
205 | 205 | ||
206 | "make randconfig" Create a ./.config file by setting symbol | 206 | "make randconfig" Create a ./.config file by setting symbol |
207 | values to random values. | 207 | values to random values. |
208 | 208 | ||
209 | You can find more information on using the Linux kernel config tools | 209 | You can find more information on using the Linux kernel config tools |
210 | in Documentation/kbuild/kconfig.txt. | 210 | in Documentation/kbuild/kconfig.txt. |
211 | 211 | ||
212 | NOTES on "make config": | 212 | - NOTES on "make config": |
213 | 213 | ||
214 | - Having unnecessary drivers will make the kernel bigger, and can | 214 | - Having unnecessary drivers will make the kernel bigger, and can |
215 | under some circumstances lead to problems: probing for a | 215 | under some circumstances lead to problems: probing for a |
216 | nonexistent controller card may confuse your other controllers | 216 | nonexistent controller card may confuse your other controllers |
217 | 217 | ||
218 | - Compiling the kernel with "Processor type" set higher than 386 | 218 | - Compiling the kernel with "Processor type" set higher than 386 |
219 | will result in a kernel that does NOT work on a 386. The | 219 | will result in a kernel that does NOT work on a 386. The |
220 | kernel will detect this on bootup, and give up. | 220 | kernel will detect this on bootup, and give up. |
221 | 221 | ||
222 | - A kernel with math-emulation compiled in will still use the | 222 | - A kernel with math-emulation compiled in will still use the |
223 | coprocessor if one is present: the math emulation will just | 223 | coprocessor if one is present: the math emulation will just |
224 | never get used in that case. The kernel will be slightly larger, | 224 | never get used in that case. The kernel will be slightly larger, |
225 | but will work on different machines regardless of whether they | 225 | but will work on different machines regardless of whether they |
226 | have a math coprocessor or not. | 226 | have a math coprocessor or not. |
227 | 227 | ||
228 | - The "kernel hacking" configuration details usually result in a | 228 | - The "kernel hacking" configuration details usually result in a |
229 | bigger or slower kernel (or both), and can even make the kernel | 229 | bigger or slower kernel (or both), and can even make the kernel |
230 | less stable by configuring some routines to actively try to | 230 | less stable by configuring some routines to actively try to |
231 | break bad code to find kernel problems (kmalloc()). Thus you | 231 | break bad code to find kernel problems (kmalloc()). Thus you |
232 | should probably answer 'n' to the questions for | 232 | should probably answer 'n' to the questions for "development", |
233 | "development", "experimental", or "debugging" features. | 233 | "experimental", or "debugging" features. |
234 | 234 | ||
235 | COMPILING the kernel: | 235 | COMPILING the kernel: |
236 | 236 | ||
@@ -257,7 +257,7 @@ COMPILING the kernel: | |||
257 | For this, use "verbose" build mode. This is done by inserting | 257 | For this, use "verbose" build mode. This is done by inserting |
258 | "V=1" in the "make" command. E.g.: | 258 | "V=1" in the "make" command. E.g.: |
259 | 259 | ||
260 | make V=1 all | 260 | make V=1 all |
261 | 261 | ||
262 | To have the build system also tell the reason for the rebuild of each | 262 | To have the build system also tell the reason for the rebuild of each |
263 | target, use "V=2". The default is "V=0". | 263 | target, use "V=2". The default is "V=0". |
@@ -320,14 +320,14 @@ IF SOMETHING GOES WRONG: | |||
320 | 320 | ||
321 | - If the bug results in a message like | 321 | - If the bug results in a message like |
322 | 322 | ||
323 | unable to handle kernel paging request at address C0000010 | 323 | unable to handle kernel paging request at address C0000010 |
324 | Oops: 0002 | 324 | Oops: 0002 |
325 | EIP: 0010:XXXXXXXX | 325 | EIP: 0010:XXXXXXXX |
326 | eax: xxxxxxxx ebx: xxxxxxxx ecx: xxxxxxxx edx: xxxxxxxx | 326 | eax: xxxxxxxx ebx: xxxxxxxx ecx: xxxxxxxx edx: xxxxxxxx |
327 | esi: xxxxxxxx edi: xxxxxxxx ebp: xxxxxxxx | 327 | esi: xxxxxxxx edi: xxxxxxxx ebp: xxxxxxxx |
328 | ds: xxxx es: xxxx fs: xxxx gs: xxxx | 328 | ds: xxxx es: xxxx fs: xxxx gs: xxxx |
329 | Pid: xx, process nr: xx | 329 | Pid: xx, process nr: xx |
330 | xx xx xx xx xx xx xx xx xx xx | 330 | xx xx xx xx xx xx xx xx xx xx |
331 | 331 | ||
332 | or similar kernel debugging information on your screen or in your | 332 | or similar kernel debugging information on your screen or in your |
333 | system log, please duplicate it *exactly*. The dump may look | 333 | system log, please duplicate it *exactly*. The dump may look |
@@ -356,7 +356,7 @@ IF SOMETHING GOES WRONG: | |||
356 | the file 'linux/vmlinux'. To extract the namelist and match it against | 356 | the file 'linux/vmlinux'. To extract the namelist and match it against |
357 | the EIP from the kernel crash, do: | 357 | the EIP from the kernel crash, do: |
358 | 358 | ||
359 | nm vmlinux | sort | less | 359 | nm vmlinux | sort | less |
360 | 360 | ||
361 | This will give you a list of kernel addresses sorted in ascending | 361 | This will give you a list of kernel addresses sorted in ascending |
362 | order, from which it is simple to find the function that contains the | 362 | order, from which it is simple to find the function that contains the |