内核允许对驱动程序指定参数,而这些参数可在装载驱动程序模块时改变。
这些参数的值可在运行insmod或modprobe命令装载模块时赋值,而modprobe还可以从它的配置文件(/etc/modprob.conf)中读取参数值。这两个命令可在命令行接受几种参数类型的赋值。
hello world例子程序:
#include <linux/init.h>
#include <linux/module.h>
#include <linux/moduleparam.h>
static char *whom = "world";
static int howmany = 1;
module_param(howmany,int,S_IRUGO);
module_param(whom,charp,S_IRUGO);
static int __init hello_init(void)
{
for(int i = 0; i < howmany; i++){
printk(KERN_ALERT "Hello %s\n",whom);
}
return 0;
}
static void __exit hello_exit(void)
{
printk(KERN_ALERT "Goodbye, cruel world\n");
}
module_init(hello_init);
module_exit(hello_exit);
MODULE_LICENSE("Dual BSD/GPL");
其中,__init表明该函数仅在初始化期间使用,在模块被装载之后,,模块装载器就会将初始化函数扔掉,这样可将该函数占用的内存释放出来以作他用。__exit修饰词标记该代码仅用于模块卸载(编译器将把该函数放在特殊的ELF段中)。如果模块被直接内嵌到内核中,或者内核配置不允许卸载模块,则被标记为__exit的函数将被简单地丢弃。处于以上原因,被标记为__exit的函数只能在模块被卸载或者系统关闭时被调用,其他的任何用法都是错误的。
module_exit声明对于帮助内核找到模块的清除函数是必需的。
insmod hellop howmany=10 whom="linux"
上面这条命令的效果会让hellop打印10次“hello linux”。
当然,在insmod改变模块参数之前,模块必须让这些参数对insmod命令可见。
参数必须使用module_param宏来声明,这个宏在moduleparam.h中定义。
module_param需要三个参数:
1、变量的名称
2、变量类型
3、用于sysfs入口项的访问许可掩码。
这个宏必须放在任何函数之外,通常是在源文件的头部。这样,hellop通过上面的代码来声明它的参数并使之对insmod可见。
内核支持的模块参数类型如下:
bool
invbool //bool 布尔值,关联的变量应该是int型。invbool类型反转其值。
charp //字符指针值。内核会为用户提供的字符串分配内存,并相应设置指针。
int
long
short
uint
ulong
ushort
模块装载器也支持数组参数,在提供数组值时,用逗号划分各数组成员。。
要声明数组参数,需要使用下面的宏:
module_param_array(name,type,num,perm);
其中,name是数组的名称,type是数组元素的类型,num是一个整数变量,perm是常见的访问许可值。如果在装载时设置数组参数,则num会被设置为用户提供的值得个数。模块装载器会拒绝接受超过数组大小的值。
module_param中的最后一个成员是访问许可值,我们应使用<linux/stat.h>中存在的定义。
这个值用来控制谁能够访问sysfs中对模块参数的表述。
如果perm被设置为0,就不会有对应的sysfs入口项;否则,模块参数会在/sys/module中出现,并设置为给定的访问许可。
如果对参数使用:
S_IRUGO,则任何人均可读取该参数,但是不能修改。
S_IRUGO|S_IWUSR允许root用户修改该参数。
注意:
如果一个参数通过sysfs而被修改,则如同模块修改了这个参数的值一样,但是内核不会以任何方式通知模块。
大多数情况下,我们不应该让模块参数是可写的,除非我们打算检测这种修改并作出相应的动作。
参考书籍:<LINUX设备驱动程序 第三版>