對於如何向模塊傳遞參數,Linux kernel 提供了一個簡單的框架。其允許驅動程序聲明參數,並且用戶在系統啟動或模塊裝載時為參數指定相應值,在驅動程序裡,參數的用法如同全局變量。
使用下面的宏時需要包含頭文件
通過宏module_param()定義一個模塊參數:
module_param(name, type, perm);
name既是用戶看到的參數名,又是模塊內接受參數的變量;
type表示參數的數據類型,是下列之一:byte, short, ushort, int, uint, long, ulong, charp, bool, invbool;
perm指定了在sysfs中相應文件的訪問權限。訪問權限與linux文件愛你訪問權限相同的方式管理,如0644,或使用stat.h中的宏如S_IRUGO表示。
0表示完全關閉在sysfs中相對應的項。
這些宏不會聲明變量,因此在使用宏之前,必須聲明變量,典型地用法如下:
static unsigned int int_var = 0;
module_param(int_var, uint, S_IRUGO);
這些必須寫在模塊源文件的開頭部分。即int_var是全局的。也可以使模塊源文件內部的變量名與外部的參數名有不同的名字,通過module_param_named()定義。module_param_named(name, variable, type, perm);其中name是外部可見的參數名,variable是源文件內部的全局變量名,而module_param通過module_param_named實現,只不過name與variable相同。
例如:
static unsigned int max_test = 9;
module_param_name(maximum_line_test, max_test, int, 0);
如果模塊參數是一個字符串時,通常使用charp類型定義這個模塊參數。內核復制用戶提供的字符串到內存,並且相對應的變量指向這個字符串。
例如:
static char *name;
module_param(name, charp, 0);
另一種方法是通過宏module_param_string()讓內核把字符串直接復制到程序中的字符數組內。
module_param_string(name, string, len, perm);
這裡,name是外部的參數名,string是內部的變量名,len是以string命名的buffer大小(可以小於buffer的大小,但是沒有意義),perm表示sysfs的訪問權限(或者perm是零,表示完全關閉相對應的sysfs項)。
例如:
static char species[BUF_LEN];
module_param_string(specifies, species, BUF_LEN, 0);
如果需要傳遞多個參數可以通過宏module_param_array()實現。
module_param_array(name, type, nump, perm);
其中,name既是外部模塊的參數名又是程序內部的變量名,type是數據類型,perm是sysfs的訪問權限。指針nump指向一個整數,其值表示有多少個參數存放在數組name中。值得注意是name數組必須靜態分配。
例如:
static int finsh[MAX_FISH];
static int nr_fish;
module_param_array(fish, int, &nr_fish, 0444); //最終傳遞數組元素個數存在nr_fish中
通過宏module_param_array_named()使得內部的數組名與外部的參數名有不同的名字。
例如:
module_param_array_named(name, array, type, nump, perm);
通過宏MODULE_Parm_DESC()對參數進行說明:
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() 宏的第三個參數用來記錄用戶 insmod 時提供的給這個數組的元素個數,NULL 表示不關心用戶提供的個數
module_param() 和 module_param_array() 最後一個參數權限值不能包含讓普通用戶也有寫權限,否則編譯報錯。這點可參考 linux/moduleparam.h 中 __module_param_call() 宏的定義。
字符串數組中的字符串似乎不能包含逗號,否則一個字符串會被解析成兩個。