Installing kernel source on CentOS

1. Maybe you do not need the full kernel source

If you need to compile a kernel driver module, the chances are you do not really need the full kernel source tree. You might just need the kernel-devel package. (If, however, you are certain that the full source tree is required, please follow the instructions in Section 2.)

In CentOS-5, there are three kernel-devel packages available:

* kernel-devel (both 32- & 64-bit architectures)
* kernel-xen-devel (both 32- & 64-bit architectures)
* kernel-PAE-devel (32-bit architecture only)

In CentOS-4, there are four kernel-devel packages available:

* kernel-devel (both 32- & 64-bit architectures)
* kernel-smp-devel (both 32- & 64-bit architectures)
* kernel-xenU-devel (both 32- & 64-bit architectures)
* kernel-hugemem-devel (32-bit architecture only)
* kernel-largesmp-devel (64-bit architecture only)

If you are running the standard kernel (for example), you can install the kernel-devel package by:

[root@host]# yum install kernel-devel 

You can use this command to determine the version of your running kernel:

[root@host]# uname -r 

The result will look similar to this: 2.6.18-92.1.18.el5xen
In this case, the xen kernel is installed and the way to install this specific kernel-devel package is:

[root@host]# yum install kernel-xen-devel  

For more specific information about the available kernels please see the Release Notes:
* CentOS-5 i386 kernels
* CentOS-5 x86_64 kernels
* CentOS-4 (search for the heading kernel in the section Package-Specific Notes, sub-section Core, for more details.)

If your kernel is not listed by yum because it is in an older tree, you can download it manually from the CentOS Vault. Pick the version of CentOS you are interested in and then, for the arch, look in either the os/arch/CentOS/RPMS/ or the updates/arch/RPMS/ directories for the kernel[-type]-devel-version.arch.rpm

Once you have the proper kernel[-type]-devel-version.arch.rpm installed, try to compile your module. It should work this way. If it does not, please provide feedback to the module's developer as this is the way all new kernel modules should be designed to be built.

2. If you really need the full kernel source
If you really must have the kernel source tree, for whatever reason, it is obtainable.

2.1. CentOS 4 and 5
As root, install the packages rpm-build, redhat-rpm-config and unifdef:

[root@host]# yum install rpm-build redhat-rpm-config unifdef 

* The latter package is only required for 64-bit systems.
As an ordinary user, not root, create a directory tree based on ~/rpmbuild:

[user@host]$ cd
[user@host]$ mkdir -p rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}
[user@host]$ echo '%_topdir %(echo $HOME)/rpmbuild' > .rpmmacros 

* You are strongly advised against package building as root.

Find the kernel source rpm in:
(Replace the "5" with a "4" for CentOS-4 kernels)
* http://vault.centos.org/ (CentOS Vault)
(Pick either (version)/updates/SRPMS or (version)/os/SRPMS)

Once you have located the source file, you can install it by running, for example:

[user@host]$ rpm -ivh http://mirror.centos.org/centos/5/updates/SRPMS/kernel-2.6.18-92.1.18.el5.src.rpm 2> /dev/null  

note: Make sure you use -i instead of -U so that you don't upgrade already installed source tree

Now that the source rpm is installed, unpack and prepare the source files:

[user@host]$ cd ~/rpmbuild/SPECS
[user@host SPECS]$ rpmbuild -bp --target=`uname -m` kernel-2.6.spec 2> prep-err.log | tee prep-out.log 

The value of `uname -m` (note: back ticks (grave accents) not single quotation marks (apostrophies)) sets --target to the architecture of your current kernel. This is generally accepted and most people will have either i686 or x86_64.

The kernel source tree will now be found in the directory ~/rpmbuild/BUILD/.