《Linux内核设计与实现》——补丁、开发和社区

一、社区

二、编码风格

1、与其他大型软件项目一样，Linux制订了一套编码风格，对代码的格式、风格和布局做错了规定。编码风格的主要规范都记录在内核源码树的Documemtation/CodingStyle

中。

2、缩进

1）、缩进风格是用制表符（Tab）每次缩进8个字符长度。这不是说用八个空格就可以了。这里的规定很明确，每次缩进通过制表符进行，每个制表位8个字符长度。

3、awitch语句

1）、Switch语句下属的case标记应该缩进到和switch声明对齐，这样将有助于减少8个字符的tab键带来的排版缩进。

4、空格

1）、一般来说，Linux的编码风格规定，空格放在关键字周围，函数名和圆括号之间无空格。

2）、相反，函数、宏以及函数相像的关键字在关键字和圆括号之间没有空格。在圆括号内，参数前后也不加空格。

3）、对于大多数二元和三元操作符，在操作符的两边加上空格。相反，对于大多数一元操作符，在操作符和操作数之间不加空格。

4）、在提领运算符的周围加上合适的空格尤为重要。在提领运算符的以便加上空格是不良的风格。把提领运算符放在紧挨类型的地方也是借用C++的一种不良风格。

5、花括号

1）、内核选定的风格是左括号紧跟在语句的最后，与语句在相同的一行。而括号要新起一行，作为该行的第一个字符。注意，在接下来的标识符是相同语句块的一部分，那

么花括号就不单独占一行，而是与那个标识符在同一行。

2）、函数不采用下列书写方式，因为函数不会在内部嵌套定义：

unsigned long func(void);

{

/* . . . */

};

3）、不需要一定使用括号的语句就可以忽略它。

6、每行代码的长度

1）、源代码中要尽可能地保证每行长度不超过80个字符，因为这样做可以最适合在标准的80X24的终端上显示。

2）、有些开发者会在圆括号内来分行，对齐排列函数参数。

3）、而另一些开发者虽然也会将分行输入，但不会把它们对齐排列，而是在开头简单的加上标准tab。

7、命令规范

1）、名称中不允许使用骆驼拼写法、Studly Caps或者其他混合的大小写字符。

2）、匈牙利命名法是不必要的，绝对不允许使用。

3）、而全局变量和函数应该选择包含描述性内容的名称，并且使用小写字母，必要时加上上下划线区分单词。

8、函数

1）、根据经验，函数的代码长度不应该超过两屏，局部变量不应该超过10个。

9、注释

1）、一般情况下，你应该描述的是你的代码要做什么和为什么要做，而不是具体通过什么方式实现。

2）、注释不应该包含谁写了那个函数、修改日期和其他那些琐碎而无实际意义的内容。这些信息应该集中在文件最开头的地方。

3）、在注释中，重要信息常常以“XXX ：”开头，而bug通常以“FIXME：”开头。

10、多用现成的东西。

11、在源码中少用itdef。

12、结构初始化

1）、结构初始化的时候必须在它的成员前加上结构标识符。这种初始化避免错误地使用其他结构而引发一个初始化错误。

13、代码的事后修正。

1）、indent是一个在大多数Linux系统中都能够找到的好工具，它可以按照指定的方式对源代码进行格式化，默认情况下它按照不怎么好看的GNU编码风格格式化代码。

三、管理系统

四、提交错误报告

五、补丁

一）、创建补丁

1、创建补丁最简单的办法是通过两份内核源代码进行的，一份源码，另一份是加进了所修改部分的源代码。一般会给原来的内核代码起名linux-x.y.z，而修改过的就起名

linux，然后利用下面的命令通过这两份代码创建补丁：

diff -urN linux-x.y.z/ linux/ > my-patch

1）、通过-u参数指定使用特殊的diff输出格式。

2）、-r参数保证会变异所有子目录进行操作，而-N参数指明做出修改的源代码中所有新加入的文件在diff操作时包含在内。

3）、如果想对一个单独的文件进行diff，你也可以这么做：

diff -u linux-x.y.z/some/file linux/file > my->patch

2、diffstat可以列出补丁所引起的变更的统计。输出关于补丁的信息，执行：

diffstat -pl my-patch

二）、用Git创建补丁

1、用Git创建补丁过程：

1）、首先，你必须是修改者，然后在本地提交你的修改。

2）、作出修改后，就需要把所做的修改提交到你的Git版本库：

git commit -a

3）、如果你仅仅想提交某个指定文件的修改，则如下实例：

git commit some/file.c

4）、要增加一个文件，然后提交（以及其它所有修改），则输入下列两条命令：

git add some/other/file.c

git commit -a

2、Git的设计可谓考虑周全，多个提交甚至可以针对同一文件，每个提交的创建各自独立。当在源代码有一个（或两个）提交创建一个补丁，可以用下列命令：

git firmat -patch origin

3、GIT产生的补丁位于源代码树中的根目录中。如果指向为最后第N次提交产生补丁，则可以执行下列命令：

git format -patch -N

三）、提交补丁