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. |
Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 7 | - It can not 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. |
Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 17 | - It can not contain any "trivial" fixes in it (spelling changes, |
Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 18 | whitespace cleanups, etc). |
Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 19 | - It must be accepted by the relevant subsystem maintainer. |
Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 20 | - It must follow the Documentation/SubmittingPatches rules. |
Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 21 | |
| 22 | |
| 23 | Procedure for submitting patches to the -stable tree: |
| 24 | |
| 25 | - Send the patch, after verifying that it follows the above rules, to |
| 26 | stable@kernel.org. |
Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 27 | - The sender will receive an ACK when the patch has been accepted into the |
| 28 | queue, or a NAK if the patch is rejected. This response might take a few |
| 29 | days, according to the developer's schedules. |
| 30 | - If accepted, the patch will be added to the -stable queue, for review by |
| 31 | other developers. |
Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 32 | - 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] | 33 | documented security@kernel.org address. |
Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 34 | |
| 35 | |
| 36 | Review cycle: |
| 37 | |
Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 38 | - When the -stable maintainers decide for a review cycle, the patches will be |
| 39 | sent to the review committee, and the maintainer of the affected area of |
| 40 | the patch (unless the submitter is the maintainer of the area) and CC: to |
| 41 | the linux-kernel mailing list. |
| 42 | - 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] | 43 | - 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] | 44 | members object to the patch, bringing up issues that the maintainers and |
| 45 | members did not realize, the patch will be dropped from the queue. |
| 46 | - At the end of the review cycle, the ACKed patches will be added to the |
| 47 | latest -stable release, and a new -stable release will happen. |
| 48 | - Security patches will be accepted into the -stable tree directly from the |
| 49 | security kernel team, and not go through the normal review cycle. |
Greg KH | fc185d9 | 2005-07-29 12:14:34 -0700 | [diff] [blame] | 50 | Contact the kernel security team for more details on this procedure. |
| 51 | |
| 52 | |
| 53 | Review committe: |
| 54 | |
Jesper Juhl | e48e990 | 2006-01-09 20:53:59 -0800 | [diff] [blame] | 55 | - This is made up of a number of kernel developers who have volunteered for |
| 56 | this task, and a few that haven't. |