簡單一實例講解linux的module模組編譯步驟

本文將直接了當的帶你進入linux的模組編譯。當然在介紹的過程當中，我也會添加一些必要的注釋，以便初學者能夠看懂。之所以要寫這篇文章，主要是因為從書本上學的話，可能要花更長的時間才能學會整個過程，因為看書的話是一個學習過程，而我這篇文章更像是一個培訓。所以實踐性和總結性更強。通過本文你將會學到編譯一個模組和模組makefile的基本知識。以及載入(卸載)模組，查看系統訊息的一些知識；

聲明：本文為初學者所寫，如果你已經是一個linux模組編譯高手，還請指正我文章中的錯誤和不足，謝謝

第一步：準備原始碼

首先我們還是要來編寫一個符合linux格式的模組檔案，這樣我們才能開始我們的模組編譯。假設我們有一個源檔案mymod.c。它的源碼如下：

mymod.c

#include <linux/module.h>    /* 引入與模組相關的宏 */#include <linux/init.h>        /* 引入module_init() module_exit()函數 */#include <linux/moduleparam.h>/* 引入module_param() */MODULE_AUTHOR("Yu Qiang");MODULE_LICENSE("GPL"); static int nbr = 10;module_param(nbr, int, S_IRUGO);static int __init yuer_init(void){    int i;    for(i=0; i<nbr; i++)    {        printk(KERN_ALERT "Hello, How are you. %d\n", i);    }    return 0;}static void __exit yuer_exit(void){    printk(KERN_ALERT"I come from yuer's module, I have been unlad.\n");}module_init(yuer_init);module_exit(yuer_exit);

我們的源檔案就準備的差不多了,這就是一個linux下的模組的基本結構。第9行是匯出我們的符號變數nbr。這樣在你載入這個模組的時候可以動態修改這個變數的值。稍後將示範。yuer_init（）函數將在模組載入的時候運行，通過輸出的結果可以看到我們的模組是否載入成功。

第二步：編寫Makefile檔案
    
首先還是來看看我們Makefile的源檔案，然後我們再來解釋；

Makefile
obj-m := modules.o                   #要產生的模組名     
modules-objs:= mymod.o        #產生這個模組名所需要的目標檔案

KDIR := /lib/modules/`uname -r`/build
PWD := $(shell pwd)

default:
make -C $(KDIR) M=$(PWD) modules

clean:
rm -rf *.o .* .cmd *.ko *.mod.c .tmp_versions

現在我來說明一下這個Makefile。請記住是大寫的Makefile而不是小寫makefile；
obj-m ：這個變數是指定你要聲稱哪些模組模組的格式為 obj-m := <模組名>.o
modules-objs ：這個變數是說明聲稱模組modules需要的目標檔案 格式要求   <模組名>-objs := <目標檔案>
       切記：模組的名字不能取與目標檔案相同的名字。如在這裡模組名不能取成 mymod；
KDIR   ：這是我們正在啟動並執行作業系統核心編譯目錄。也就是編譯模組需要的環境
M=     ：指定我們源檔案的位置
PWD   ：這是當前工作路徑$(shell   )是make的一個內建函數。用來執行shell命令。

第三步：編譯模組

現在我們已經準備好了我們所需要的源檔案和相應的Makefile。我們現在就可以編譯了。在終端進入源檔案目錄輸入make
運行結果：

    make[1]: Entering directory `/usr/src/linux-headers-2.6.24-24-generic'    CC [M] /home/yuqiang/案頭/mymodule/mymodules.o    LD [M] /home/yuqiang/案頭/mymodule/modules.o    Building modules, stage 2.    MODPOST 1 modules    CC      /home/yuqiang/案頭/mymodule/modules.mod.o    LD [M] /home/yuqiang/案頭/mymodule/modules.ko    make[1]: Leaving directory `/usr/src/linux-headers-2.6.24-24-generic'

第四步：載入/卸載我們的模組

