Chinaunix首页 | 论坛 | 博客
  • 博客访问: 1944230
  • 博文数量: 1000
  • 博客积分: 0
  • 博客等级: 民兵
  • 技术积分: 7921
  • 用 户 组: 普通用户
  • 注册时间: 2013-08-20 09:23
个人简介

storage R&D guy.

文章分类

全部博文(1000)

文章存档

2019年(5)

2017年(47)

2016年(38)

2015年(539)

2014年(193)

2013年(178)

分类: 服务器与存储

2014-05-03 08:34:00


linux中module_param简介

分类: linux内核与编程 292人阅读 评论(0) 举报
linux中module_param简介
一. module_param简介
  在用户态下编程可以通过main()的来传递命令行参数,而编写一个内核模块则通过module_param()   参数用 module_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 修改, 你的模块看到的参数值也改变了, 但是你的模块没有任何其他的通知. 你应当不要使模块参数可写, 除非你准备好检测这个改变并且因而作出反应.

说了这么多,看一个程序体验以下:

1.module_param.c

view plaincopy to clipboardprint?
/*  
*   file name : module_param.c  
*   author    : tiger-John     
*/ 
#include  
#include  
#include   
MODULE_LICENSE("GPL");   
static char *who;   
static int  times;   
module_param(who,charp,0644);   
module_param(times,int,0644);   
static int __init hello_init(void)   
{   
    int i;   
    for(i = 1;i <= times;i++)   
    printk("%d  %s!\n",i,who);   
    return 0;   
}   
static void __exit hello_exit(void)   
{   
    printk("Goodbye,%s!\n",who);   
}   
module_init(hello_init);   
module_exit(hello_exit);  


2.编写Makefile文件

 

view plaincopy to clipboardprint?
1 obj-m:=module_param.o   
2 CURRENT_PATH:=$(shell pwd)   
3 VERSION_NUM :=$(shell uname -r)   
4 LINUX_PATH  :=/usr/src/linux-headers-$(VERSION_NUM)   
5    
6 all :   
7         make -C $(LINUX_PATH) M=$(CURRENT_PATH) modules   
8 clean :   
9          make -C $(LINUX_PATH) M=$(CURRENT_PATH) clean  
 


3.在终端输入:make

4 .加载模块: sudo insmdo module_param.ko who=tiger times=4


5.dmesg :查看结果。


过程实例:

a.在终端输入:make


think@:~/module_param$ make
make -C /usr/src/linux-headers-2.6.32-25-generic M=/home/think/module_param modules
make[1]: 正在进入目录 `/usr/src/linux-headers-2.6.32-25-generic'
  Building modules, stage 2.
  MODPOST 1 modules
make[1]:正在离开目录 `/usr/src/linux-headers-2.6.32-25-generic'
think@:~/module_param$

b.在终端输入: sudo insmod module_param.ko who=tiger times=4

think@:~/module_param$ sudo insmod module_param.ko who=tiger times=4

c 在终端输入:dmesg

[ 4297.711137] 1  tiger!
[ 4297.711139] 2  tiger!
[ 4297.711140] 3  tiger!
[ 4297.711141] 4  tiger!


二. 额外模块参数补充

这些宏不会声明变量,因此在使用宏之前,必须声明变量,典型地用法如下:
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.” );

三. modinfo [-adhpv][模块文件]
 功能:显示kernel模块的信息。
 参数:
     -a或--author  显示模块开发人员。 
     -d或--description  显示模块的说明。 
     -h或--help  显示modinfo的参数使用方法。 
     -p或--parameters  显示模块所支持的参数。 
     -V或--version  显示版本信息。
阅读(802) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~