Linux内核模块传参

730阅读 0评论2015-12-05 younglord123
分类:LINUX

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

  使用下面的宏时需要包含头文件

module_param()

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

  module_param(name, type, perm);

  name既是用户看到的参数名,又是模块内接受参数的变量;

  type表示参数的数据类型,是下列之一:byte, short, ushort, int, uint, long, ulong, charp, bool, invbool;

  perm指定了在sysfs中相应文件的访问权限。访问权限与文件访问权限有相同的方式管理,如0644,或使用stat.h中的宏如S_IRUGO表示。

注:不能为0775和0777。即其他用户只能有读权限,不能对内核模块进行操作。

  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()让内核把字符串直接复制到程序中的字符数组内

  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 fish[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() 宏的定义。

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


注:转载自:l

上一篇:内核 __init与__exit
下一篇:linux设备驱动归纳总结(三):2open.close.read.write