Project:Kernel

Description
With an ever increasing userbase demanding a higher quality of stable, production-ready kernel sources and featureful desktop support the professionalism and staffing of the kernel project is very important. Because we as users want the best from Gentoo Linux we supply a selection of both generic and specialised sources capable of handling the day-to-day grind to make life a little easier.

In order to provide a rich choice of high quality kernel trees Gentoo Linux must apply, write and test several kernel patches to the official upstream releases before they can offer finished ebuilds to the users. This is where the Gentoo Kernel project comes into play.

All Gentoo Developers listed in the Kernel box can be reached by e-mail using nickname@gentoo.org (replace their nickname).

Subprojects
The kernel project has the following subprojects:


 * gentoo-sources, lead by Mike Pagano: Full sources including the Gentoo patchset for the 2.6 kernel tree. [2.6]
 * mips-sources, lead by Joshua Kinard: Gentoo Kernel based from the 2.4 branch supporting MIPS processors. [2.4/2.6]
 * sparc-sources, lead by Christian Birchinger: Gentoo Kernel supporting SPARC processors. [2.4]

Other Kernels
The Gentoo Kernel herd maintains the following list of kernels currently in portage. Additional kernels in portage that are not listed below are not maintained under the kernel herd.


 * ck-sources: Con Kolivas' kernel sources.
 * git-sources: Git sources, the absolute latest kernel available.
 * hardened-sources: Sources based upon genpatches-base along with the grsecurity patch which includes Pax.
 * mm-sources: Andrew Morton's patchset for 2.6 consisting of experimental features, cleanups, and other interesting patches.
 * tuxonice-sources: TuxOnIce (formerly Suspend2) sources and the Gentoo patchset.
 * usermode-sources: Full sources for the User Mode Linux kernel.
 * vanilla-sources: Full prepatched/rc sources for the Linux kernel.
 * xbox-sources: Full sources for the Xbox Linux kernel.
 * pf-sources: Linux kernel fork with new features, including the -ck patchset (BFS), BFQ, TuxOnIce and UKSM.

Herds
The kernel project maintains the following herds:


 * kernel which has the members Tony Vroon, Greg Kroah-Hartman, Benedikt Boehm, Mike Pagano, Stratos Psomadakis and Tom Wijsman and does core kernels stuff.
 * kernel-misc which has the members Tim Harder, Robin H. Johnson, Ned Ludd and Samuli Suominen and does kernel related packages.

Genpatches
Many kernels in Gentoo include part or all of the genpatches patchset. genpatches is focused on being a minimal patchset mostly focused on bugfixes, with minimal deviation from the upstream Linux kernel.

The genpatches homepage can be found at http://dev.gentoo.org/~mpagano/genpatches.

Maintainers Guide
In order to encourage new contributors, we have documented the procedures used when maintaining gentoo-sources-2.6. The document can be found here.

Documentation

 * Gentoo Linux Kernel Guide
 * Gentoo Linux Kernel Upgrade Guide
 * Gentoo Linux Kernel Configuration Guide
 * Gentoo Linux 2.4 to 2.6 Kernel Migration Guide

Kernel Stabilization
The following policy is in place for kernel stabilization that can be performed by members of the kernel team without opening a stabilization bug. For this to occur, the following procedures must be followed:

For new kernel major point releases (e.g. 2.6.X)


 * A stable request bug is opened and arch teams stabilize as per existing policy. No auto stabilizing occurs here as only the arch teams can really determine if the kernel is working on their own arch.

For subsequent security related releases of a kernel point release 2.6.X.Y


 * If the kernel team determines a significant security fix is included for a kernel release of 2.6.X.y where 2.6.X or 2.6.X.(Y-1) has already been stabilized per the first bullet, the kernel team can auto stabilize that specific version.
 * Dependant upon the severity of the security bug, (root exploit, minor module) the kernel team will remove stable keywords from earlier versions of the same 2.6.X series within a reasonable timeframe.

gentoo-kernel@gentoo.org
The Gentoo Kernel Mailing List is a public mailing list for the discussion of project related topics and release announcements for genpatches, vesafb-tng and fbsplash.

Gentoo maintains a a full listing of all public Gentoo Mailing Lists as well as information on how to subscribe and unsubscribe.

Useful Links
Additional Information and External Links:


 * Using git-bisect to find buggy kernel patches.
 * Using ketchup to quickly install kernel sources.