立你斯學習記錄

對於如何向模組傳遞參數，Linux kernel 提供了一個簡單的框架。其允許驅動程式聲明參數，並且使用者在系統啟動或模組裝載時為參數指定相應值，在驅動程式裡，參數的用法如同全域變數。

使用下面的巨集時需要包含標頭檔<linux/moduleparam.h>。

    通過巨集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.” );

 說明：from  http://blog.csdn.net/iczyh/archive/2008/10/26/3149727.aspx

module_param() 和 module_param_array() 的作用就是讓那些全域變數對 insmod 可見，使模組裝載時可重新賦值。

module_param_array() 巨集的第三個參數用來記錄使用者 insmod 時提供的給這個陣列的元素個數，NULL 表示不關心用戶提供的個數

module_param() 和 module_param_array() 最後一個參數許可權值不能包含讓普通用戶也有寫許可權，否則編譯報錯。這點可參考 linux/moduleparam.h 中 __module_param_call() 巨集的定義。

字串陣列中的字串似乎不能包含逗號，否則一個字串會被解析成兩個

一個測試用例：parm_hello.c

測試：insmod parm_hello . ko int_var = 100 str_var = hello int_array = 100 , 200

http://nano-chicken.blogspot.tw/2011/01/linux-modules11module-parameters.html

http://nano-chicken.blogspot.tw/2011/01/linux-modules11module-parameters.html