## 2.8.?模塊參數
驅動需要知道的幾個參數因不同的系統而不同. 從使用的設備號( 如我們在下一章見到的 )到驅動應當任何操作的幾個方面. 例如, SCSI 適配器的驅動常常有選項控制標記命令隊列的使用, IDE 驅動允許用戶控制 DMA 操作. 如果你的驅動控制老的硬件, 還需要被明確告知哪里去找硬件的 I/O 端口或者 I/O 內存地址. 內核通過在加載驅動的模塊時指定可變參數的值, 支持這些要求.
這些參數的值可由 insmod 或者 modprobe 在加載時指定; 后者也可以從它的配置文件(/etc/modprobe.conf)讀取參數的值. 這些命令在命令行里接受幾類規格的值. 作為演示這種能力的一種方法, 想象一個特別需要的對本章開始的"hello world"模塊(稱為 hellop)的改進. 我們增加 2 個參數: 一個整型值, 稱為 howmany, 一個字符串稱為 whom. 我們的特別多功能的模塊就在加載時, 歡迎 whom 不止一次, 而是 howmany 次. 這樣一個模塊可以用這樣的命令行加載:
~~~
insmod hellop howmany=10 whom="Mom"
~~~
一旦以那樣的方式加載, hellop 會說 "hello, Mom" 10 次.
但是, 在 insmod 可以修改模塊參數前, 模塊必須使它們可用. 參數用 moudle_param 宏定義來聲明, 它定義在 moduleparam.h. module_param 使用了 3 個參數: 變量名, 它的類型, 以及一個權限掩碼用來做一個輔助的 sysfs 入口. 這個宏定義應當放在任何函數之外, 典型地是出現在源文件的前面. 因此 hellop 將聲明它的參數, 并如下使得對 insmod 可用:
~~~
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
一個字符指針值. 內存為用戶提供的字串分配, 指針因此設置.
intlongshortuintulongushort
基本的變長整型值. 以 u 開頭的是無符號值.
數組參數, 用逗號間隔的列表提供的值, 模塊加載者也支持. 聲明一個數組參數, 使用:
~~~
module_param_array(name,type,num,perm);
~~~
這里 name 是你的數組的名子(也是參數名), type 是數組元素的類型, num 是一個整型變量, perm 是通常的權限值. 如果數組參數在加載時設置, num 被設置成提供的數的個數. 模塊加載者拒絕比數組能放下的多的值.
如果你確實需要一個沒有出現在上面列表中的類型, 在模塊代碼里有鉤子會允許你來定義它們; 任何使用它們的細節見 moduleparam.h. 所有的模塊參數應當給定一個缺省值; insmod 只在用戶明確告知它的時候才改變這些值. 模塊可檢查明顯的參數, 通過對應它們的缺省值檢查這些參數.
最后的 module_param 字段是一個權限值; 你應當使用 <linux/stat.h> 中定義的值. 這個值控制誰可以存取這些模塊參數在 sysfs 中的表示. 如果 perm 被設為 0, 就根本沒有 sysfs 項. 否則, 它出現在 /sys/module[[5](#)] 下面, 帶有給定的權限. 使用 S_IRUGO 作為參數可以被所有人讀取, 但是不能改變; S_IRUGO|S_IWUSR 允許 root 來改變參數. 注意, 如果一個參數被 sysfs 修改, 你的模塊看到的參數值也改變了, 但是你的模塊沒有任何其他的通知. 你應當不要使模塊參數可寫, 除非你準備好檢測這個改變并且因而作出反應.
[[5](#)] 然而, 在本書寫作時, 有討論將參數移出 sysfs.
- Linux設備驅動第三版
- 第 1 章 設備驅動簡介
- 1.1. 驅動程序的角色
- 1.2. 劃分內核
- 1.3. 設備和模塊的分類
- 1.4. 安全問題
- 1.5. 版本編號
- 1.6. 版權條款
- 1.7. 加入內核開發社團
- 1.8. 本書的內容
- 第 2 章 建立和運行模塊
- 2.1. 設置你的測試系統
- 2.2. Hello World 模塊
- 2.3. 內核模塊相比于應用程序
- 2.4. 編譯和加載
- 2.5. 內核符號表
- 2.6. 預備知識
- 2.7. 初始化和關停
- 2.8. 模塊參數
- 2.9. 在用戶空間做
- 2.10. 快速參考
- 第 3 章 字符驅動
- 3.1. scull 的設計
- 3.2. 主次編號
- 3.3. 一些重要數據結構
- 3.4. 字符設備注冊
- 3.5. open 和 release
- 3.6. scull 的內存使用
- 3.7. 讀和寫
- 3.8. 使用新設備
- 3.9. 快速參考
- 第 4 章 調試技術
- 4.1. 內核中的調試支持
- 4.2. 用打印調試
- 4.3. 用查詢來調試
- 4.4. 使用觀察來調試
- 4.5. 調試系統故障
- 4.6. 調試器和相關工具
- 第 5 章 并發和競爭情況
- 5.1. scull 中的缺陷
- 5.2. 并發和它的管理
- 5.3. 旗標和互斥體
- 5.4. Completions 機制
- 5.5. 自旋鎖
- 5.6. 鎖陷阱
- 5.7. 加鎖的各種選擇
- 5.8. 快速參考
- 第 6 章 高級字符驅動操作
- 6.1. ioctl 接口
- 6.2. 阻塞 I/O
- 6.3. poll 和 select
- 6.4. 異步通知
- 6.5. 移位一個設備
- 6.6. 在一個設備文件上的存取控制
- 6.7. 快速參考
- 第 7 章 時間, 延時, 和延后工作
- 7.1. 測量時間流失
- 7.2. 獲知當前時間
- 7.3. 延后執行
- 7.4. 內核定時器
- 7.5. Tasklets 機制
- 7.6. 工作隊列
- 7.7. 快速參考
- 第 8 章 分配內存
- 8.1. kmalloc 的真實故事
- 8.2. 后備緩存
- 8.3. get_free_page 和其友
- 8.4. 每-CPU 的變量
- 8.5. 獲得大量緩沖
- 8.6. 快速參考
- 第 9 章 與硬件通訊
- 9.1. I/O 端口和 I/O 內存
- 9.2. 使用 I/O 端口
- 9.3. 一個 I/O 端口例子
- 9.4. 使用 I/O 內存
- 9.5. 快速參考
- 第 10 章 中斷處理
- 10.1. 準備并口
- 10.2. 安裝一個中斷處理
- 10.3. 前和后半部
- 10.4. 中斷共享
- 10.5. 中斷驅動 I/O
- 10.6. 快速參考
- 第 11 章 內核中的數據類型
- 11.1. 標準 C 類型的使用
- 11.2. 安排一個明確大小給數據項
- 11.3. 接口特定的類型
- 11.4. 其他移植性問題
- 11.5. 鏈表
- 11.6. 快速參考
- 第 12 章 PCI 驅動
- 12.1. PCI 接口
- 12.2. 回顧: ISA
- 12.3. PC/104 和 PC/104+
- 12.4. 其他的 PC 總線
- 12.5. SBus
- 12.6. NuBus 總線
- 12.7. 外部總線
- 12.8. 快速參考
- 第 13 章 USB 驅動
- 13.1. USB 設備基礎知識
- 13.2. USB 和 sysfs
- 13.3. USB 的 Urbs
- 13.4. 編寫一個 USB 驅動
- 13.5. 無 urb 的 USB 傳送
- 13.6. 快速參考
- 第 14 章 Linux 設備模型
- 14.1. Kobjects, Ksets 和 Subsystems
- 14.2. 低級 sysfs 操作
- 14.3. 熱插拔事件產生
- 14.4. 總線, 設備, 和驅動
- 14.5. 類
- 14.6. 集成起來
- 14.7. 熱插拔
- 14.8. 處理固件
- 14.9. 快速參考
- 第 15 章 內存映射和 DMA
- 15.1. Linux 中的內存管理
- 15.2. mmap 設備操作
- 15.3. 進行直接 I/O
- 15.4. 直接內存存取
- 15.5. 快速參考
- 第 16 章 塊驅動
- 16.1. 注冊
- 16.2. 塊設備操作
- 16.3. 請求處理
- 16.4. 一些其他的細節
- 16.5. 快速參考
- 第 17 章 網絡驅動
- 17.1. snull 是如何設計的
- 17.2. 連接到內核
- 17.3. net_device 結構的詳情
- 17.4. 打開與關閉
- 17.5. 報文傳送
- 17.6. 報文接收
- 17.7. 中斷處理
- 17.8. 接收中斷緩解
- 17.9. 連接狀態的改變
- 17.10. Socket 緩存
- 17.11. MAC 地址解析
- 17.12. 定制 ioctl 命令
- 17.13. 統計信息
- 17.14. 多播
- 17.15. 幾個其他細節
- 17.16. 快速參考
- 第 18 章 TTY 驅動
- 18.1. 一個小 TTY 驅動
- 18.2. tty_driver 函數指針
- 18.3. TTY 線路設置
- 18.4. ioctls 函數
- 18.5. TTY 設備的 proc 和 sysfs 處理
- 18.6. tty_driver 結構的細節
- 18.7. tty_operaions 結構的細節
- 18.8. tty_struct 結構的細節
- 18.9. 快速參考