module_param()說明
在用戶態(tài)下編程可以通過main()的來傳遞命令行參數(shù),而編寫一個內(nèi)核模塊則通過module_param()
module_param宏是Linux 2.6內(nèi)核中新增的,該宏被定義在include/linux/moduleparam.h文件中,具體定義如下:
#define module_param(name, type, perm) \
module_param_named(name, name, type, perm)
其中使用了 3 個參數(shù):要傳遞的參數(shù)變量名, 變量的數(shù)據(jù)類型, 以及訪問參數(shù)的權(quán)限。
perm參數(shù)的作用是什么?
最后的 module_param 字段是一個權(quán)限值,表示此參數(shù)在sysfs文件系統(tǒng)中所對應的文件節(jié)點的屬性。你應當使用 <linux/stat.h> 中定義的值. 這個值控制誰可以存取這些模塊參數(shù)在 sysfs 中的表示.當perm為0時,表示此參數(shù)不存在 sysfs文件系統(tǒng)下對應的文件節(jié)點。 否則, 模塊被加載后,在/sys/module/ 目錄下將出現(xiàn)以此模塊名命名的目錄, 帶有給定的權(quán)限.。
權(quán)限在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 作為參數(shù)可以被所有人讀取, 但是不能改變; S_IRUGO|S_IWUSR 允許 root 來改變參數(shù). 注意, 如果一個參數(shù)被 sysfs 修改, 你的模塊看到的參數(shù)值也改變了, 但是你的模塊沒有任何其他的通知. 你應當不要使模塊參數(shù)可寫, 除非你準備好檢測這個改變并且因而作出反應.
>>>
這個宏定義應當放在任何函數(shù)之外, 典型地是出現(xiàn)在源文件的前面.定義如:
static char *whom = "world";
static int howmany = 1;
module_param(howmany, int, S_IRUGO);
module_param(whom, charp, S_IRUGO);
模塊參數(shù)支持許多類型:
bool
invbool
一個布爾型( true 或者 false)值(相關(guān)的變量應當是 int 類型). invbool 類型顛倒了值, 所以真值變成 false, 反之亦然.
charp :一個字符指針值. 內(nèi)存為用戶提供的字串分配, 指針因此設(shè)置.
int
long
short
uint
ulong
ushort
基本的變長整型值. 以 u 開頭的是無符號值.
數(shù)組參數(shù), 用逗號間隔的列表提供的值, 模塊加載者也支持. 聲明一個數(shù)組參數(shù), 使用:
module_param_array(name,type,num,perm);
這里 name 是你的數(shù)組的名子(也是參數(shù)名),
type 是數(shù)組元素的類型,
num 是一個整型變量,
perm 是通常的權(quán)限值.
如果數(shù)組參數(shù)在加載時設(shè)置, num 被設(shè)置成提供的數(shù)的個數(shù). 模塊加載者拒絕比數(shù)組能放下的多的值.
測試模塊,源程序hello.c內(nèi)容如下:
#include <linux/init.h>
#include <linux/module.h>
#include <linux/moduleparam.h>
MODULE_LICENSE("Dual BSD/GPL");
static char *who= "world";
static int times = 1;
module_param(times,int,S_IRUSR);
module_param(who,charp,S_IRUSR);
static int hello_init(void)
{
int i;
for(i=0;i<times;i++)
printk(KERN_ALERT "(%d) hello, %s!\n",i,who);
return 0;
}
static void hello_exit(void)
{
printk(KERN_ALERT"Goodbye, %s!\n",who);
}
module_init(hello_init);
module_exit(hello_exit);
編譯生成可執(zhí)行文件hello
插入:
# insmod hello.ko who="world" times=5
出現(xiàn)5次"hello,world!":
#(1)hello,world!
#(2)hello,world!
#(3)hello,world!
#(4)hello,world!
#(5)hello,world!
卸載:
# rmmod hello
出現(xiàn):
#Goodbye,world!