[THIS_MODULE]
模块是一种可以在内核运行过程中动态加载、卸载的内核功能组件。2.6内核中模块在被使用时,是不允许被卸载的。编程是需要用”使用计数”来描述模块是否在被使用。THIS_MODULE就充当了这个功能。
[likely& unlikely]
在2.6的内核中经常看到这两个符号,表面上看if(likely(value))和if(unlikely(value))其实都等同于if(value),但是在实际上执行是不同,加likely的意识着value为真的可能性要大;unlikely与之相反;加上这两个宏编译器会对其进行优化,提高程序效率。
[BUG_ON]
#define BUG_ON(condition) do { \
if(unlikely(condition)) BUG(); \
} while(0)
一些内核调用可以用来方便标记bug,提供断言并输出信息。最常用的两个是BUG()和BUG_ON()。当被调用的时候,它们会引发oops,导致栈的回溯和错误信息的打印。为什么这些声明会导致 oops跟硬件的体系结构是相关的。大部分体系结构把BUG()和BUG_ON()定义成某种非法操作,这样自然会产生需要的oops。
[IS_ERR& PTR_ERR & ERR_PTR]
#define IS_ERR_VALUE(x) unlikely((x) >=(unsigned long)-MAX_ERRNO)
IS_ERR宏用来检测x地址是否有效;
static inline void *ERR_PTR(long error)
{
return(void *) error;
}
static inline long PTR_ERR(const void *ptr)
{
return(long) ptr;
}
[container_of]
/**
*container_of - cast a member of a structure out to the containing structure
*@ptr: the pointer to the member.
*@type: the type of the container structthis is embedded in.
*@member: the name of the member within the struct.
*
*/
#define container_of(ptr, type, member)({ \
consttypeof(((type *)0)->member)*__mptr = (ptr); \
(type *)((char *)__mptr - offsetof(type,member)); })
这可能是内核里面最长见的宏,替开发者解决了不少问题。通过指向成员(成员可以是一个结构体)member的指针ptr,来获取包含该成员的结构体type的指针。
EXAMPLE:
struct example_1 {
struct example_2 s;
int a;
int b;
};
struct example_2 *doo;
struct example_1 *poo = container_of(doo, struct example_1, s);
[__init& __initdata & __exit & __exitdata]
这些宏定义的作用是告诉编译器将这些函数或者数据放入相应的section中,而在模块加载的阶段,.ko文件中的代码和数据的加载区域是根据section来加载的
比如:如果函数的定义中带有__init,那么这个函数的所有代码被放入.init.text的section中;
如果函数的定义中带有__initdata,那么这个函数的所有代码被放入.init.data的section中
之所以要使用这个宏定义,其中一个原因是标记为初始化的函数和数据,表明该函数和数据仅在初始化期间使用,在模块装载之后,模块就会将初始化函数扔掉。这样可以将该函数占用的内存释放出来。
[ARRAY_SIZE]
#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
用于计算数组x成员个数