linux 内核模块参数传递

Linux2.6允许用户insmod的时候往内核模块里面传递参数，它主要使用module_param宏定义来实现这一功能。

module_param的定义可以在include/linux/moduleparam.h文件里面查看到，它的原型为：

module_param(name, type, perm);

module_param_array(name, type, nump, perm);

其中module_param是用来传递变量参数的，module_param_array是用来传递数组参数的。

name是在模块中定义的变量名称，type是变量的类型，perm是权限掩码，用来做一个辅助的sysfs入口。

nump是传入数组的数目，是一个int指针。

 

module_param支持传递的参数类型有：

bool：布尔型
invbool：一个布尔型( true 或者 false)值(相关的变量应当是 int 类型). invbool 类型颠倒了值, 所以真值变成 false, 反之亦然.
charp ：一个字符指针值. 内存为用户提供的字串分配, 指针因此设置.
int：整形
long：长整形
short：短整形
uint：无符号整形
ulong：无符号长整形
ushort：无符号短整形
基本的变长整型值. 以 u 开头的是无符号值. 

 

perm 字段是一个权限值,表示此参数在sysfs文件系统中所对应的文件节点的属性。你应当使用 <linux/stat.h> 中定义的值. 这个值控制谁可以存取这些模块参数在 sysfs 中的表示.当perm为0时，表示此参数不存在 sysfs文件系统下对应的文件节点。 否则, 模块被加载后，在/sys/module/ 目录下将出现以此模块名命名的目录, 带有给定的权限.。

权限在include/linux/stat.h中有定义
比如：
#define S_IRWXU 00700
#define S_IRUSR 00400
#define S_IWUSR 00200
#define S_IXUSR 00100
#define S_IRWXG 00070
#define S_IRGRP 00040
#define S_IWGRP 00020
#define S_IXGRP 00010
#define S_IRWXO 00007
#define S_IROTH 00004
#define S_IWOTH 00002
#define S_IXOTH 00001
使用 S_IRUGO 参数可以被所有人读取, 但是不能改变; S_IRUGO|S_IWUSR 允许 root 来改变参数. 注意, 如果一个参数被 sysfs 修改, 你的模块看到的参数值也改变了, 但是你的模块没有任何其他的通知. 你应当不要使模块参数可写, 除非你准备好检测这个改变并且因而作出反应.

 

 

 

下面看一下实验的例子：

 #include <linux/init.h>
 #include <linux/module.h>
 #include <linux/moduleparam.h>
 ///////////////////////////////////////////////////////////
 MODULE_LICENSE("Dual BSD/GPL");
 char *msg_buf = "Hello world!";
 int n_arr[] = {1,2,3,4,5};
 int n = 7;
 //module_param(n, int, S_IRUSR);
 module_param_array(n_arr, int, &n, S_IRUSR);
 module_param(msg_buf, charp, S_IRUSR);
 ///////////////////////////////////////////////////////////
 static __init int hello_init(void)
 {
     int i;
     printk("%s/n", msg_buf);
     for (i=0; i<n; i++)
     {
         printk("n_arr[%d]=%d/n", i, n_arr[i]);
     }
     return 0;
 }
 ///////////////////////////////////////////////////////////
 static __exit void hello_exit(void)
 {
     printk("Goodbye, kernel!/n");
 }
 module_init(hello_init);
 module_exit(hello_exit);

 

Makefile文件：

 ### Makefile
 obj-m := hello.o
 KERNEL_DIR  := /lib/modules/$(shell uname -r)/build
 PWD         := $(shell pwd)

 default:
     $(MAKE) -C $(KERNEL_DIR) M=$(PWD) modules
 clean:
     $(MAKE) -C $(KERNEL_DIR) M=$(PWD) clean

 

运行命令：

 

sudo insmod hello.ko msg_buf=veryCD

然后使用dmesg可以查看到printk的输出：

[35983.685059] veryCD

[35983.685067] n_arr[0]=1

[35983.685072] n_arr[1]=2

[35983.685075] n_arr[2]=3

[35983.685079] n_arr[3]=4

[35983.685083] n_arr[4]=5

[35983.685087] n_arr[5]=7

[35983.685091] n_arr[6]=1

可以看出，实现n_arr的长度应该为5,而n为7,驱动里面并没有检测出，n_arr[5],n_arr[6]已经越界了，，，

但是insmod的时候却是会检测n_arr的长度的，，

输入命令：

sudo insmod hello.ko msg_buf=veryCD n_arr=1,2,3,4,5,6

但是提示出错了，：

insmod: error inserting 'hello.ko': -1 Invalid parameters

因为n_arr的数组长度为5,当输入的数组长度小于等于5的时候，insmod可以加载模块成功，

sudo insmod hello.ko msg_buf=veryCD n_arr=1,2,3

[36315.732903] veryCD

[36315.732908] n_arr[0]=1

[36315.732909] n_arr[1]=2

[36315.732911] n_arr[2]=3

可以看出，module_param_array中的nump的值为实际的输入数组参数长度。

然后当使用insmod加载内核模块，并传递数据参数的时候，系统会自动检测数组的长度，当输入的数组长度小于模块的数组长度是，insmod才会成功。