之前完成了 Hello World 模块,学会了基本的模块编译、加载和卸载。
作为一个模块,对于不同的系统,可能需要的参数会有所变化,或者对于相同的系统,在不同情况下有不同的参数需求。为了满足这个需求,内核允许在加载驱动模块的过程中指定参数。
本节主要学会以下内容:.
- 在加载模块过程中设定参数
1. 支持的参数
要在模块加载过程中设定参数,首先我们需要明确我们可以设定哪些参数。
内核支持的模块参数如下:
-
bool
布尔型,取值为true
和false
-
invbool
反布尔型,就是和bool
取值相反,true
为false
,false
为true
-
charp
字符指针,内核会为提供的字符串分配内存和指针 -
int
整型,同C语言 -
long
长整型,同C语言 -
short
短整型,同C语言 -
uint
无符号整型 -
ulong
无符号长整型 -
ushort
无符号短整型
除此之外,也还支持数组的设定,后续的例子中会举例说明。
需要说明的是,模块的参数应该给定一个默认值,这样可以根据默认值来判断加载过程中是否指定了参数。
2. 设定参数实例
有之前的 Hello World 模块的基础,我们可以直接上实例代码。在《02. Hello World》中的 LinuxDeviceDriver 目录下新建一个 helloparam 目录,在其中创建原文件和 Makefile 文件,结构如下:
LinuxDeviceDriver(项目根目录)
|- helloparam(HelloParam模块文件夹)
|- helloparam.c (HelloParam模块源码)
|- Makefile (HelloParam模块的Makefile文件)
helloparam.c 文件的内容如下:
#include <linux/init.h>
#include <linux/module.h>
#include <linux/moduleparam.h>
static char *who = "world";
static int age = 100;
static int id[] = {1, 2, 3, 4, 5};
static unsigned int len = 0;
module_param(who, charp, S_IRUGO);
module_param(age, int, S_IRUGO);
module_param_array(id, int, &len, S_IRUGO);
static int __init hello_param_init(void)
{
printk(KERN_ALERT "who is %s, age is %d\n", who, age);
printk(KERN_ALERT "array len is: %d\n", len);
printk(KERN_ALERT "id is:%d, %d, %d, %d, %d\n",
id[0], id[1], id[2], id[3], id[4]);
return 0;
}
static void __exit hello_param_exit(void)
{
printk(KERN_ALERT "Bye-Bye, %s\n", who);
}
module_init(hello_param_init);
module_exit(hello_param_exit);
MODULE_LICENSE("GPL");
基本内容与之前 Hello World 相同,有几点需要详细说明一下:
#include <linux/moduleparam.h>
moduleparam.h
头文件中定义了后面的 module_param
宏和 module_param_array
宏,这两个宏的作用是让这些参数对于 insmod
可见,这样才能对其进行设定。
module_param
宏:有三个参数:第一个为参数名称(即变量名),第二个参数为参数类型(即上面01支持的类型中说明的参数),第三个参数为访问许可掩码(S_IRUGO
、S_IRWXUGO
、S_IXUGO
等,U表示user,G表示group,O表示other)。
module_param_array
宏:有四个参数:第一个为数组名,第二个为参数类型,第三个为一个 unsigned int *
指针变量,用于存储输入的个数,第四个参数为访问许可掩码。
__init和__exit标记
:在初始化函数 hello_param_init
前面有一个 __init
标记,在清除函数 hello_param_exit
前面有一个 __exit
标记。__init
标记的作用是表示这个函数只在初始化过程中起作用,初始化完成后会丢弃,不占用代码区的内存;__exit
标记的作用是表示这个函数只在清除过程中起作用,如果内核被配置为不可卸载,则该函数会被丢弃。
同目录下的Makefile文件内容如下:
obj-m += helloparam.o
clean:
@-rm -f *.ko* *.mod* *.o* *~ *.order .*?.*?
和 Hello World 模块基本相同,只是原文件的名称不同。后续新模块对应的 Makefile 做类似的修改,以后不再说明。
除此之外,还需要在项目根目录下的 Makefile 加入 helloparam 目录,这样编译的时候才会进入到这个目录下进行编译,根目录下的 Makefile 新增内容如下:
SUB_DIR = helloworld/ SUB_DIR = helloworld/ helloparam/
增加了一个 helloparam/
。后续有新的模块,也进行相应的目录增加操作,以后不再说明。
完成上面的源码和 Makefile 后,在项目的根目录下执行 make
命令进行编译,得到相应的 ko
模块文件。
3. 模块运行结果
运行上面的模块,看看效果。
首先,不带任何参数运行,结果如下:
接下来,为who和age设定值,结果如下:
接下来,设定数组值。数组的设定使用逗号进行分割,运行结果如下:
可以看到,输入了三个值,打印的结果也变成了 11,22,33,4,5,后面两个没有设定的值保持默认值。同时,len变量由之前的 0 变为现在的 3,表示输入了三个值。
最后看看如果数组输入的个数大于数组的长度会怎样,运行结果如下:
可以看到,插入报错了,插入失败。因此,一定注意设定数组时,设定的数量不要大于数组长度!