pristine/SOURCES/README.kernel-tmb-sources

Hello Mandriva Users,

kernel-headers contains the headers for the source code of Linux kernel.
All source code necessary to compile a new kernel is included in two
packages kernel-headers, and kernel-source. You will need to install
both kernel-headers (needed for general Linux compilation), and
kernel-source in order to compile a new kernel.

The kernel is the central process of your Linux machine, the mediator
between the hardware and your programs. It is responsible for memory
allocations, process managing, device access...

Although modern kernels are very flexible thanks to dynamic modules, you
may need to compile your own kernel for various reasons: your found a
new module which need a more recent kernel, you need a feature of a new
kernel, etc...
Anyway, all the new kernels may be found in the cooker distrib (look for
mirrors at http://qa.mandriva.com/twiki/bin/view/Main/CookerMirrors).

Here is a short sum-up of what you can find in the Kernel-HOWTO. Consult
it in case of a problem or if the shortcut here provided does not meet
your needs. You should also consult the README of kernel-sources.


1. Configure your new kernel

You should never build a kernel as root, so as a normal user:
Copy the source in /usr/src/linux/ to ~/kernel/
Change to ~/kernel/ and clean-up previous compilations, by issuing 
"make mrproper",
In console mode, run "make menuconfig",
Under X11, run "make xconfig".

Then configure all sections of your kernel making each feature you need
available constantly or as a module. Note that you should compile most
features as a module, as it consume less memory, taking into account
that some of them cannot be modules as you may need them at boot time,
before dynamic modules be loaded...


2. Compile it

Just issue "make" to create a compressed kernel image and the modules you 
configured.


3. install your new kernel

Now you need root privilegies, so:
Issue "su" and enter root password.
Issue "make modules_install"

This will copy your modules and needed files to /lib/modules/

Issue "make install"

This will copy your new kernel and system.map to boot dir (/boot/) with
correct names including version, and change respective links.

It finally runs lilo to take into account your new kernel.


4. Modify Lilo to allow your booting on old kernel

* This step is optional, although recommended *
See lilo.conf man page.
Your are encouraged during this step to create a new section in your
lilo.conf file, in order to enable you to boot on your both kernels, the
old and the new one.
You need to run lilo then to take your changes into account.
You may also use linuxconf to do all that with a nice GUI.


5. Reboot your machine...

And pray.
Anyway if something goes wrong, you just need to reboot and choose your
old kernel with lilo.

Enjoy!


========================================================================
(c) 1999-2006 Mandriva, Camille B�gnis <camille@mandriva.com>
(c) 2006 Thomas Backlund <tmb@mandriva.org> 
1	tmb	61100	Hello Mandriva Users,
2
3			kernel-headers contains the headers for the source code of Linux kernel.
4			All source code necessary to compile a new kernel is included in two
5			packages kernel-headers, and kernel-source. You will need to install
6			both kernel-headers (needed for general Linux compilation), and
7			kernel-source in order to compile a new kernel.
8
9			The kernel is the central process of your Linux machine, the mediator
10			between the hardware and your programs. It is responsible for memory
11			allocations, process managing, device access...
12
13			Although modern kernels are very flexible thanks to dynamic modules, you
14			may need to compile your own kernel for various reasons: your found a
15			new module which need a more recent kernel, you need a feature of a new
16			kernel, etc...
17			Anyway, all the new kernels may be found in the cooker distrib (look for
18			mirrors at http://qa.mandriva.com/twiki/bin/view/Main/CookerMirrors).
19
20			Here is a short sum-up of what you can find in the Kernel-HOWTO. Consult
21			it in case of a problem or if the shortcut here provided does not meet
22			your needs. You should also consult the README of kernel-sources.
23
24
25
26			1. Configure your new kernel
27
28			You should never build a kernel as root, so as a normal user:
29			Copy the source in /usr/src/linux/ to ~/kernel/
30			Change to ~/kernel/ and clean-up previous compilations, by issuing
31			"make mrproper",
32			In console mode, run "make menuconfig",
33			Under X11, run "make xconfig".
34
35			Then configure all sections of your kernel making each feature you need
36			available constantly or as a module. Note that you should compile most
37			features as a module, as it consume less memory, taking into account
38			that some of them cannot be modules as you may need them at boot time,
39			before dynamic modules be loaded...
40
41
42
43			2. Compile it
44
45			Just issue "make" to create a compressed kernel image and the modules you
46			configured.
47
48
49
50			3. install your new kernel
51
52			Now you need root privilegies, so:
53			Issue "su" and enter root password.
54			Issue "make modules_install"
55
56			This will copy your modules and needed files to /lib/modules/
57
58			Issue "make install"
59
60			This will copy your new kernel and system.map to boot dir (/boot/) with
61			correct names including version, and change respective links.
62
63			It finally runs lilo to take into account your new kernel.
64
65
66
67			4. Modify Lilo to allow your booting on old kernel
68
69			* This step is optional, although recommended *
70			See lilo.conf man page.
71			Your are encouraged during this step to create a new section in your
72			lilo.conf file, in order to enable you to boot on your both kernels, the
73			old and the new one.
74			You need to run lilo then to take your changes into account.
75			You may also use linuxconf to do all that with a nice GUI.
76
77
78
79			5. Reboot your machine...
80
81			And pray.
82			Anyway if something goes wrong, you just need to reboot and choose your
83			old kernel with lilo.
84
85			Enjoy!
86
87
88			========================================================================
89			(c) 1999-2006 Mandriva, Camille B�gnis <camille@mandriva.com>
90			(c) 2006 Thomas Backlund <tmb@mandriva.org>