| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 1 | Everything you ever wanted to know about Linux 2.6 -stable releases. | 
|  | 2 |  | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 3 | Rules on what kind of patches are accepted, and which ones are not, into the | 
|  | 4 | "-stable" tree: | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 5 |  | 
|  | 6 | - It must be obviously correct and tested. | 
| Matt LaPlante | 84eb8d0 | 2006-10-03 22:53:09 +0200 | [diff] [blame] | 7 | - It cannot be bigger than 100 lines, with context. | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 8 | - It must fix only one thing. | 
|  | 9 | - It must fix a real bug that bothers people (not a, "This could be a | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 10 | problem..." type thing). | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 11 | - It must fix a problem that causes a build error (but not for things | 
|  | 12 | marked CONFIG_BROKEN), an oops, a hang, data corruption, a real | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 13 | security issue, or some "oh, that's not good" issue.  In short, something | 
|  | 14 | critical. | 
|  | 15 | - No "theoretical race condition" issues, unless an explanation of how the | 
|  | 16 | race can be exploited is also provided. | 
| Matt LaPlante | 84eb8d0 | 2006-10-03 22:53:09 +0200 | [diff] [blame] | 17 | - It cannot contain any "trivial" fixes in it (spelling changes, | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 18 | whitespace cleanups, etc). | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 19 | - It must follow the Documentation/SubmittingPatches rules. | 
| Stefan Richter | 46cdf871 | 2008-02-08 23:26:02 +0100 | [diff] [blame] | 20 | - It or an equivalent fix must already exist in Linus' tree.  Quote the | 
|  | 21 | respective commit ID in Linus' tree in your patch submission to -stable. | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 22 |  | 
|  | 23 |  | 
|  | 24 | Procedure for submitting patches to the -stable tree: | 
|  | 25 |  | 
|  | 26 | - Send the patch, after verifying that it follows the above rules, to | 
|  | 27 | stable@kernel.org. | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 28 | - The sender will receive an ACK when the patch has been accepted into the | 
|  | 29 | queue, or a NAK if the patch is rejected.  This response might take a few | 
|  | 30 | days, according to the developer's schedules. | 
|  | 31 | - If accepted, the patch will be added to the -stable queue, for review by | 
| Stefan Richter | 46cdf871 | 2008-02-08 23:26:02 +0100 | [diff] [blame] | 32 | other developers and by the relevant subsystem maintainer. | 
|  | 33 | - If the stable@kernel.org address is added to a patch, when it goes into | 
|  | 34 | Linus's tree it will automatically be emailed to the stable team. | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 35 | - Security patches should not be sent to this alias, but instead to the | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 36 | documented security@kernel.org address. | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 37 |  | 
|  | 38 |  | 
|  | 39 | Review cycle: | 
|  | 40 |  | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 41 | - When the -stable maintainers decide for a review cycle, the patches will be | 
|  | 42 | sent to the review committee, and the maintainer of the affected area of | 
|  | 43 | the patch (unless the submitter is the maintainer of the area) and CC: to | 
|  | 44 | the linux-kernel mailing list. | 
|  | 45 | - The review committee has 48 hours in which to ACK or NAK the patch. | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 46 | - If the patch is rejected by a member of the committee, or linux-kernel | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 47 | members object to the patch, bringing up issues that the maintainers and | 
|  | 48 | members did not realize, the patch will be dropped from the queue. | 
|  | 49 | - At the end of the review cycle, the ACKed patches will be added to the | 
|  | 50 | latest -stable release, and a new -stable release will happen. | 
|  | 51 | - Security patches will be accepted into the -stable tree directly from the | 
|  | 52 | security kernel team, and not go through the normal review cycle. | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 53 | Contact the kernel security team for more details on this procedure. | 
|  | 54 |  | 
|  | 55 |  | 
| Matt LaPlante | 5d3f083 | 2006-11-30 05:21:10 +0100 | [diff] [blame] | 56 | Review committee: | 
| Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 57 |  | 
| Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 58 | - This is made up of a number of kernel developers who have volunteered for | 
|  | 59 | this task, and a few that haven't. |