linux內核可裝載模塊(lkm)傳參機制 module_param

對於如何向模塊傳遞參數,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() 宏的定義。

  字符串數組中的字符串似乎不能包含逗號,否則一個字符串會被解析成兩個

 

 

 

(模塊裝載卸載的時候可以只用模塊名,不需要帶.ko,當然帶上也可。)

module_param

  在用戶態下編程可以通過main()的來傳遞命令行參數,而編寫一個內核模塊則通過module_param()

  參數用 moudle_param 宏定義來聲明, 它定義在 moduleparam.h.

  module_param(name,type,perm);

  module_param 使用了 3 個參數: 變量名, 它的類型, 以及一個權限掩碼用來做一個輔助的 sysfs 入口(啥意思). 這個宏定義應當放在任何函數之外, 典型地是出現在源文件的前面.定義如:

  static char *whom = "world";

  static int howmany = 1;

  module_param(howmany, int, S_IRUGO);

  module_param(whom, charp, S_IRUGO);

  模塊參數支持許多類型:

  bool

  invbool

  一個布爾型( true 或者 false)值(相關的變量應當是 int 類型). invbool 類型顛倒了值, 所以真值變成 false, 反之亦然.

  charp

  一個字符指針值. 內存爲用戶提供的字串分配, 指針因此設置.

  int

  long

  short

  uint

  ulong

  ushort

  基本的變長整型值. 以 u 開頭的是無符號值.

  數組參數, 用逗號間隔的列表提供的值, 模塊加載者也支持. 聲明一個數組參數, 使用:

  module_param_array(name,type,num,perm);

  這裏 name 是你的數組的名子(也是參數名),

  type 是數組元素的類型,

  num 是一個整型變量,

  perm 是通常的權限值.

  如果數組參數在加載時設置, num 被設置成提供的數的個數. 模塊加載者拒絕比數組能放下的多的值.

  perm參數的作用是什麼?

最後的 module_param 字段是一個權限值; 你應當使用 <linux/stat.h> 中定義的值. 這個值控制誰可以存取這些模塊參數在 sysfs 中的表示.如果 perm 被設爲 0, 就根本沒有 sysfs 項. 否則, 它出現在 /sys/module下面, 帶有給定的權限. 使用 S_IRUGO 作爲參數可以被所有人讀取, 但是不能改變; S_IRUGO|S_IWUSR 允許 root 來改變參數. 注意, 如果一個參數被 sysfs 修改, 你的模塊看到的參數值也改變了, 但是你的模塊沒有任何其他的通知. 你應當不要使模塊參數可寫, 除非你準備好檢測這個改變並且因而作出反應.



         轉自:http://blog.csdn.net/xu_guo


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章