2.10. 快速參考

2.10.?快速參考

本節(jié)總結(jié)了我們在本章接觸到的內(nèi)核函數(shù), 變量, 宏定義, 和 /proc 文件. 它的用意是作為一個參考. 每一項列都在相關(guān)頭文件的后面, 如果有. 從這里開始, 在幾乎每章的結(jié)尾會有類似一節(jié), 總結(jié)一章中介紹的新符號. 本節(jié)中的項通常以在本章中出現(xiàn)的順序排列:

insmod
modprobe
rmmod

用戶空間工具, 加載模塊到運行中的內(nèi)核以及去除它們.

#include <linux/init.h>
module_init(init_function);
module_exit(cleanup_function);

指定模塊的初始化和清理函數(shù)的宏定義.

__init
__initdata
__exit
__exitdata

函數(shù)( init 和 exit )和數(shù)據(jù) (initdata 和 exitdata)的標記, 只用在模塊初始化或者清理時間. 為初始化所標識的項可能會在初始化完成后丟棄; 退出的項可能被丟棄如果內(nèi)核沒有配置模塊卸載. 這些標記通過使相關(guān)的目標在可執(zhí)行文件的特定的 ELF 節(jié)里被替換來工作.

#include <linux/sched.h>

最重要的頭文件中的一個. 這個文件包含很多驅(qū)動使用的內(nèi)核 API 的定義, 包括睡眠函數(shù)和許多變量聲明.

struct task_struct *current;

當前進程.

current->pidcurrent->comm 

進程 ID 和 當前進程的命令名.

obj-m
一個 makefile 符號, 內(nèi)核建立系統(tǒng)用來決定當前目錄下的哪個模塊應(yīng)當被建立.

/sys/module 
/proc/modules 

/sys/module 是一個 sysfs 目錄層次, 包含當前加載模塊的信息. /proc/moudles 是舊式的, 那種信息的單個文件版本. 其中的條目包含了模塊名, 每個模塊占用的內(nèi)存數(shù)量, 以及使用計數(shù). 另外的字串追加到每行的末尾來指定標志, 對這個模塊當前是活動的.

vermagic.o
來自內(nèi)核源碼目錄的目標文件, 描述一個模塊為之建立的環(huán)境.

#include <linux/module.h>

必需的頭文件. 它必須在一個模塊源碼中包含.

#include <linux/version.h>

頭文件, 包含在建立的內(nèi)核版本信息.

LINUX_VERSION_CODE

整型宏定義, 對 #ifdef 版本依賴有用.

EXPORT_SYMBOL (symbol);
EXPORT_SYMBOL_GPL (symbol);

宏定義, 用來輸出一個符號給內(nèi)核. 第 2 種形式輸出沒有版本信息, 第 3 種限制輸出給 GPL 許可的模塊.

MODULE_AUTHOR(author);
MODULE_DESCRIPTION(description);
MODULE_VERSION(version_string);
MODULE_DEVICE_TABLE(table_info);
MODULE_ALIAS(alternate_name);

放置文檔在目標文件的模塊中.

module_init(init_function);
module_exit(exit_function);

宏定義, 聲明一個模塊的初始化和清理函數(shù).

#include <linux/moduleparam.h>
module_param(variable, type, perm);

宏定義, 創(chuàng)建模塊參數(shù), 可以被用戶在模塊加載時調(diào)整( 或者在啟動時間, 對于內(nèi)嵌代碼). 類型可以是 bool, charp, int, invbool, short, ushort, uint, ulong, 或者 intarray.

#include <linux/kernel.h>
int printk(const char * fmt, ...);

內(nèi)核代碼的 printf 類似物.