Linux之module_param()函数学习

一.module_param
1.为什么引入
 在用户态下编程可以通过main()来传递命令行参数，而编写一个内核模块则可通过module_param()来传递命令行参数.
2. module_param宏是Linux 2.6内核中新增的，该宏被定义在include/linux/moduleparam.h文件中，具体定义如下：
   /* Helper functions: type is byte, short, ushort, int, uint, long,
   ulong, charp, bool or invbool, or XXX if you define param_get_XXX,
   param_set_XXX and param_check_XXX.

*/
   #define module_param_named(name, value, type, perm)              
    param_check_##type(name, &(value));                  
    module_param_call(name, param_set_##type, param_get_##type, &value, perm);
    __MODULE_PARM_TYPE(name, #type)

    #define module_param(name, type, perm)               
    module_param_named(name, name, type, perm)
由此可知 module_param的实现是通过module_param_named(name, name, type, perm)的。
3.module_param使用了3个参数：变量名，它的类型，以及一个权限掩码用来做一个辅助的sysfs入口。
这个宏定义应当放在任何函数之外，典型地是出现在源文件的前面。
eg: static char *whom="world"
    static int    tige=1;
    module_param(tiger,int,S_IRUGO);
    module_param(whom,charp,S_IRUGO);
4.模块参数支持许多类型:
bool
invbool
一个布尔型( true 或者 false)值(相关的变量应当是 int 类型). invbool 类型颠倒了值, 所以真值变成 false, 反之亦然.
charp ：一个字符指针值. 内存为用户提供的字串分配, 指针因此设置.
int
long
short
uint
ulong
ushort
基本的变长整型值. 以 u 开头的是无符号值.
5.数组参数, 用逗号间隔的列表提供的值, 模块加载者也支持。

声明一个数组参数, 使用:
module_param_array(name,type,num,perm);
这里 name 是你的数组的名子(也是参数名),
type 是数组元素的类型,
num 是一个整型变量,
perm 是通常的权限值.
如果数组参数在加载时设置, num 被设置成提供的数的个数. 模块加载者拒绝比数组能放下的多的值.

Tiger-John说明：

perm参数的作用是什么？
最后的 module_param 字段是一个权限值,表示此参数在sysfs文件系统中所对应的文件节点的属性。你应当使用 <linux/stat.h> 中定义的值. 这个值控制谁可以存取这些模块参数在 sysfs 中的表示.当perm为0时，表示此参数不存在 sysfs文件系统下对应的文件节点。 否则, 模块被加载后，在/sys/module/ 目录下将出现以此模块名命名的目录, 带有给定的权限.。
权限在include/linux/stat.h中有定义
比如：
#define S_IRWXU 00700
#define S_IRUSR 00400
#define S_IWUSR 00200
#define S_IXUSR 00100
#define S_IRWXG 00070
#define S_IRGRP 00040
#define S_IWGRP 00020
#define S_IXGRP 00010
#define S_IRWXO 00007
#define S_IROTH 00004
#define S_IWOTH 00002
#define S_IXOTH 00001
使用 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<linux/init.h> 
#include<linux/module.h> 
#include<linux/kernel.h>  
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); 
/*
*   file name : module_param.c
*   author    : tiger-John  
*/
#include<linux/init.h>
#include<linux/module.h>
#include<linux/kernel.h>
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 
  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@Ubuntu:~/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@ubuntu:~/module_param$

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

think@ubuntu:~/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!