编写内核模块Makefile的技巧

Linux 2.6的内核使用Kbuild来编译内核模块。Kbuild能够编译内核树目录内的内核模块，也能够编译内核树目录外的内核模块（外部内核模块）。

.编译外部内核模块的命令：
   #cd
   #make -C M=`pwd`
  
   其中为要编译的内核模块所在目录， 为内核源码所在的目录。
   对于发行版本的Linux，可以用：
   #make -C /lib/modules/`uname -r`/build M=`pwd`
  
   注意：使用Kbuild之前，必须先成功编译过内核源码。
   说明：
        .#make -C M=`pwd` modules
        作用与上面的命令一样
        .以前的内核版本可以使用
         #make -C SUBDIRS=`pwd` modules

.安装外部内核模块
   #make -C M=`pwd` modules_install  
    默认安装目录为：/lib/modules/`uname -r`/extra，可以通过INSTALL_MOD_PATH宏在默认安装路径前加前缀。
    例如：
   #make -C INSTALL_MOD_PATH=/opt M=`pwd` modules_install  
   则编译后的模块会放在/opt/lib/modules/`uname -r`/extra
   通过宏INSTALL_MOD_DIR可以修改是否放在'extra'下，例如：
   #make -C INSTALL_MOD_DIR=golf M=`pwd` modules_install
   则编译后的模块会放在/lib/modules/`uname -r`/golf
  
.编译单个文件
   #make -C M=`pwd`

.其他命令
   #make -C M=`pwd` clean
   #make -C M=`pwd` help

.Kbuild文件
Linux的Kbuild会在内核模块目录下查找Kbuild文件，如果有，则在编译时会使用该文件。

示例：
假设有这么几个文件：8123_if.c 8123_if.h 8123_pci.c 8123_bin.o_shipped(二进制的模块文件)
Kbuild文件的内容：
     obj-m := 8123.o
     8123-y:8123_if.o 8123_pci.o 8123_bin.o
    
Makefile的内容：
     #为了兼容旧版本的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
    
     注意，没有源码的二进制.o文件必须以原文件名加_shipped结尾，例如8123_bin.o_shipped，KBuild会把8123_bin.o_shipped
         复制为8123_bin.o，然后一起编译。
        
        
.Makefile中如何包括自己的include文件
    由于采用Kbuild编译外部内核模块时，编译路径切换到了内核源码树的目录，因此如果在Makefile中使用相对路径来包含另一个文件    时，会找不到该文件。因此，不能用
       include ../config.mk
      
    应该用：
       ifeq ($(obj),)
          obj= .
       endif
       include $(obj)/../config.mk

在Linux下编译内核模块的Makefile的几种写法
对一个简单的模块：
cat simple.c
#include
#include
//#include
MODULE_LICENSE("Dual BSD/GPL");

static int hello_init(void)
{
        printk("<1>Hello module init.\n");
        return 0;
}

static void   hello_exit(void)
{
        printk("<1>Goodbye module exit.\n");
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_AUTHOR("lizeliang");
MODULE_DESCRIPTION("a simple module");
MODULE_ALIAS("hello");

编译过程首先会到内核源码目录下，读取顶层的Makefile文件，然后再返回模块源码所在目录。
<一>比较简单的写法，有人认为这不是正真的Makefile
obj -m :=simple.o>Makefile //重定向显示内容到Makefile文件
+x Makefile //为什么要这样，我也没弄清楚，谁知道补充一下；其实在我的机子上不加这一句也是可以的
make -C /usr/src/linux-headers-2.6.24-15-generic M=$PWD modules //M=$PWD M代表要编译的模块的绝对路径 #make -C linux-headers-`uname -r`/dir 表示make将调到/dir下去执行make

<二>对陈老师《Linux操作系统原理与应用》上2.4内核下的一点改进：
cat Makefile
obj-m +=simple.o
all:
    make -C /usr/src/linux-headers-`uname -r` M=`pwd` modules #编译
clean:
    make -C /usr/src/linux-headers-`uname -r` M=`pwd` clean #清理
make
make clean
<三>IBM网站上
# Makefile2.6
ifneq ($(KERNELRELEASE),) #KERNELRELEASE是在内核源码的顶层Makefile中定义的一个变量，在第一次读取执行此Makefile 时，KERNELRELEASE没有被定义，所以make将读取执行else之后的内容。
#kbuild syntax. dependency relationshsip of files and target modules are listed here.
#mymodule-objs := file1.o file2.o ... #表示mymoudule.o 由file1.o与file2.o 等连接生成。如果有多个文件，需要把这一句加上
obj-m := mymodule.o #表示编译连接后将生成mymodule.o模块。
else
PWD := $(shell pwd) #执行shell命令，把当前路径赋值给PWD
KVER ?= $(shell uname -r) #执行shell命令，将当前系统内核版本号赋值给KVER
KDIR := /lib/modules/$(KVER)/build
all:
    $(MAKE) -C $(KDIR) M=$(PWD) #与"$(MAKE) -C $(KDIR) SUBDIRS =$(PWD)"的作用是等效的,SUBDIRS是较老的使用方法
clean:
rm -rf .*.cmd *.o *.mod.c *.ko .tmp_versions
endif

执行路径：如果make的目标是clean，直接执行clean操作，然后结束。当make的目标为all时，-C $(KDIR) 指明跳转到内核源码目录下读取那里的Makefile；M=$(PWD) 表明然后返回到当前目录继续读入、执行当前的Makefile。当从内核源码目录返回时，KERNELRELEASE已被被定义，kbuild也被启动去解析kbuild语法的语句，make将继续读取else之前的内容。else之前的内容为kbuild语法的语句, 指明模块源码中各文件的依赖关系，以及要生成的目标模块名。
来自：http://blog.chinaunix.net/u2/73569/showart_1085411.html