这篇文章主要介绍“Linux内核源代码编程的规范有哪些”的相关知识,小编通过实际案例向大家展示操作过程,操作方法简单快捷,实用性强,希望这篇“Linux内核源代码编程的规范有哪些”文章能帮助大家解决问题。
1.强烈推荐单行的宽度为八十列。
任何一行超过八十列宽度的语句都应该拆分成多个行,除非超过八十列的部分可以提高可读性且不会隐藏信息。但是,千万不要把用户可见的字符串,比如 printk
的信息,拆分成多行,因为这样会导致使用 grep
的时候找不到这些信息。
2.关于大括号
c语言里的if
,do
, while
, for
语句都会使用到大括号,内核代码倾向于把左括号放在行末,把右括号放在行首,并且大括号和前面的语句,以及if
和后面的语句,都保留一个空格。
3.关于空格
这个还是单独列出来说明一下吧,因为内核代码里用到空格的地方太多了。
Linux
内核风格的空格主要用在一些关键字上,即在关键字之后添一个空格。值得关注的例外是一些长得像函数的关键字,比如:sizeof
, typeof
, alignof
, attribute
,在 Linux
中,这些关键字的使用都会带上一对括号,比如sizeof(int)
。
所以在下面这些关键字后面需要添加一个空格:
if, switch, case, for, do, while
但是, sizeof
, typeof
, alignof
, attribute
之后则不需要添加空格:
s = sizeof(struct file);
在声明指针或者返回值为指针的函数时,星号的位置应该紧靠着变量名或函数名,而不是类型名,例如:
char linux_banner;
unsigned long long memparse(char ptr, char *retptr);
char match_strdup(substring_t *s);
在二元操作符和三元操作符周围添加一个空格,例如:
= + – < > * / % | & ^ <= >= == != ? :
但是不要在一元操作符之后添加空格:
& * + – ~ ! sizeof typeof alignof attribute defined
4.变量命名
C
是一种简洁粗旷的语言,因此,你的命名也应该是简洁的。linux
内核里的变量定义应该尽可能简单,在不产生歧义的情况下,越简单越好。可以用下划线,但是绝对不推荐使用大写字母。所以,内核里的变量和函数定义不要使用驼峰命名法。
5.函数
函数应该短小精悍,一个函数只干一件事。几百行代码组成一个函数是不被推荐的。
关键函数的前面最好留有注释。
6.注释
多行注释推荐格式如下:
/*
-
To support ISA shared interrupts, we need to have one interrupt
-
handler that ensures that the IRQ line has been deasserted
-
before returning. Failing to do this will result in the IRQ
-
line being stuck active, and, since ISA irqs are edge triggered,
-
no more IRQs will be seen.
*/
7.推荐使用函数自注释
所谓函数自注释,就是从你的函数名就可以猜到你要干什么,比如内核的:
wait_event(), wait_event_interruptible(), wait_event_interruptible_timeout()等。
注意,写代码不只是写给现在的自己,也是写给以后的自己,也是写给其他人看的。如果你回看你一年前写的代码都很陌生,那说明你的代码规范是有问题的。
8.常量宏和枚举的命名都是大写的
9.打印内核或者驱动信息
编写好的调试信息是一项巨大的挑战,一旦你完成了,这些信息会对远程调试产生巨大帮助
很多子系统在对应的 makefile
里都有 Kconfig
调试选项来打开 -DDEBUG
,或者是在文件里定义宏 #define DEBUG
。当调试信息可以被无条件打印,或者说已经编译了和调试有关的 #ifdef
段,那么 printk
(KERN_DEBUG …) 就可以用来打印调试信息。
10.内联函数(inline)
Inline
关键字会让编译器将指定的函数体插入并取代每一处调用该函数的地方(上下文),从而节省了每次调用函数带来的额外时间开支。然而,inline
关键字的泛滥,会使内核变大,从而使整个系统运行速度变慢,因为大内核会占用更多的CPU高速缓存,同时会导致可用内存页缓存减少。想象一下,一次页缓存未命中就会导致一次磁盘寻址,这至少耗费5毫秒。5毫秒足够CPU运行很多很多的指令。
关于“Linux内核源代码编程的规范有哪些”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识,可以关注云搜网行业资讯频道,小编每天都会为大家更新不同的知识点。