Linux内核编码风格(linus亲笔撰写)

时间：03-13 来源：点击：

测量标准：局部变量的数目。这不该超过5到10个，否则你可能会弄错。应当重新考虑这个函数，把它分解成小片。人类的大脑一般能同时记住7个不同的东西，超过这个数目就会犯糊涂。或许你认为自己很聪明，那么请你理解一下从现在开始的2周时间你都做什么了。

第 5 章：注释

注释是有用的，但过量的注释则是有害的。不要试图在注释中解释你的代码是如何工作的：把代码是如何工作的视为一件显然的事情会更好些，而且，给糟糕的代码作注释则是在浪费时间。

通常，你愿意自己的注释说出代码是做什么的，而不是如何做。还有，尽量避免在函数体内作注释：如果函数很复杂，你很可能需要分开来注释，回头到第4章去看看吧。你可以给一段代码──漂亮的或丑陋的──作注释以引起注意或警告，但是不要过量。取而代之，应当把注释放在函数首部，告诉人们该函数作什么，而不是为什么这样做。

第 6 章：你把事情弄乱了

好吧，我们来看看。很可能有长期使用UNIX的人告诉过你，"GNU emacs"能自动为你格式化C程序源代码，你注意到这是真的，它确实能做到，但是缺省情况下它的用处远远小于期望值──键入无数的monkeys到GNU emacs中绝不可能造出好的程序。

因此，你可以或者删除GNU emacs，或者对它进行理智的配置。对于后者，可以把下面的行粘贴到你的.emacs文件中：

(defun linux-c-mode ()

"C mode with adjusted defaults for use with the Linux kernel."

(interactive)

(c-mode)

(c-set-style "K&R")

(setq c-basic-offset 8))

这将会定义一个把C代码弄成linux风格的命令。当hacking一个模块时，如果你把"-*- linux-c-*-"放到了最初的两行，这个模块将被自动调用。而且，如果你打算每当在/usr/src/linux下编辑源文件时就自动调用它，也许你会把下面的命令：

(setq auto-mode-alist (cons '("/usr/src/linux.*/.*\\.ch$" . linux-c-mode)

auto-mode-alist))

添加进你的.emacs文件。

但是，即使你没能让emacs正确做到格式化，也并非将就此一无所有：还有"indent"程序呢。

嗯，再提醒一下，GNU indent跟GNU emacs有同样的毛病，这就需要你给它一些命令行选项。然而，这不是很糟糕的事，因为即使是GNU indent也承认K&R的权威性(GNU的人不是魔鬼，他们只是在这里太过严格了，以致于误导人)，所以你可以只需给indent这样的选项："-kr -i8"(表示"K&R风格，8个字符的缩进")。

"indent"程序有很多选项，特别是当为重排过的程序作注释的时候，你需要看一下它的手册。记住："indent"可不是修正糟糕程序的万能钥匙。

第 7 章：配置文件(configuration-files)

对配置选项来说(arch/xxx/config.in和所有的Config.in文件)，使用不同的缩进风格。

若代码中的缩进级别为3，配置选项就应该为2,这样可以暗示出依赖关系。后者只是用于bool/tristate(即二态/三态)的选项。对其它情况用常识就行了。举例来说：

if "$CONFIG_EXPERIMENTAL" = "y" ; then

tristate 'Apply nitroglycerine inside the keyboard (DANGEROUS)' CONFIG_BOOM

　　if "$CONFIG_BOOM" != "n" ; then

bool '　Output nice messages when you explode' CONFIG_CHEER

通常CONFIG_EXPERIMENTAL应当在所有不稳定的选项的周围出现。所有已知会破坏数据的选项(如文件系统的实验性的写支持功能)应当被标记为(DANGEROUS)，其他实验性的选项应当被标记为(EXPERIMENTAL)。

第 8 章：数据结构

假如数据结构在其被创建/销毁的线程环境(案：这里说的线程是一个执行实体，可能是进程、内核线程或其它)之外还具有可见性，那么他们都该有引用计数。

在内核中没有垃圾收集机制(而且内核之外的垃圾收集也是缓慢而低效的)，这意味着你绝对应该为每一次使用进行引用计数。

引用计数意味着你可以避开锁，还能允许多个线程并行访问该数据结构──而且不用担心仅仅因为访问数据结构的线程睡眠了一会儿或者干别的去了，它们就会消失。

注意，锁不是引用计数的替代品。锁是用来保持数据结构的一致性的，而引用计数是一种内存管理技术。通常二者都需要，而且不会彼此混淆。

确实有许多数据结构可以有两个级别的引用计数，当使用者具有不同的"等级"(classes)时就是这样。子等级(subclass)记录了处于该等级的使用者个数，而且当它减到零的时候就把总体计数(global count)减一。

这种"多级引用计数"(multi-reference-counting)的一个实例可以在内存管理子系统("struct mm_struct":mm_users和mm_count)中找到，也可以在文件系统的代码中("struct super_block":s_count和s_active)找到。

记住：如果另

上一篇：G.723.1算法在DSP上的优化
下一篇：基于DSP的物体重量实时动态监测的研究

内核 Linux 编码风格相关文章：

栏目分类