| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  | Everything you ever wanted to know about Linux 2.6 -stable releases. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  | Rules on what kind of patches are accepted, and which ones are not, into the | 
					
						
							|  |  |  | "-stable" tree: | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  |  - It must be obviously correct and tested. | 
					
						
							| 
									
										
										
										
											2006-10-03 22:53:09 +02:00
										 |  |  |  - It cannot be bigger than 100 lines, with context. | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  |  - It must fix only one thing. | 
					
						
							|  |  |  |  - It must fix a real bug that bothers people (not a, "This could be a | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |    problem..." type thing). | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  |  - It must fix a problem that causes a build error (but not for things | 
					
						
							|  |  |  |    marked CONFIG_BROKEN), an oops, a hang, data corruption, a real | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |    security issue, or some "oh, that's not good" issue.  In short, something | 
					
						
							|  |  |  |    critical. | 
					
						
							| 
									
										
										
										
											2008-10-24 10:10:42 -04:00
										 |  |  |  - New device IDs and quirks are also accepted. | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |  - No "theoretical race condition" issues, unless an explanation of how the | 
					
						
							|  |  |  |    race can be exploited is also provided. | 
					
						
							| 
									
										
										
										
											2006-10-03 22:53:09 +02:00
										 |  |  |  - It cannot contain any "trivial" fixes in it (spelling changes, | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |    whitespace cleanups, etc). | 
					
						
							|  |  |  |  - It must follow the Documentation/SubmittingPatches rules. | 
					
						
							| 
									
										
										
										
											2008-02-08 23:26:02 +01:00
										 |  |  |  - It or an equivalent fix must already exist in Linus' tree.  Quote the | 
					
						
							|  |  |  |    respective commit ID in Linus' tree in your patch submission to -stable. | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Procedure for submitting patches to the -stable tree: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  - Send the patch, after verifying that it follows the above rules, to | 
					
						
							|  |  |  |    stable@kernel.org. | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |  - The sender will receive an ACK when the patch has been accepted into the | 
					
						
							|  |  |  |    queue, or a NAK if the patch is rejected.  This response might take a few | 
					
						
							|  |  |  |    days, according to the developer's schedules. | 
					
						
							|  |  |  |  - If accepted, the patch will be added to the -stable queue, for review by | 
					
						
							| 
									
										
										
										
											2008-02-08 23:26:02 +01:00
										 |  |  |    other developers and by the relevant subsystem maintainer. | 
					
						
							|  |  |  |  - If the stable@kernel.org address is added to a patch, when it goes into | 
					
						
							|  |  |  |    Linus's tree it will automatically be emailed to the stable team. | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  |  - Security patches should not be sent to this alias, but instead to the | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |    documented security@kernel.org address. | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Review cycle: | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |  - When the -stable maintainers decide for a review cycle, the patches will be | 
					
						
							|  |  |  |    sent to the review committee, and the maintainer of the affected area of | 
					
						
							|  |  |  |    the patch (unless the submitter is the maintainer of the area) and CC: to | 
					
						
							|  |  |  |    the linux-kernel mailing list. | 
					
						
							|  |  |  |  - The review committee has 48 hours in which to ACK or NAK the patch. | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  |  - If the patch is rejected by a member of the committee, or linux-kernel | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |    members object to the patch, bringing up issues that the maintainers and | 
					
						
							|  |  |  |    members did not realize, the patch will be dropped from the queue. | 
					
						
							|  |  |  |  - At the end of the review cycle, the ACKed patches will be added to the | 
					
						
							|  |  |  |    latest -stable release, and a new -stable release will happen. | 
					
						
							|  |  |  |  - Security patches will be accepted into the -stable tree directly from the | 
					
						
							|  |  |  |    security kernel team, and not go through the normal review cycle. | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  |    Contact the kernel security team for more details on this procedure. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-11-30 05:21:10 +01:00
										 |  |  | Review committee: | 
					
						
							| 
									
										
										
										
											2005-07-29 12:14:34 -07:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-01-09 20:53:59 -08:00
										 |  |  |  - This is made up of a number of kernel developers who have volunteered for | 
					
						
							|  |  |  |    this task, and a few that haven't. |