linux内核可装载模块(lkm)传参机制 module_param()/module_param_string()

对于如何向模块传递参数，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);

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

　　例如：

　　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.” );

　　module_param() 和 module_param_array() 的作用就是让那些全局变量对 insmod 可见，使模块装载时可重新赋值。

　　module_param_array() 宏的第三个参数用来记录用户 insmod 时提供的给这个数组的元素个数，NULL 表示不关心用户提供的个数

　　module_param() 和 module_param_array() 最后一个参数权限值不能包含让普通用户也有写权限，否则编译报错。这点可参考 linux/moduleparam.h 中 __module_param_call() 宏的定义。

　　字符串数组中的字符串似乎不能包含逗号，否则一个字符串会被解析成两个

（模块装载卸载的时候可以只用模块名，不需要带.ko，当然带上也可。）

module_param

　　在用户态下编程可以通过main()的来传递命令行参数，而编写一个内核模块则通过module_param()

　　参数用 moudle_param 宏定义来声明, 它定义在 moduleparam.h.

　　module_param(name,type,perm);

　　module_param 使用了 3 个参数: 变量名, 它的类型, 以及一个权限掩码用来做一个辅助的sysfs 入口(啥意思). 这个宏定义应当放在任何函数之外, 典型地是出现在源文件的前面.定义如：

　　static char *whom = "world";

　　static int howmany = 1;

　　module_param(howmany, int, S_IRUGO);

　　module_param(whom, charp, S_IRUGO);

　　模块参数支持许多类型:

　　bool

　　invbool

　　一个布尔型( true 或者 false)值(相关的变量应当是 int 类型). invbool 类型颠倒了值,所以真值变成 false, 反之亦然.

　　charp

　　一个字符指针值. 内存为用户提供的字串分配, 指针因此设置.

　　int

　　long

　　short

　　uint

　　ulong

　　ushort

　　基本的变长整型值. 以 u 开头的是无符号值.

　　数组参数, 用逗号间隔的列表提供的值, 模块加载者也支持. 声明一个数组参数, 使用:

　　module_param_array(name,type,num,perm);

　　这里 name 是你的数组的名子(也是参数名),

　　type 是数组元素的类型,

　　num 是一个整型变量,

　　perm 是通常的权限值.

　　如果数组参数在加载时设置, num 被设置成提供的数的个数. 模块加载者拒绝比数组能放下的多的值.

　　perm参数的作用是什么？

最后的 module_param 字段是一个权限值; 你应当使用 <linux/stat.h> 中定义的值. 这个值控制谁可以存取这些模块参数在 sysfs 中的表示.如果 perm 被设为 0, 就根本没有 sysfs 项.否则, 它出现在 /sys/module下面, 带有给定的权限. 使用 S_IRUGO 作为参数可以被所有人读取,但是不能改变; S_IRUGO|S_IWUSR 允许 root 来改变参数. 注意, 如果一个参数被 sysfs 修改,你的模块看到的参数值也改变了, 但是你的模块没有任何其他的通知. 你应当不要使模块参数可写, 除非你准备好检测这个改变并且因而作出反应.