我们可以用
“module_param(参数名,参数类型,参数读/写权限)”为模块定义一个参数,例如下列代码定义了一个整型参数和一个字符指针参数:
static char *book_name = "Linux Driver";
static int num = 4000;
module_param(num, int, S_IRUGO);
module_param(book_name, charp, S_IRUGO);///S_IRUGO 任何用户(UGO)都可以读(R)
在装载内核模块时,用户可以向模块传递参数,形式为“insmode(或 modprobe) 模块名 参数名=参数值”,如果不传递,参数将使用模块内定义的默认值。
参数类型可以是 byte、short、ushort、int、uint、long、ulong、charp(字符指针)、bool 或 invbool(布尔的反),
在模块被编译时会将 module_param 中声明的类型与变量定义的类型进行比较,判断是否一致。
模块被加载后,在/sys/module/目录下将出现以此模块名命名的目录。当“参数读/写权限”为 0 时,表示此参数不存在 sysfs 文件系统下对应的文件节点,
如果此模块存在“参数读/写权限”不为 0 的命令行参数,在此模块的目录下还将出现 parameters目录,
包含一系列以参数名命名的文件节点,这些文件的权限值就是传入module_param()的“参数读/写权限”,而文件的内容为参数的值。
除此之外,模块也可以拥有参数数组,形式为“module_param_array(数组名,数组类型,数组长,参数读/写权限)”。
从 2.6.0~2.6.10 版本,需将 数组长变量名赋给“数组长”,从 2.6.10 版本开始,需将 数组长变量的指针赋给“数组长”,当不需要保存实际输入的数组元素个数时,可以设置“数组长”为 NULL。
运行 insmod 或 modprobe 命令时,应使用逗号分隔输入的数组元素。
现在我们定义一个包含3个参数的模块 book.c (如下代码所示),并观察模块加载时被传递参数和不传递参数时的输出。
/*======================================================================
A kernel module: book
This example is to introduce module params
The initial developer of the original code is Baohua Song
<author@linuxdriver.cn>. All Rights Reserved.
======================================================================*/
#include <linux/init.h>
#include <linux/module.h>
MODULE_LICENSE("Dual BSD/GPL");
static char *book_name = "dissecting Linux Device Driver";
static int num = 4000;
static int temp = 20;
static int book_init(void)
{
printk(KERN_INFO " book name:%s\n",book_name);
printk(KERN_INFO " book num:%d\n",num);
return 0;
}
static void book_exit(void)
{
printk(KERN_INFO " Book module exit\n ");
}
module_init(book_init);
module_exit(book_exit);
module_param(num, int, S_IRUGO);
module_param(book_name, charp, S_IRUGO);
module_param(temp, int, 0);
MODULE_AUTHOR("Song Baohua, author@linuxdriver.cn");
MODULE_DESCRIPTION("A simple Module for testing module params");
MODULE_VERSION("V1.0");
Makefile:
obj-m += book.o
KDIR=/home/gudujian/work/linux-2.6.35.9
EXTRA_CFLAGS=-g -O0
build:kernel_modules
kernel_modules:
make -C $(KDIR) M=$(CURDIR) modules
clean:
make -C $(KDIR) M=$(CURDIR) clean
编译得到上述的模块:book.ko,加载 可以看到内核的输出:
查看内核参数:
可见 读/写权限为 0 的参数 temp没有出现在parameters目录下。
当执行 insmod book.ko book_name="Driver" num=2000时,输出的是用户传递的参数: