第二章 构造和运行模块

主题： linux内核模块的程序结构--模块加载函数(必须)，模块卸载函数(必须)模，块许可证声明(必须)，模块参数(可选)，模块导出符号(可选)，模块作者的等信息声明(可选)

一个linux内核模块主要由以下几个部分组成。

1、模块加载函数"用module_init()来指定"(必须)

       当通过insmod和modprobe命令加载内核模块时，模块的加载函数会自动被内核执行，完成本模块的相关初始化工作。

linux模块加载函数一般以 __init表示声明。典型声明如下::

static int __init  initialization_function(void)
{
       /*初始化代码*/
}
module_init(initialization_function);

         模块加载函数必须使用module_init(函数名)的形式被指定。它返回整型值，若初始化成功，应返回0，而初始化失败时，应返回错误编码。在linux内核中，错误编码是一个负值，在errno.h>中定义，包括-ENODEV、-ENOMEM之类的符号值。返回相应的错误编码是种非常好的习惯，只有这样，应用程序才能利用perror等方法把他们转换成有意义的错误信息字符串。

        在2.6内核中，可以使用“request_module(const char *fmt,...)函数”加载内核模块（注意：前面加载模块都是通过insmod和modprobe来实现的），驱动开发人员可以通过调用::

request_module(module_name);

或

request_module("char-major-%d-%d",MAJOR(dev),MINOR(dev));

来加载其他内核模块。

        在linux内核中，所有表示为__init的函数在连接的时候放在.init.text这个区段内，此外，所有的__init函数在段.initcall.init中还保存了一份函数指针，在初始化时，内核会通过这些指针调用这些__init函数,并在初始化完成后释放init区段(.init.text,.initcall.init等)。

////////////////////////////////////////////////////////////////////

2、模块卸载函数"用module_exit()来指定"(必须)

       当通过rmmod和modprobe -r命令卸载内核模块时，模块的卸载函数会自动被内核执行，完成与模块加载函数相反的功能。

       linux内核模块于在函数一般以__exit表示说明，典型的模块卸载函数的形式如下::

static void __exit  cleanup_function(void)
{
         /*释放代码*/
}
module_exit(cleanup_function);

       模块卸载函数在模块卸载的时候执行，不返回任何值，必须以"module_exit(函数名)"的形式来指定。

通常来说，模块卸载函数要完成与模块加载函数相反的功能，如下::

1>若模块加载函数注册了XXX，则模块卸载函数应该注销XXX；

2>若模块记载函数的动态申请了内存，则模块函数应该释放该该内存。

3>若模块加载函数申请了硬件资源(中断，DMA通道、I/O端口和I/O内存等)的占用，   则模块卸载函数应该释放这些硬件资源。

4>模块加载函数一般用来开启硬件，模块卸载函数一般要关闭硬件。 

和__init一样,__exit也可以使用对应函数在运行完成后自动回收内存。实际上，__init

和__exit都是宏，分别定义为::

#define __init __attribute__((__section__(".init.text")))
和
#ifdef MODULE
#define __exit __attribute__((__section__(".exit.text")))
#else
#define __exit    / __attribute__used____attribute((__section__(".exit.text")))
#endif

3、模块许可证声明"MODULE_LICENSE("Daul BSD/GPL")"(必须)

         模块许可证(LICENSE)声明描述内核模块的许可权限，如果不声明LICENSE，模块被加载时，将收到内核被污染(kernel tainted)的警告。

        在linux2.6内核中，可接受的LICENSE包括"GPL"、"GPL v2"、"GPL and additional

rights"、"Dual BSD/GPL"、"Dual MPL/GPL"和"Proprietary"

大多数情况下，内核模块应遵循GPL兼容许可权。linux2.6内核模块中最常见的是以

MODULE_LICENSE("Dual BSD/GPL")语句声明模块采用BSD/GPL双LICENSE.

4、模块参数(可选)

  “模块参数”是“模块被加载的时候可以被传递给模块的值”，它本身对应模块内部的参数“ 我们可以使用"module_param(参数名,参数类型,读/写权限)"为模块定义一个参数，例如::下列代码定义了一个整型参数和一个字符指针参数。

static char *book_name="深入浅出linux设备驱动";
static int num = 4000;
module_param(num,int,S_IRUGO);
module_param(book_name,charp,S_IRGUO);

   在装载内核模块时，用户可以向内核模块传递参数，形式为"sudo insmod/modprobe 模块名(例如linux.ko)参数名=参数值"，若果不传递，参数将使用模块内定义的默认值。向内核模块传递参数时，参数的类型可以是byte(字节),short(短整型)，ushort(无符号短整型),int,uint(无符号int),long,ulong(无符号long)、charp字符指针)、bool或invbool(布尔的反),在模块被编译时会将module_param中声明的类型与变量定义的类型进行比较，判断是否一致。

        模块被加载后，在/sys/module目录下将出现以此模块名命名的目录。当"参数读/写权限"为0时，表示此“参数不存在sysfs文件系统下对应的文件节点”，如果此模块存在"参数读/写权限"不为0的命令行参数，在此模块的目录下将出现parameters

