【Linux开发】linux设备驱动归纳总结（二）：模块的相关基础概念
系统平台：Ubuntu 10.04
开发平台：S3C2440开发板
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
一。初探linux内核模块
内核模块：内核本身是很庞大的一个结构，需要的组件很多。编译内核时，用户 可以把所有的代码编译进内核，但是这样会引起两个问题：一是内核过大；二是 当需要添加或者删除内核时，需要重新再编译内核。所以有了内核模块的概念。 模块并不编译到内核中，编译后存放在指定的目录，当需要使用时动态加载。
1.1下面是一个非常经典的hello world代码： 目录：1st
/*2nd_module/1st*/
1 #include //包含了很多装载模块需要的符号和函数的定义
2 #include //用于指定初始化函数和清除函数
3
4 static int __init test_init(void) //内核初始化函数
5 {
6 printk("hello world!\n"); //打印函数，和prinft类似
7 return 0;
8 }
9
10 static void __exit test_exit(void)//内核清除函数
11 {
12 printk("good bye!\n");
13 }
14
15 module_init(test_init); //指定初始化函数
16 module_exit(test_exit); //指定清除函数
17
18 MODULE_LICENSE("GPL"); //指定代码使用的许可证
19 MODULE_AUTHOR("xiao bai"); //指定作者
20 MODULE_VERSION("1.0"); //指定代码修订号
1.2再来一个Makefile：
(注：如果不知道“make -C $(KDIR) M=`pwd` modules ”语句的意思，可以查看linux内核驱动归纳总结（一）：内核的相关基础概念的第六小节)
obj-m += test.o
KDIR:=/root/Desktop/drives/nfsroot-29/linux-2.6.29
all:
make -C $(KDIR) M=`pwd` modules
clean:
make -C $(KDIR) M=`pwd` modules clean
rm -f modules.order
1.3编写完毕后在代码目录下执行“make”命令，就会产生test.ko文件，在开发板 上通过命令“insmod test.ko”,插入模块，通过命令“lsmod”查看当前的所有 装载上的模块，通过命令“rmmod test”卸载该模块。并且，加载时会输出 “hello world!”，卸载时会输出“good bye!”。
[root: 1st]# rmmod test
good bye!
[root: 1st]# insmod test.ko
hello world!
[root: 1st]# lsmod
test 1060 0 - Live 0xbf00c000
[root: 1st]# rmmod test
good bye!
[root: 1st]#
1.4上面的程序包含了三个知识点：
1.4.1内核初始化函数：
static int __init test_init(void) //内核初始化函数
{
}
module_init(test_init); //指定初始化函数
1)初始化函数是在模块加载时自动被调用，执行相关的初始化工作。
2)static和__init都是可以不加的，因为初始化函数除了加载时执行外没有别的 用处，加上static只是声明一下，该函数只能在模块内部使用。而加上__init后，它暗 示内核该函数仅在初始化时使用，所以在模块被装载后，模块装载器就会把该函 数扔掉，释放占用的内存空间。
3)但是moudle_init()是必须要的，因为这样才能让模块加载器知道这是个初始化 函数，没有这一步，函数就不会得到调用。
4)初始化函数成功返回0，失败返回对应的错误码。
1.4.2内核清除函数：
static void __exit test_exit(void)//内核清除函数
{
}
module_exit(test_exit); //指定清除函数
1)内核清除函数是在模块卸载是自动被调用，执行相关的清除工作。
2)同上，static和__exit都是可以不加的，但如果加上__exit，模块直接编 译进内核或者不允许卸载，被标志为__exit的函数会被自动丢弃掉。
3)module_exit是必须的，因为这样内核才能找到清除函数。
4)清除函数的没有返回值。
5)一个没有定义清除函数的模块，是不允许被加载的。
1.4.3模块的描述性定义：
MODULE_LICENSE("GPL"); //指定代码使用的许可证
MODULE_AUTHOR("xiao bai"); //指定作者
MODULE_VERSION("1.0"); //指定代码修订号
1)以上的都是一些都该模块的描述，除了上面的还有MODULE_ALIAS(模块的别名) MODULE_DESCRIPTION(描述用途)等。
2)MODULE_LICENSE一般都是要写的，告诉内核该程序使用的许可证，不然在加载 时它会提示该模块污染内核。
3)MODULE_声明可以声明在源代码任意位置，但习惯放在代码的最后。
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
二。内核中的printk
printk与printf的用法是差不多的，最大的区别就是printk可以指定打印的优先 级。另外一个区别就是，printf只用在用户态，printk用于内核态。
下面由程序讲解 目录：2nd
/*2nd_module/2nd*/
1 #include
2 #include
3
4 static int __init test_init(void)
5 {
6 printk("hello world!\n");
7 printk("<0>" "hello world! 0\n");
8 printk("<1>" "hello world! 1\n");
9 printk("<2>" "hello world! 2\n");
10 printk("<3>" "hello world! 3\n");
11 printk("<4>" "hello world! 4\n");
12 printk("<5>" "hello world! 5\n");
13 printk("<6>" "hello world! 6\n");
14 printk("<7>" "hello world! 7\n");
15 return 0;
16 }
17
18 static void __exit test_exit(void)
19 {
20 printk("good bye!\n");
21 }
22
23 module_init(test_init);
24 module_exit(test_exit);
25
26 MODULE_LICENSE("GPL");
27 MODULE_AUTHOR("xiao bai");
28 MODULE_VERSION("1.0");
编译后加载模块，发现输出内容为：
[root: 2nd]# insmod test.ko
hello world!
hello world! 0
hello world! 1
hello world! 2
hello world! 3
hello world! 4
hello world! 5
hello world! 6
输出唯独缺少了最后一个"hello world! 7"，这是因为printk输出优先级的导致 的。printk的优先级如下,在内核目录下inxlude/linux/kernel.h下有记录：
91 #define KERN_EMERG "<0>" /* system is unusable */
92 #define KERN_ALERT "<1>" /* action must be taken immediately */
93 #define KERN_CRIT "<2>" /* critical conditions */
94 #define KERN_ERR "<3>" /* error conditions */
95 #define KERN_WARNING "<4>" /* warning conditions */
96 #define KERN_NOTICE "<5>" /* normal but significant condition */
97 #define KERN_INFO "<6>" /* informational */
98 #define KERN_DEBUG "<7>" /* debug-level messages */
其中<0>的优先级最高，<7>优先级最低。上面的printk语句的优先级都可以用字符 串代替，如下面两句是同等作用的：
p { margin-bottom: 0.21cm; }printk("<3>" "hello world! 3\n");
printk(KERN_ERR "hello world! 3\n")
如果调用printk使用的优先级低于或等于控制台的默认优先级，就不能被输出到 控制台终端上显示，所以在minicom界面中看不到最后一句的输出。
按照以上的推测，可以得到两个结论：
一、如果不指定prinfk的优先级，prinfk的默认优先级比控制台的优先级高，所 以才能显示在控制台上。
二、控制台的优先级是6，因为低于6优先级的语句不能打印出来。
printk的默认优先级在内核目录kernel/printk.c定义：
47 /* printk's without a loglevel use this.. */
48 #define DEFAULT_MESSAGE_LOGLEVEL 4 /* KERN_WARNING */
49
50 /* We show everything that is MORE important than this.. */
51 #define MINIMUM_CONSOLE_LOGLEVEL 1 /* Minimum loglevel we let people use */
52 #define DEFAULT_CONSOLE_LOGLEVEL 7 /* anything MORE serious than KERN_DEBUG*/
文件中定义了printk的默认输出优先级为4，并定义了一般使用的最大和最小优先 级1和7。
而终端控制台的输出优先级配置在文件/proc/sys/kernel/printk中：
[root: /]# cat /proc/sys/kernel/printk
7 4 1 7
7 4 1 7分别是：
7：console_loglevel //这个就是控制台的默认优先级
4：default_message_loglevel // 这个是printk的默认输出优先级
1：minimum_console_level
7：default_console_loglevel
可以通过修改该文件使所有优先级的消息都显示出来。
[root: /]# echo 8 > /proc/sys/kernel/printk
注意的是，即使没有显示在控制台的内核消息，也会追加到/var/log/messages，通过查看/var/log/messages就能看到。
小技巧：可以通过printk的优先级定义是否输出调试信息：目录：3rd
1 #include
2 #include
3
4 #define DEBUG_SWITCH 0
5 #if DEBUG_SWITCH
6 #define P_DEBUG(fmt, args...) printk("<1>" "[%s]"fmt, __FUNCTION__, ##args)
7 #else
8 #define P_DEBUG(fmt, args...) printk("<7>" "[%s]"fmt, __FUNCTION__, ##args)
9 #endif
10
11
12 static int __init test_init(void)
13 {
14 printk("hello world!\n");
15 P_DEBUG("debug!\n");
16 return 0;
17 }
18
19 static void __exit test_exit(void)
20 {
21 printk("good bye!\n");
22 }
23
24 module_init(test_init);
25 module_exit(test_exit);
26
27 MODULE_LICENSE("GPL");
28 MODULE_AUTHOR("xiao bai");
29 MODULE_VERSION("1.0");
当#define DEBUG_SWITCH 0时，P_DEBUG语句并不输出到控制台。
相反，当#define DEBUG_SWITCH 1时，P_DEBUG语句输出到控制台。
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
三。内核传参————module_param
在用户态的C语言中，函数的传参使用main(int argc, char* argv)，内核的传参使用了另外一种方法：
步骤一、在内核函数中用module_param指定模块参数。
步骤二、加载内核时传递参数给模块。
module_param函数使用方法：
module_param(name, type, perm)
name：内核参数的名称，自己定义；
type：内核参数的类型，常见的类型byte、short、int、long、ulong、bool 、charp(字符指针);
perm：内核参数的权限S_IRUGO(对模块参数具有读权限)。其实权限和文件的 权限差不多，具体可以查看"include/linux/stat.h"。
所以，要定义一个int模块参数，权限是0644，在函数中需要定义：
int a=0;
module_paaram(a, int, 0644);
内核加载模块时传递参数的方法：
使用命令：insmod xxx.ko a=1
如果加载模块时不指定参数，模块会使用默认值0，否则会使用1。
模块加载后，并且他的权限不为0，就可以在/sys/module/xxx/parameter目录下 找到对应的模块参数。
模块参数使用例子：目录 4th
/*2nd_module/4th*/
1 #include
2 #include
3
4 int num = 123;
5 char *name = "xiao bai";
6
7 static int __init test_init(void)
8 {
9 printk("hello world!\n");
10 printk("num = %d, name:[%s]\n", num, name);
11 return 0;
12 }
13
14 static void __exit test_exit(void)
15 {
16 printk("good bye!\n");
17 }
18
19 module_init(test_init);
20 module_exit(test_exit);
21 module_param(num, int, 0644);
22 module_param(name, charp, 0644);
23
24 MODULE_LICENSE("GPL");
25 MODULE_AUTHOR("xiao bai");
26 MODULE_VERSION("1.0");
几种指定模块参数时的效果：
[root: 4th]# insmod test.ko
hello world!
num = 123, name:[xiao bai]
[root: 4th]# rmmod test
good bye!
[root: 4th]# insmod test.ko num=321 name='haha'
hello world!
num = 321, name:[haha]
[root: 4th]# rmmod test
good bye!
[root: 4th]# insmod test.ko name='haha'
hello world!
num = 123, name:[haha]
查看/sys/module/test/parameter目录，出现了模块参数：
[root: 4th]# ls /sys/module/test/parameters/
name num
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
四、内核函数间的调用
内核函数间的调用有两种方法：
1)、把需要调用的函数编译进模块，与C语言的静态库类似。
2)、把许压迫被调用的函数导出到符号表，方便模块使用，与C语言的动态库类似
先说第一个方法：多文件编译 目录 5th
1)编写被调用的函数文件haha.c
1 #include
2 #include "haha.h"
3
4 void haha(void)
5 {
6 printk("haha!\n");
7 }
2)编写头文件haha.h
1 #ifndef __HAHA_H__
2 #define __HAHA_H__
3
4 void haha(void);
5
6 #endif
3)编写模块文件test.c
1 #include
2 #include
3 #include "haha.h"
4
5 static int __init test_init(void)
6 {
7 printk("hello world!\n");
8 haha();
9 return 0;
10 }
11
12 static void __exit test_exit(void)
13 {
14 printk("good bye!\n");
15 }
16
17 module_init(test_init);
18 module_exit(test_exit);
19
20 MODULE_LICENSE("GPL");
21 MODULE_AUTHOR("xiao bai");
22 MODULE_VERSION("1.0");
4)编写Makefile，与之前的Makefile不一样，因为涉及到多文件编译
1 obj-m += test_haha.o //生成test_haha.ko
2 test_haha-objs += haha.o test.o //test_haha.ko有haha.o和test.o组成
3
4 KDIR:=/root/Desktop/drives/nfsroot-29/linux-2.6.29
5 all:
6 make -C $(KDIR) M=`pwd` modules
7 clean:
8 make -C $(KDIR) M=`pwd` modules clean
9 rm -f modules.order
编译完毕后生成test_haha,ko，看一下效果
[root: 5th]# insmod test_haha.ko
hello world!
haha!
值得指出的是，上面的方法一般不用。应该使用下面的方法。
第二种方法：导出符号表EXPORT_SYMBOL ：目录 6th
导出符号表是指，在定义一个函数后，在模块中使用语句"EXPORT_SYMBOL(xxxxx)" 将函数导出。通过这样，内核就知道了该函数和在内存中对应的地址，这样模块 就可以调用导出的函数了。在"/proc/kallsyms"文件中对应这符号表，它记录了函数的符号和函数在内存所在的地址。
看看方法：
1)在6th/core目录下编写被调用的函数的文件haha.c
1 #include
2 #include
3 #include "../include/haha.h"
4
5 int haha(void)
6 {
7 printk("haha!\n");
8 return 0;
9 }
10
11 EXPORT_SYMBOL(haha); //导出函数
12 MODULE_LICENSE("GPL");
2）在6th/core目录下编写Makefile，用于编译haha.c成haha.ko
1 obj-m += haha.o
2
3 KDIR:=/root/Desktop/drives/nfsroot-29/linux-2.6.29
4 all:
5 make -C $(KDIR) M=`pwd` modules
6 clean:
7 make -C $(KDIR) M=`pwd` modules clean
8 rm -f modules.order
3)在6th/include目录下编写头文件haha.h
1 #ifndef __HAHA_H__
2 #define __HAHA_H__
3
4 int haha(void);
5
6 #endif
4)在6th/driver目录下编写文件test.c
1 #include
2 #include
3 #include "../include/haha.h"
4
5 static int __init test_init(void)
6 {
7 printk("hello world!\n");
8 haha();
9 return 0;
10 }
11
12 static void __exit test_exit(void)
13 {
14 printk("good bye!\n");
15 }
16
17 module_init(test_init);
18 module_exit(test_exit);
19
20 MODULE_LICENSE("GPL");
21 MODULE_AUTHOR("xiao bai");
22 MODULE_VERSION("1.0");
5)在6th/driver目录下编写Makefile，用于编译test.c
1 obj-m += test.o
2
3 KDIR:=/root/Desktop/drives/nfsroot-29/linux-2.6.29
4 all:
5 make -C $(KDIR) M=`pwd` modules
6 clean:
7 make -C $(KDIR) M=`pwd` modules clean
8 rm -f modules.order
最终会生成两个文件，一个是core目录下的haha.ko，一个是driver目录下的 test.ko。这两个文件的加载也要讲究顺序。
如果先加载test.ko的话会出错：
[root: driver]# insmod test.ko
test: Unknown symbol haha
insmod: cannot insert 'test.ko': unknown symbol in module or invalid parameter
这是因为内核不能找到函数haha：
[root: core]# cat /proc/kallsyms | grep haha //没有显示任何东西
所以需要先加载模块haha.ko，这样就可以在/proc/kallsyms中找到
[root: /]# cd review_driver/2nd_module/6th/core/
[root: core]# insmod haha.ko
[root: core]# cat /proc/kallsyms | grep haha
00000000 a haha.c [haha]
bf000000 t $a [haha]
bf00001c t $d [haha]
bf000044 r __kstrtab_haha [haha]
c4827080 ? __mod_license12 [haha]
bf000054 r __ksymtab_haha [haha]
bf000054 r $d [haha]
00000000 a haha.mod.c [haha]
c482708c ? __module_depends [haha]
c4827098 ? __mod_vermagic5 [haha]
bf000280 d __this_module [haha]
bf000000 T haha [haha]
c0225c10 u printk [haha]
[root: core]#
到出符号表之后就可以加载模块test.ko了
[root: core]# cd ../driver/
[root: driver]# insmod test.ko
hello world!
haha!
随便提一下两个小问题：
1)、函数是必须有"#include "
原因一：printk的调用需要
原因二：如果不加上面的命令就不会显示"bf000000 T haha [haha]", 而显示"bf000000 t haha [haha]"，小写t表示该符号未定义。
2）、模块的引用技术：
[root: 6th]# insmod core/haha.ko
[root: 6th]# lsmod
haha 904 0 - Live 0xbf000000 //0 无引用
[root: 6th]# insmod driver/test.ko
hello world!
haha!
[root: 6th]# lsmod
test 1084 0 - Live 0xbf003000
haha 904 1 test, Live 0xbf000000 //被引用一次，test模块引用
可以看到，加载了test.ko时，haha模块产生了变化，如果卸载的时候先卸载haha 是不可以的，因为它还被人引用，必须先卸载test。
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
源代码：
2nd_module.rar 
