引導模塊時,可以向它傳遞參數(shù)。要使用模塊參數(shù)加載模塊,這樣寫:
insmod module.ko [param1=value param2=value ...]
|
為了使用這些參數(shù)的值,要在模塊中聲明變量來保存它們,并在所有函數(shù)之外的某個地方使用宏 MODULE_PARM(variable, type) 和 MODULE_PARM_DESC(variable, description) 來接收它們。 type參數(shù)應該是一個格式為 [min[-max]]{b,h,i,l,s} 字符串,其中 min 和 max 是數(shù)組的長度限度。如果兩者都忽略了,則默認為 1。最后一個字符是類型說明符:
b byte h short
i int
l long
s string |
在用戶態(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)限。 module_param (name,type,perm); module_param 使用了 3 個參數(shù): 變量名, 它的類型, 以及一個權(quán)限掩碼用來做一個輔助的 sysfs 入口(啥意思). 這個宏定義應當放在任何函數(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)存為用戶提供的字串分配, 指針因此設置. 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ù)在加載時設置, num 被設置成提供的數(shù)的個數(shù). 模塊加載者拒絕比數(shù)組能放下的多的值.
perm參數(shù)的作用是什么? 最后的 module_param 字段是一個權(quán)限值; 你應當使用 中定義的值. 這個值控制誰可以存取這些模塊參數(shù)在 sysfs 中的表示.如果 perm 被設為 0, 就根本沒有 sysfs 項. 否則, 它出現(xiàn)在 /sys/module下面, 帶有給定的權(quán)限. 使用 S_IRUGO 作為參數(shù)可以被所有人讀取, 但是不能改變; S_IRUGO|S_IWUSR 允許 root 來改變參數(shù). 注意, 如果一個參數(shù)被 sysfs 修改, 你的模塊看到的參數(shù)值也改變了, 但是你的模塊沒有任何其他的通知. 你應當不要使模塊參數(shù)可寫, 除非你準備好檢測這個改變并且因而作出反應. perm參數(shù)的作用是什么? 最后的 module_param 字段是一個權(quán)限值,表示此參數(shù)在sysfs文件系統(tǒng)中所對應的文件節(jié)點的屬性。你應當使用 中定義的值. 這個值控制誰可以存取這些模塊參數(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ù)可寫, 除非你準備好檢測這個改變并且因而作出反應.
通過宏MODULE_PARM_DESC()對參數(shù)進行說明: 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.” ); module_param() 和module_param_array() 的作用就是讓那些全局變量對insmod 可見,使模塊裝載時可重新賦值。 module_param_array() 宏的第三個參數(shù)用來記錄用戶insmod 時提供的給這個數(shù)組的元素個數(shù),NULL 表示不關(guān)心用戶提供的個數(shù) module_param() 和module_param_array() 最后一個參數(shù)權(quán)限值不能包含讓普通用戶也有寫權(quán)限,否則編譯報錯。這點可參考linux/moduleparam.h 中__module_param_call() 宏的定義。 字符串數(shù)組中的字符串似乎不能包含逗號,否則一個字符串會被解析成兩個 一個測試用例:parm_hello.c #include<linux/module.h> #include<linux/moduleparam.h> #include<linux/kernel.h> #defineMAX_ARRAY 6
staticintint_var=0; staticconstchar*str_var="default"; static int int_array[6]; intnarr;
module_param(int_var,int,0644); MODULE_PARM_DESC(int_var,"A integer variable");
module_param(str_var,charp,0644); MODULE_PARM_DESC(str_var,"A string variable");
module_param_array(int_array,int,&narr,0644); MODULE_PARM_DESC(int_array,"A integer array");
staticint__init hello_init(void) { inti; printk(KERN_ALERT"Hello, world./n"); printk(KERN_ALERT"int_var %d./n",int_var); printk(KERN_ALERT"str_var %s./n",str_var);
for(i=0;i<narr;i++){ printk("int_array[%d] = %d/n",i,int_array[i]); } return0; }
staticvoid__exit hello_exit(void) { printk(KERN_ALERT"Bye, world./n"); } module_init(hello_init); module_exit(hello_exit); MODULE_LICENSE("GPL"); MODULE_AUTHOR("kelly"); MODULE_DEION("This module is a example.");
|
Linux中EXPORT_SYMBOL的用法 EXPORT_SYMBOL標簽內(nèi)定義的函數(shù)對全部內(nèi)核代碼公開,不用修改內(nèi)核代碼就可以在您的內(nèi)核模塊中直接調(diào)用。您還可以手工修改內(nèi)核源代碼來導出另外的函數(shù),用于重新編譯并加載新內(nèi)核后的測試。
Linux symbol export method:
[1] If we want export the symbol in a module, just use the EXPORT_SYMBOL(xxxx) in the C or H file. And compile the module by adding the compile flag -DEXPORT_SYMTAB. Then we can use the xxxx in the other module.
[2] If we want export some symbol in Kernel that is not in a module such as xxxx in the /arch/ppc/fec.c. Firstly, define the xxxx in the fec.c; Secondly, make a new file which contain the "extern" define the xxxx(for example, extern int xxxx); Lastly, in the ppc_ksyms.c we includes the new file, and add the EXPORT_SYMBOL(xxxx). Then we can use the xxxx.
對于如何向模塊傳遞參數(shù),Linux kernel 提供了一個簡單的框架。其允許驅(qū)動程序聲明參數(shù),并且用戶在系統(tǒng)啟動或模塊裝載時為參數(shù)指定相應值,在驅(qū)動程序里,參數(shù)的用法如同全局變量。 使用下面的宏時需要包含頭文件<linux/moduleparam.h>。 通過宏module_param()定義一個模塊參數(shù): module_param(name, type, perm); name既是用戶看到的參數(shù)名,又是模塊內(nèi)接受參數(shù)的變量; type表示參數(shù)的數(shù)據(jù)類型,是下列之一:byte, short, ushort, int, uint, long, ulong, charp, bool, invbool; perm指定了在sysfs中相應文件的訪問權(quán)限。訪問權(quán)限與linux文件愛你訪問權(quán)限相同的方式管理,如0644,或使用stat.h中的宏如S_IRUGO表示。 0表示完全關(guān)閉在sysfs中相對應的項。 這些宏不會聲明變量,因此在使用宏之前,必須聲明變量,典型地用法如下: static unsigned int int_var = 0; module_param(int_var, uint, S_IRUGO);
這些必須寫在模塊源文件的開頭部分。即int_var是全局的。也可以使模塊源文件內(nèi)部的變量名與外部的參數(shù)名有不同的名字,通過module_param_named()定義。module_param_named(name, variable, type, perm);其中name是外部可見的參數(shù)名,variable是源文件內(nèi)部的全局變量名,而module_param通過module_param_named實現(xiàn),只不過name與variable相同。 例如: static unsigned int max_test = 9; module_param_name(maximum_line_test, max_test, int, 0); 如果模塊參數(shù)是一個字符串時,通常使用charp類型定義這個模塊參數(shù)。內(nèi)核復制用戶提供的字符串到內(nèi)存,并且相對應的變量指向這個字符串。 例如: static char *name; module_param(name, charp, 0); 另一種方法是通過宏module_param_string()讓內(nèi)核把字符串直接復制到程序中的字符數(shù)組內(nèi)。 module_param_string(name, string, len, perm); 這里,name是外部的參數(shù)名,string是內(nèi)部的變量名,len是以string命名的buffer大?。梢孕∮?span lang="EN-US">buffer的大小,但是沒有意義),perm表示sysfs的訪問權(quán)限(或者perm是零,表示完全關(guān)閉相對應的sysfs項)。 例如: static char species[BUF_LEN]; module_param_string(specifies, species, BUF_LEN, 0); 如果需要傳遞多個參數(shù)可以通過宏module_param_array()實現(xiàn)。 module_param_array(name, type, nump, perm); 其中,name既是外部模塊的參數(shù)名又是程序內(nèi)部的變量名,type是數(shù)據(jù)類型,perm是sysfs的訪問權(quán)限。指針nump指向一個整數(shù),其值表示有多少個參數(shù)存放在數(shù)組name中。值得注意是name數(shù)組必須靜態(tài)分配。 例如: static int finsh[MAX_FISH]; static int nr_fish; module_param_array(fish, int, &nr_fish, 0444); //最終傳遞數(shù)組元素個數(shù)存在nr_fish中 通過宏module_param_array_named()使得內(nèi)部的數(shù)組名與外部的參數(shù)名有不同的名字。 例如: module_param_array_named(name, array, type, nump, perm);
通過宏MODULE_PARM_DESC()對參數(shù)進行說明: 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.” ); 說明:from http://blog.csdn.net/iczyh/archive/2008/10/26/3149727.aspx module_param() 和 module_param_array() 的作用就是讓那些全局變量對 insmod 可見,使模塊裝載時可重新賦值。 module_param_array() 宏的第三個參數(shù)用來記錄用戶 insmod 時提供的給這個數(shù)組的元素個數(shù),NULL 表示不關(guān)心用戶提供的個數(shù) module_param() 和 module_param_array() 最后一個參數(shù)權(quán)限值不能包含讓普通用戶也有寫權(quán)限,否則編譯報錯。這點可參考 linux/moduleparam.h 中 __module_param_call() 宏的定義。 字符串數(shù)組中的字符串似乎不能包含逗號,否則一個字符串會被解析成兩個 一個測試用例:parm_hello.c #include <linux/module.h> #include <linux/moduleparam.h> #include <linux/kernel.h> #define MAX_ARRAY 6
static int int_var = 0; static const char *str_var = "default"; static int int_array[6]; int narr;
module_param(int_var, int, 0644); MODULE_PARM_DESC(int_var, "A integer variable");
module_param(str_var, charp, 0644); MODULE_PARM_DESC(str_var, "A string variable");
module_param_array(int_array, int, &narr, 0644); MODULE_PARM_DESC(int_array, "A integer array");
static int __init hello_init(void) { int i; printk(KERN_ALERT "Hello, my LKM.\n"); printk(KERN_ALERT "int_var %d.\n", int_var); printk(KERN_ALERT "str_var %s.\n", str_var);
for(i = 0; i < narr; i ++){ printk("int_array[%d] = %d\n", i, int_array[i]); } return 0; }
static void __exit hello_exit(void) { printk(KERN_ALERT "Bye, my LKM.\n"); } module_init(hello_init); module_exit(hello_exit); MODULE_LICENSE("GPL"); MODULE_AUTHOR("ydzhang"); MODULE_DEION("This module is a example.");
|
測試:insmod parm_hello.ko int_var=100 str_var=hello int_array=100,200
|