diff options
Diffstat (limited to 'Documentation/HOWTO')
| -rw-r--r-- | Documentation/HOWTO | 115 |
1 files changed, 37 insertions, 78 deletions
diff --git a/Documentation/HOWTO b/Documentation/HOWTO index 8495fc970391..40ada93b820a 100644 --- a/Documentation/HOWTO +++ b/Documentation/HOWTO | |||
| @@ -221,8 +221,8 @@ branches. These different branches are: | |||
| 221 | - main 2.6.x kernel tree | 221 | - main 2.6.x kernel tree |
| 222 | - 2.6.x.y -stable kernel tree | 222 | - 2.6.x.y -stable kernel tree |
| 223 | - 2.6.x -git kernel patches | 223 | - 2.6.x -git kernel patches |
| 224 | - 2.6.x -mm kernel patches | ||
| 225 | - subsystem specific kernel trees and patches | 224 | - subsystem specific kernel trees and patches |
| 225 | - the 2.6.x -next kernel tree for integration tests | ||
| 226 | 226 | ||
| 227 | 2.6.x kernel tree | 227 | 2.6.x kernel tree |
| 228 | ----------------- | 228 | ----------------- |
| @@ -232,9 +232,9 @@ process is as follows: | |||
| 232 | - As soon as a new kernel is released a two weeks window is open, | 232 | - As soon as a new kernel is released a two weeks window is open, |
| 233 | during this period of time maintainers can submit big diffs to | 233 | during this period of time maintainers can submit big diffs to |
| 234 | Linus, usually the patches that have already been included in the | 234 | Linus, usually the patches that have already been included in the |
| 235 | -mm kernel for a few weeks. The preferred way to submit big changes | 235 | -next kernel for a few weeks. The preferred way to submit big changes |
| 236 | is using git (the kernel's source management tool, more information | 236 | is using git (the kernel's source management tool, more information |
| 237 | can be found at http://git.or.cz/) but plain patches are also just | 237 | can be found at http://git-scm.com/) but plain patches are also just |
| 238 | fine. | 238 | fine. |
| 239 | - After two weeks a -rc1 kernel is released it is now possible to push | 239 | - After two weeks a -rc1 kernel is released it is now possible to push |
| 240 | only patches that do not include new features that could affect the | 240 | only patches that do not include new features that could affect the |
| @@ -293,84 +293,43 @@ daily and represent the current state of Linus' tree. They are more | |||
| 293 | experimental than -rc kernels since they are generated automatically | 293 | experimental than -rc kernels since they are generated automatically |
| 294 | without even a cursory glance to see if they are sane. | 294 | without even a cursory glance to see if they are sane. |
| 295 | 295 | ||
| 296 | 2.6.x -mm kernel patches | ||
| 297 | ------------------------ | ||
| 298 | These are experimental kernel patches released by Andrew Morton. Andrew | ||
| 299 | takes all of the different subsystem kernel trees and patches and mushes | ||
| 300 | them together, along with a lot of patches that have been plucked from | ||
| 301 | the linux-kernel mailing list. This tree serves as a proving ground for | ||
| 302 | new features and patches. Once a patch has proved its worth in -mm for | ||
| 303 | a while Andrew or the subsystem maintainer pushes it on to Linus for | ||
| 304 | inclusion in mainline. | ||
| 305 | |||
| 306 | It is heavily encouraged that all new patches get tested in the -mm tree | ||
| 307 | before they are sent to Linus for inclusion in the main kernel tree. Code | ||
| 308 | which does not make an appearance in -mm before the opening of the merge | ||
| 309 | window will prove hard to merge into the mainline. | ||
| 310 | |||
| 311 | These kernels are not appropriate for use on systems that are supposed | ||
| 312 | to be stable and they are more risky to run than any of the other | ||
| 313 | branches. | ||
| 314 | |||
| 315 | If you wish to help out with the kernel development process, please test | ||
| 316 | and use these kernel releases and provide feedback to the linux-kernel | ||
| 317 | mailing list if you have any problems, and if everything works properly. | ||
| 318 | |||
| 319 | In addition to all the other experimental patches, these kernels usually | ||
| 320 | also contain any changes in the mainline -git kernels available at the | ||
| 321 | time of release. | ||
| 322 | |||
| 323 | The -mm kernels are not released on a fixed schedule, but usually a few | ||
| 324 | -mm kernels are released in between each -rc kernel (1 to 3 is common). | ||
| 325 | |||
| 326 | Subsystem Specific kernel trees and patches | 296 | Subsystem Specific kernel trees and patches |
| 327 | ------------------------------------------- | 297 | ------------------------------------------- |
| 328 | A number of the different kernel subsystem developers expose their | 298 | The maintainers of the various kernel subsystems --- and also many |
| 329 | development trees so that others can see what is happening in the | 299 | kernel subsystem developers --- expose their current state of |
| 330 | different areas of the kernel. These trees are pulled into the -mm | 300 | development in source repositories. That way, others can see what is |
| 331 | kernel releases as described above. | 301 | happening in the different areas of the kernel. In areas where |
| 332 | 302 | development is rapid, a developer may be asked to base his submissions | |
| 333 | Here is a list of some of the different kernel trees available: | 303 | onto such a subsystem kernel tree so that conflicts between the |
| 334 | git trees: | 304 | submission and other already ongoing work are avoided. |
| 335 | - Kbuild development tree, Sam Ravnborg <sam@ravnborg.org> | 305 | |
| 336 | git.kernel.org:/pub/scm/linux/kernel/git/sam/kbuild.git | 306 | Most of these repositories are git trees, but there are also other SCMs |
| 337 | 307 | in use, or patch queues being published as quilt series. Addresses of | |
| 338 | - ACPI development tree, Len Brown <len.brown@intel.com> | 308 | these subsystem repositories are listed in the MAINTAINERS file. Many |
| 339 | git.kernel.org:/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6.git | 309 | of them can be browsed at http://git.kernel.org/. |
| 340 | 310 | ||
| 341 | - Block development tree, Jens Axboe <jens.axboe@oracle.com> | 311 | Before a proposed patch is committed to such a subsystem tree, it is |
| 342 | git.kernel.org:/pub/scm/linux/kernel/git/axboe/linux-2.6-block.git | 312 | subject to review which primarily happens on mailing lists (see the |
| 343 | 313 | respective section below). For several kernel subsystems, this review | |
| 344 | - DRM development tree, Dave Airlie <airlied@linux.ie> | 314 | process is tracked with the tool patchwork. Patchwork offers a web |
| 345 | git.kernel.org:/pub/scm/linux/kernel/git/airlied/drm-2.6.git | 315 | interface which shows patch postings, any comments on a patch or |
| 346 | 316 | revisions to it, and maintainers can mark patches as under review, | |
| 347 | - ia64 development tree, Tony Luck <tony.luck@intel.com> | 317 | accepted, or rejected. Most of these patchwork sites are listed at |
| 348 | git.kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git | 318 | http://patchwork.kernel.org/ or http://patchwork.ozlabs.org/. |
| 349 | 319 | ||
| 350 | - infiniband, Roland Dreier <rolandd@cisco.com> | 320 | 2.6.x -next kernel tree for integration tests |
| 351 | git.kernel.org:/pub/scm/linux/kernel/git/roland/infiniband.git | 321 | --------------------------------------------- |
| 352 | 322 | Before updates from subsystem trees are merged into the mainline 2.6.x | |
| 353 | - libata, Jeff Garzik <jgarzik@pobox.com> | 323 | tree, they need to be integration-tested. For this purpose, a special |
| 354 | git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/libata-dev.git | 324 | testing repository exists into which virtually all subsystem trees are |
| 355 | 325 | pulled on an almost daily basis: | |
| 356 | - network drivers, Jeff Garzik <jgarzik@pobox.com> | 326 | http://git.kernel.org/?p=linux/kernel/git/sfr/linux-next.git |
| 357 | git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/netdev-2.6.git | 327 | http://linux.f-seidel.de/linux-next/pmwiki/ |
| 358 | 328 | ||
| 359 | - pcmcia, Dominik Brodowski <linux@dominikbrodowski.net> | 329 | This way, the -next kernel gives a summary outlook onto what will be |
| 360 | git.kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git | 330 | expected to go into the mainline kernel at the next merge period. |
| 361 | 331 | Adventurous testers are very welcome to runtime-test the -next kernel. | |
| 362 | - SCSI, James Bottomley <James.Bottomley@hansenpartnership.com> | ||
| 363 | git.kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git | ||
| 364 | |||
| 365 | - x86, Ingo Molnar <mingo@elte.hu> | ||
| 366 | git://git.kernel.org/pub/scm/linux/kernel/git/x86/linux-2.6-x86.git | ||
| 367 | |||
| 368 | quilt trees: | ||
| 369 | - USB, Driver Core, and I2C, Greg Kroah-Hartman <gregkh@suse.de> | ||
| 370 | kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/ | ||
| 371 | 332 | ||
| 372 | Other kernel trees can be found listed at http://git.kernel.org/ and in | ||
| 373 | the MAINTAINERS file. | ||
| 374 | 333 | ||
| 375 | Bug Reporting | 334 | Bug Reporting |
| 376 | ------------- | 335 | ------------- |