目录，包含一系列“以参数名命名的文件节点”。同时，这些文件的权限就是通过传入module_param()的"参数读/写权限"，而文件的内容为参数的值。

        除此之外，模块也可以拥有参数数组，形式为"module_param_array(数组名,数组类型,数组长，参数读/写权限)"，在2.6.0~2.6.10版本，需将数组常变量名赋给"数组长",从2.6.10版本开始，需将数组长变量的指针赋给"数组长"，当不需要保存实际输入的数组元数个数运行insmod和modprobe命令时，应使用逗号分割输入的数组元素。

例如::

#include<linux/init.h>
#include<linux/module.h>

MODULE_LICENSE("Dual BSD/GPL");
static char *book_name="Dissecting Linux Device Driber";
static int num=4000;

static int __init book_init(void)
{
    printk(KERN_INFO"book name :%s/n",book_name);
    printk(KERN_INFO"book num :%s/n",num);
    return 0;
}

static void __exit book_exit(void)
{
    printk(KERN_INFO"Book module exit/n");
}

module_init(book_init);
module_exit(book_exit);

module_param(num,int,S_IRUGO);
module_param(book_name,charp,S_IRUGO);

MODULE_AUTHOR("chenbaihu");
MODULE_VERSION("v1.0");
MODULE_DESCRIPTION("A simple Module for testing module params");

编译该模块，Makefile为::

obj-m := module_param.o

kernel_path=/usr/src/kernels/2.6.29.6-217.2.16.fc11.i686.PAE 

//内核路径

all:

    make -C $(kernel_path)  M=$(PWD) modules

clean:

    make -C $(kernel_path)  M=$(PWD) clean

然后,运行make命令，进行编译.生成module_param.ko文件.

加载该模块.

第一种方案::

    “sudo insmod module_param.ko”命令时，运行结果为::

book name :Dissecting Linux Device Driber

book num :4000

第二种方案::

   “sudo insmod module_param.ko num=5000”命令时，运行结果为::

book name :Dissecting Linux Device Driber

book num :5000   //参数传入了。

进入/sys/module/module_param/下，输入tree命令::

.

|-- holders

|-- initstate

|-- notes

|-- parameters

|   |-- book_name     //模块参数文件

|   |-- num           //模块参数文件

|-- refcnt

|-- sections

|   |-- __param

|-- srcversion

|-- version

//////////////////////////////////////////////////////////////////////

5、模块导出符号(可选)

   内核模块可以导出符号(symbol，对应与函数或变量)，这样其他模块可以使用本模块中的变量和函数。

       linux2.6的"/proc/kallsyms"文件对应这内核符号表，它记录了符号以及符号符号所在的内存地址。

  模块可以使用如下宏导出符号到内核符号表::

    EXPORT_SYMBOL(符号名);

    EXPORT_SYMBOL_GPL(符合名);    //只是用于GPL许可权模块。

导出的符合将可以被其他模块使用，使用前声明以下既可以。

内核模块中的符号导出(例子)::

#include<linux/init.h>
#include<linux/module.h>
MODULE_LICENSE("Daul BSD/GPL");

int add_integar(int a,int b)
{
    return a+b;
}
int sub_integer(int a,int b)
{
    return a-b;
}

EXPORT_SYMBOL(add_integar);  //导出函数
EXPORT_SYMBOL(sub_integer);  //导出函数

编译后,sudo insmod export_symbol.ko将该模块加入内核。

从"/proc/kallsyms"中可以找到add_integae/sub_integer相关信息。

使用"cat /proc/kallsyms|grep integar"命令，就可以看到下面的结果::

f99f8048 r __ksymtab_add_integar    [export_symbol]

f99f805c r __kstrtab_add_integar    [export_symbol]

f99f8000 T add_integar    [export_symbol]

6、模块作者等信息(可选)

MODULE_AUTOR("作者信息");

MODULE_DESCRIPTION("模块描述信息");

MODULE_VERSION("版本信息");

MODULE_ALIAS("别名信息");

MODULE_DEVICE_TABLE("设备表信息");

对于USB,PCI等设备驱动，通常会创建一个MODULE_DEVICE_TABLE,

表示驱动所支持的设备列表。