diff options
author | Greg Kroah-Hartman <gregkh@suse.de> | 2005-11-15 12:53:58 -0800 |
---|---|---|
committer | Greg Kroah-Hartman <gregkh@suse.de> | 2005-11-15 12:53:58 -0800 |
commit | b1fa5df46e2bd7106c31f891d0eaa8ab7e3b1d8c (patch) | |
tree | e33d1d4ac992d0263467afac5513b3946a0c4ed6 /HOWTO | |
parent | b6d4c837a60c00e7f011857c88f893ee7ab25d00 (diff) | |
download | patches-b1fa5df46e2bd7106c31f891d0eaa8ab7e3b1d8c.tar.gz |
added locations of different development trees.
Diffstat (limited to 'HOWTO')
-rw-r--r-- | HOWTO | 58 |
1 files changed, 41 insertions, 17 deletions
@@ -10,8 +10,8 @@ to the maintainer of this file, who is listed at the bottom of the document. -Intro ------ +Introduction +------------ So, you want to learn how to become a Linux kernel developer? Or you have been told by your manager, "Go write a Linux driver for this @@ -52,7 +52,6 @@ are well documented; do not expect people to adapt to you or your company's way of doing things. - Legal Issues ------------ @@ -135,7 +134,6 @@ required reading: create it, and how to apply it to the different development branches of the kernel. - The kernel also has a large number of documents that can be automatically generated from the source code itself. This includes a full description of the in-kernel API, and rules on how to handle @@ -197,10 +195,8 @@ branches. These different branches are: - 2.6.x -mm kernel patches - subsystem specific kernel trees and patches - 2.6.x kernel tree ----------------- - 2.6.x kernels are maintained by Linus Torvalds, and can be found on kernel.org in the pub/linux/kernel/v2.6/ directory. It's development process is as follows: @@ -231,10 +227,8 @@ mailing list about kernel releases: released according to perceived bug status, not according to a preconceived timeline." - 2.6.x.y -stable kernel tree --------------------------- - Kernels with 4 digit versions are -stable kernels. They contain relativly small and critical fixes for security problems or significant regressions discovered in a given 2.6.x kernel. @@ -253,10 +247,8 @@ The file Documentation/stable_kernel_rules.txt in the kernel tree documents what kinds of changes are acceptable for the -stable tree, and how the release process works. - 2.6.x -git patches ------------------ - These are daily snapshots of Linus' kernel tree which is managed in a git repository (hence the name.) These patches are usually released daily and represent the current state of Linus' tree. They are more @@ -265,7 +257,6 @@ without even a cursory glance to see if they are sane. 2.6.x -mm kernel patches ------------------------ - These are experimental kernel patches released by Andrew Morton. Andrew takes all of the different subsystem kernel trees and patches and mushes them together, along with a lot of patches that have been plucked from @@ -294,14 +285,49 @@ The -mm kernels are not released on a fixed schedule, but usually a few Subsystem Specific kernel trees and patches ------------------------------------------- - A number of the different kernel subsystem developers expose their development trees so that others can see what is happening in the different areas of the kernel. These trees are pulled into the -mm kernel releases as described above. Here is a list of some of the different kernel trees available: - - + git trees: + - Kbuild development tree, Sam Ravnborg <sam@ravnborg.org> + kernel.org:/pub/scm/linux/kernel/git/sam/kbuild.git + + - ACPI development tree, Len Brown <len.brown@intel.com> + kernel.org:/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6.git + + - Block development tree, Jens Axboe <axboe@suse.de> + kernel.org:/pub/scm/linux/kernel/git/axboe/linux-2.6-block.git + + - DRM development tree, Dave Airlie <airlied@linux.ie> + kernel.org:/pub/scm/linux/kernel/git/airlied/drm-2.6.git + + - ia64 development tree, Tony Luck <tony.luck@intel.com> + kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git + + - ieee1394 development tree, Jody McIntyre <scjody@modernduck.com> + kernel.org:/pub/scm/linux/kernel/git/scjody/ieee1394.git + + - infiniband, Roland Dreier <rolandd@cisco.com> + kernel.org:/pub/scm/linux/kernel/git/roland/infiniband.git + + - libata, Jeff Garzik <jgarzik@pobox.com> + kernel.org:/pub/scm/linux/kernel/git/jgarzik/libata-dev.git + + - network drivers, Jeff Garzik <jgarzik@pobox.com> + kernel.org:/pub/scm/linux/kernel/git/jgarzik/netdev-2.6.git + + - pcmcia, Dominik Brodowski <linux@dominikbrodowski.net> + kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git + + - SCSI, James Bottomley <James.Bottomley@SteelEye.com> + kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git + + quilt trees: + - USB, PCI, Driver Core, and I2C, Greg Kroah-Hartman <gregkh@suse.de> + kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/ Bug Reporting @@ -317,7 +343,6 @@ of information is needed by the kernel developers to help track down the problem. - Mailing lists ------------- @@ -370,7 +395,6 @@ mail program fixed or change it until it works. Above all, please remember to show respect to other subscribers. - Working with the community -------------------------- @@ -501,7 +525,7 @@ solution and working together with the community and discuss your unfinished work. Therefore it is good to get early in the process to get feedback to improve your work, but also keep your changes in small chunks that they may get already accepted, even when your whole task is -not ready for inclusion now. +not ready for inclusion now. Also realize that it is not acceptable to send patches for inclusion that are unfinished and will be "fixed up later." @@ -534,6 +558,7 @@ ChangeLog section of the document: + All of these things are sometimes very hard to do. It can take years to perfect these practices (if at all). It's a continuous process of improvement that requires a lot of patience and determination. But @@ -555,4 +580,3 @@ this document. Maintainer: Greg Kroah-Hartman <greg@kroah.com> - |