從上面的編譯中我可以看到。已經有一個modules.ko產生了。這就是我們的模組了。現在我們就可以來載入了。
首先在終端輸入：sudo insmod modules.ko
現在我們來看看我們的模組載入成功沒有呢？
在終端輸入：dmesg | tail -12   這是查看核心輸出資訊的意思。tail -12 顯示最後12條；
顯示結果如下：

    [17945.024417] sd 9:0:0:0: Attached scsi generic sg2 type 0    [18046.790019] usb 5-8: USB disconnect, address 9    [19934.224812] Hello, How are you. 0    [19934.224817] Hello, How are you. 1    [19934.224818] Hello, How are you. 2    [19934.224820] Hello, How are you. 3    [19934.224821] Hello, How are you. 4    [19934.224822] Hello, How are you. 5    [19934.224824] Hello, How are you. 6    [19934.224825] Hello, How are you. 7    [19934.224826] Hello, How are you. 8    [19934.224828] Hello, How are you. 9

看到了吧。我們的模組的初始化函數yuer_init();已經成功運行了。說明我們的模組已經載入成功；
現在我們再來卸載模組試試看。
在終端輸入：sudo rmmod modules
在終端輸入：dmesg | tail -3

[19934.224826] Hello, How are you. 8[19934.224828] Hello, How are you. 9[20412.046932] I come from yuer's module, I have been unlad.

可以從列印的資訊中看到，我們的模組的退出函數已經被執行了。說明我們的模組已經被成功的卸載了。到目前位置我們就已經算是對模組的編譯到編譯運行算是有了一個整體上的認識了。對於以後深入的學習還是應該有點協助的。下面我們將在看看於模組相關的一些簡單的操作。

第五步：載入模組時傳遞參數
在終端輸入:sudo insmod module_name.ko nbr=4
在終端輸入:dmesg | tail -6
顯示結果如下：

[20800.655694] Hello, How are you. 9[21318.675593] I come from onefile module, I have been unlad.[21334.425373] Hello, How are you. 0[21334.425378] Hello, How are you. 1[21334.425380] Hello, How are you. 2[21334.425381] Hello, How are you. 3

這樣我們就可以看到在模組載入的時候動態設定了我們的一個變數。初始化函數中的迴圈只執行了4次。
可能你會問我怎麼知道一個模組可以設定那些變數呢。當然，你可以先不設變數載入一次。然後可以在終端輸入ls /sys/module/<modules_name>/parameters/來查看。在這裡我們是這樣輸入的
在終端輸入：ls /sys/moedle/modules/parameters/
顯示結果：
nbr

如果我們的模組載入成功了。最後我們還可以通過modinfo來查看我們的模組資訊。如下
在終端輸入：sudo modinfo modules.ko
    顯示結果：

filename:       modules.kolicense:        GPLauthor:         Yu Qiangsrcversion:     20E9C3C4E02D130E6E92533depends:        vermagic:       2.6.24-24-generic SMP mod_unload 586 parm:           nbr:int

本文總結：
    本文的相關知識都好像有一點淺嘗轍止的感覺。因為本篇文章主要是通過一條線式方式來講解了模組編寫的相關過程，其實在這個過程中還有很多可以發散的地方。例如：
在寫到MODULE_AUTHOR（"Yu Qiang"）的時候，你應該想到還有
     MODULE_DESCRIPTION(模組用途的簡單描述);
    MODULE_VERSION(模組的版本字串);
    MODULE_ALIAS(模組的別名);
    ...

在寫到module_param(nbr, int, S_IRUGO);的時候，你應該想到還有
     EXPORT_SYMBOL(name); 可以匯出模組的函數，這也是模組編寫的最終目的
...

在用到insmod 和 modinfo的時候。你應該想到還有
    depmod     分析可載入模組的依賴性，並產生modules.dep檔案和對應檔
    modprobe   Linux核心添加刪除模組
...

如果要成為一名專業的linux模組開發人員，還要走很多的路，就看各位的了，祝大家學習順利。

我並不是什麼linux相關的專家，我只是一個普通的linux相關開發人員（在讀），我的目的也很簡單，就是想給大家介紹一個方法，希望大家在學習的時候不要走過多的彎路。由於個人能力所限難免存在錯誤和缺點，所以請不要介意，如有發現請提出，我立即修改。方便大家學習

本文來源：『』 有水的地方就有餘

文章轉載自20065562's Blog請點擊這裡查看原文