insmod 内核模块参数传递

insmod 内核模块参数传递

  对于如何向模块传递参数,Linux kernel 提供了一个简单的框架。其允许驱动程序声明参数,并且用户在系统启动或模块装载时为参数指定相应值,在驱动程序里,参数的用法如同全局变量。

通过宏module_param()定义一个模块参数:

module_param(name,type,perm);

name既是用户看到的参数名,又是模块内接受参数的变量。type表示参数的数据类型。

如:

byte, short, ushort,int, uint, long, ulong, charp, bool, invbool;     

perm指定了在sysfs中相应文件的访问权限。访问权限与linux文件爱你访问权限相同的方式管理,如0644,或使用stat.h中的宏如S_IRUGO表示。0表示完全关闭在sysfs中相对应的项。


这些宏不会声明变量,因此在使用宏之前,必须声明变量,典型

地用法如下:

static unsigned int int_var = 0;

module_param(int_var, uint, S_IRUGO);

这些必须写在模块源文件的开头部分。即int_var是全局的。也可以使模块源文件内部的变量名与外部的参数名有不同的名字,通过

module_param_named()定义。

module_param_named(name, variable, type, perm);其中name是外部可见的参数名,variable是源文件内部的全局变量名,而module_param通过module_param_named实现,只不过name与variable相同。

例如:

static unsigned int max_test = 9;

module_param_name(maximum_line_test, max_test, int, 0);

如果模块参数是一个字符串时,通常使用char类型定义这个模块参数。内核复制用户提供的字符串到内存,并且相对应的变量指向这个字符串。

例如:

static char *name;

module_param(name, charp, 0);

另一种方法是通过宏module_param_string()让内核把字符串直接复制到程序中的字符数组内。

module_param_string(name, string, len, perm);

这里,name是外部的参数名,string是内部的变量名,len是以string命名的buffer大小(可以小于buffer的大小,但是没有意义),perm表示sysfs的访问权限(或者perm是零,表示完全关闭相对应的sysfs项)。

例如:

static char species[BUF_LEN];

module_param_string(specifies, species, BUF_LEN, 0);

如果需要传递多个参数可以通过宏module_param_array()实现。 
module_param_array(name, type, nump, perm);

其中,name既是外部模块的参数名又是程序内部的变量名,type是数据类型,perm是sysfs的访问权限。指针nump指向一个整数,其值表示有多少个参数存放在数组name中。值得注意是name数组必须静态分配。

例如:

static int finsh[MAX_FISH];

static int nr_fish;
module_param_array(fish, int, &nr_fish, 0444);
 最终传

递数组元素个数存在nr_fish中通过宏module_param_array_named()使得内部的数组名与外部的参数名有不同的名字。

例如:

module_param_array_named(name, array, type, nump, perm);

通过宏MODULE_PARM_DESC()对参数进行说明:

static unsigned short size = 1;

module_param(size, ushort, 0644);

MODULE_PARM_DESC(size, “The size in inches of the fishing pole connected to this computer.” );

试验:

下面的小模块具体操作了如何传递参数的方法,麻雀虽小,五脏俱全。

在pc机上也可以试验,并且验证效果。

 1 #include<linux/module.h>
 2 #include<linux/moduleparam.h>
 3 #include<linux/kernel.h>
 4 
 5 
 6 #define MAX_ARRAY 6
 7 
 8 static int_var= 0;
 9 static char * str_var="default";
10 static int_array[6];
11 int narr;
12 //模块传递变量和描述
13 module_param(int_var,int, 0644);
14 MODULE_PARM_DESC(int_var,"A integer variable");
15 
16 //模块传递变量和描述
17 module_param(str_var, charp, 0644);
18 MODULE_PARM_DESC(str_var,"A string variable");
19 //模块传递数组合描述
20 module_param_array(int_array,int,&narr, 0644);
21 MODULE_PARM_DESC(int_array,"A integer array");
22 //array的传递时多了一个参数int类型的地址
23 
24 
25 static int __init hello_init(void)
26 {
27        int i;
28        printk(KERN_ALERT"Hello, my LKM.
");
29        printk(KERN_ALERT"int_var %d.
", int_var);
30        printk(KERN_ALERT"str_var %s.
", str_var);//这个数组参数不知道怎么使用
31        for(i= 0; i< narr; i++){
32                printk("int_array[%d] = %d
", i, int_array[i]);
33        }
34        return 0;
35 }
36 
37 static void __exit hello_exit(void)
38 {
39        printk(KERN_ALERT"Bye, my LKM.
");
40 }
41 module_init(hello_init);
42 module_exit(hello_exit);
43 MODULE_LICENSE("GPL");
44 MODULE_AUTHOR("Edward");
45 MODULE_DEION("This module is a example.");
View Code

insmod hello.ko int_var=1 str_var="edward" int_array=1,2,3,4,5

如果要查看printk输出的内容可以用命令dmesg