概述
对于如何向模块传递参数,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字段是一个权限值;你应当使用中定义的值.这个值控制谁可以存取这些模块参数在sysfs中的表示.如果perm被设为0,就根本没有sysfs项.否则,它出现在/sys/module下面,带有给定的权限.使用S_IRUGO作为参数可以被所有人读取,但是不能改变; S_IRUGO|S_IWUSR允许root来改变参数.注意,如果一个参数被sysfs修改,你的模块看到的参数值也改变了,但是你的模块没有任何其他的通知.你应当不要使模块参数可写,除非你准备好检测这个改变并且因而作出反应.
最后
以上就是畅快美女为你收集整理的linux变量声明str类型,linux内核可装载模块(lkm)传参机制 module_param()/module_param_string()...的全部内容,希望文章能够帮你解决linux变量声明str类型,linux内核可装载模块(lkm)传参机制 module_param()/module_param_string()...所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复