寫內(nèi)核模塊Makefile的技巧

hansel@163.com
2007.11.07

   Linux 2.6的內(nèi)核使用Kbuild來(lái)編譯內(nèi)核模塊。Kbuild能夠編譯內(nèi)核樹目錄內(nèi)的內(nèi)核模塊，也能夠編譯內(nèi)核樹目錄外的內(nèi)核模塊（外部?jī)?nèi)核模塊）。

.編譯外部?jī)?nèi)核模塊的命令：
   #cd <your-module-dir>
   #make -C <path-to-kernel> M=`pwd`
  
   其中<your-module-dir>為要編譯的內(nèi)核模塊所在目錄，<path-to-kernel> 為內(nèi)核源碼所在的目錄。
   對(duì)于發(fā)行版本的Linux，可以用：
   #make -C /lib/modules/`uname -r`/build M=`pwd`
  
   注意：使用Kbuild之前，必須先成功編譯過(guò)內(nèi)核源碼。
   說(shuō)明：
        .#make -C <path-to-kernel> M=`pwd` modules
        作用與上面的命令一樣
        .以前的內(nèi)核版本可以使用
         #make -C <path-to-kernel> SUBDIRS=`pwd`  modules

.安裝外部?jī)?nèi)核模塊
   #make -C <path-to-kernel> M=`pwd` modules_install  
    默認(rèn)安裝目錄為：/lib/modules/`uname -r`/extra，可以通過(guò)INSTALL_MOD_PATH宏在默認(rèn)安裝路徑前加前綴。
    例如：
   #make -C <path-to-kernel> INSTALL_MOD_PATH=/opt M=`pwd` modules_install  
   則編譯后的模塊會(huì)放在/opt/lib/modules/`uname -r`/extra
   通過(guò)宏INSTALL_MOD_DIR可以修改是否放在'extra'下，例如：
   #make -C <path-to-kernel> INSTALL_MOD_DIR=golf M=`pwd` modules_install 
   則編譯后的模塊會(huì)放在/lib/modules/`uname -r`/golf
  
.編譯單個(gè)文件
   #make -C <path-to-kernel> M=`pwd` <filename>

.其他命令
   #make -C <path-to-kernel> M=`pwd` clean
   #make -C <path-to-kernel> M=`pwd` help

.Kbuild文件
  Linux的Kbuild會(huì)在內(nèi)核模塊目錄下查找Kbuild文件，如果有，則在編譯時(shí)會(huì)使用該文件。

示例：
  假設(shè)有這么幾個(gè)文件：8123_if.c 8123_if.h  8123_pci.c 8123_bin.o_shipped(二進(jìn)制的模塊文件)
  Kbuild文件的內(nèi)容：
     obj-m := 8123.o
     8123-y:8123_if.o 8123_pci.o 8123_bin.o
    
  Makefile的內(nèi)容：
     #為了兼容舊版本的Kbuild
     ifneq($(KERNELRELEASE),)
        include Kbuild
     else
        #正常的Makefile
        KDIR:=/lib/modules/`uname -r`/build
        all::
           $(MAKE) -C $(KDIR) M=`pwd` $@
          
        #其他target
        genbin:
          echo "X" > 8123_bin_shipped
     endif
    
     注意，沒(méi)有源碼的二進(jìn)制.o文件必須以原文件名加_shipped結(jié)尾，例如8123_bin.o_shipped，KBuild會(huì)把8123_bin.o_shipped
         復(fù)制為8123_bin.o，然后一起編譯。
        
        
.Makefile中如何包括自己的include文件
    由于采用Kbuild編譯外部?jī)?nèi)核模塊時(shí)，編譯路徑切換到了內(nèi)核源碼樹的目錄，因此如果在Makefile中使用相對(duì)路徑來(lái)包含另一個(gè)文件
    時(shí)，會(huì)找不到該文件。因此，不能用
       include ../config.mk
      
    應(yīng)該用：
       ifeq ($(obj),)
          obj= .
       endif
       include $(obj)/../config.mk