转自:http://www.sudu.cn/info/html/edu/20070101/287563.html
来源: ChinaUnix博客 作者: ChinaUnix博客 发布时间:2007-01-01 18:21:00
简介
模块(module)是在内核空间运行的程式,实际上是一种目标对象文件,没有链接,不能独立运行,不过能装载到系统中作为内核的一部分运行,从而能动态扩充内核的功能。模块最主要的用处就是用来实现设备驱动程式。
使用模块的好处:
1,将来修改内核时,不必全部重新编译整个内核,可节省不少时间
2,系统中如果需要使用新模块,不必重新编译内核,只要插入相应的模块即可
模块的使用方式:(modules-1.3.57.tar.gz)
命令 功能 备注
modprobe symbolic link to modprobe
depmod make module dependency file,以告诉将来的 insmod 要去哪抓 modules 来插。 这个 dependency file 就在/lib/modules/[你的kernel版本]/modules.dep
insmod 把某个 module 插入 kernel 中
rmmod 把某个没在用的 module 拔出 kernel symbolic link to insmod
lsmod 把目前 kernel 中插入的 modules 列出来a shell script in 1.3.69f
ksyms symbolic link to insmod
kerneld 一个 daemon,可负责自动呼叫 insmod 插入 module,是个非常方便的 daemon。他也同时查看,若某 module 插入後但非常久没人在用了,就会把他拔出来,以省记忆体。
相关文件:
/etc/rc.d/ rc.modules
/etc/rc.d/rc.S or /etc/rc.d/rc.syinit
/etc/conf.modules or /etc/modules.conf
模块的装载/卸载:
静态:在系统启动时就装载
动态:使用insmod等命令在系统运行过程中装载
注:
1.目前kerneld已被kmod所取代,原因主要是kerneld是使用System V IPC,经过了中间层,比较复杂。
2.需要终极用户权限。
3.形式:
Module: #pages: Used by:
msdos 5 1
vfat 4 1 (autoclean)
fat 6 [vfat msdos] 2 (autoclean)
工作原理
摘要:
*内核符号表
*模块装载
*模块卸载
*多个模块间的依赖关系。
Kernel 里有一个变量叫 module_list,每当 user 将一个 module 载到 kernel 里的时候,这个 module 就会被记录在 module_list 里面。当 kernel 要使用到这个 module 提供的 function 时,他就会去 search 这个 list,找到 module,然后再使用其提供的 function 或 variable。每一个 module 都能 export 一些 function 或变量来让别人使用。除此之外,module 也能使用已载到 kernel 里的 module 提供的 function。这种情形叫做 module stack。比方说,module A 用到 module B 的东西,那在加载 module A 之前必须要先加载 module B。否则 module A 会无法加载。除了 module 会 export 东西之外,kernel 本身也会 export 一些 function 或 variable。同样的,module 也能使用 kernel 所 export 出来的东西。由于大家平时都是撰写 user space 的程式,所以,当忽然去写 module 的时候,会把平时写程式用的 function 拿到 module 里使用。像是 printf 之类的东西。我要告诉各位的是,module 所使用的 function 或 variable,要嘛就是自己写在 module 里,要嘛就是别的 module 提供的,再不就是 kernel 所提供的。你不能使用一般 libc 或 glibc所提供的 function。像 printf 之类的东西。这一点可能是各位要多小心的地方。(也许你能先 link 好,再载到 kernel,我好象试过,不过忘了)。
Linux核心是一种monolithic类型的内核,即单一的大程式,核心中所有的功能部件都能对其全部内部数据结构和例程进行访问。核心的另外 一种形式是微内核结构,此时核心的所有功能部件都被拆成独立部分, 这些部分之间通过严格的通讯机制进行联系。这样通过设置进程将新部件加入核心的方式非常耗时。比如说我们想为一个NCR 810 SCSI卡设置SCSI驱动,不过核心中没有这个部分。那么我们必须重新设置并重构核心。 Linux能让我们能随意动态的加载和卸载操作系统部件。Linux模块就是这样一种可在系统启动后的所有时候动态连入核心的代码块。当我们不再需要他时 又能将他从核心中卸载并删除。Linux模块多指设备驱动、伪设备驱动, 如网络设备和文件系统。
Linux为我们提供了两个命令:使用insmod来显式加载核心模块,使用rmmod来卸载模块。同时核心自身也能请求核心后台进程kerneld来加载和卸载模块。
动态可加载代码的好处在于能让核心保持非常小的尺寸同时非常灵活。在我的Intel系统中由于使用了模块,整个核心仅为406K字节长。由于我只是 偶尔使用VFAT文件系统, 所以我将Linux核心构造成当mount VFAT分区时自动加载VFAT文件系统模块。当我卸载VFAT分区时系统将检测到我不再需要VFAT文件系统模块,将把他从系统中卸载。模块同时还能让 我们无需重构核心并频繁重新启动来尝试运行新核心代码。尽管使用模块非常自由,不过也有可能同时带来和核心模块相关的性能和内存损失。可加载模块的代码一 般有些长并且额外的数据结构可能会占据一些内存。同时对核心资源的间接使用可能带来一些效率问题。
一旦Linux模块被加载则他和普通核心代码相同都是核心的一部分。他们具有和其他核心代码相同的权限和职 责;换句话说Linux核心模块能象所有核心代码和设备驱动相同使核心崩溃。
模块为了使用所需核心资源所以必须能够找到他们。例如模块需要调用核心内存分配例程kmalloc()来分配 内存。模块在构造时并不知道kmalloc()在内存中何处,这样核心必须在使用这些模块前修改模块中对 kmalloc()的引用地址。核心在其核心符号表中维护着一个核心资源链表这样当加载模块时他能够解析出模块 中对核心资源的引用。Linux还允许存在模块堆栈,他在模块之间相互调用时使用。例如VFAT文件系统模块 可能需要FAT文件系统模块的服务,因为VFAT文件系统多少是从FAT文件系统中扩展而来。某个模块对其他模 块的服务或资源的需求类似于模块对核心本身资源或服务的请求。不过此时所请求的服务是来自另外一个事先 已加载的模块。每当加载模块时,核心将把新近加载模块输出的所有资源和符号添加到核心符号表中。
当试图卸载某个模块时,核心需要知道此模块是否已没有被使用,同时他需要有种方法来通知此将卸载模块。 模块必须能够在从核心种删除之前释放其分配的所有系统资源,如核心内存或中断。当模块被卸载时,核心将从核心符号表中删除所有和之对应的符号。
可加载模块具有使操作系统崩溃的能力,而编写较差的模块会带来另外一种问题。当你在一个或早或迟构造的核心而不是当前你运行的核心上加载模块时将会出现什 么结果?一种可能的情况是模块将调用具有错误参数的核心例程。核心应该使用严格的版本控制来对加载模块进行检查以防止这种这些情况的发生。
1 模块的加载
图1 核心模块链表
核心模块的加载方式有两种。首先一种是使用insmod命令手工加载模块。另外一种则是在需要时加载模块;我们称他为请求加载。当核心发现有必要加 载某个模块时,如用户安装了核心中不存在的文件系统时,核心将请求核心后台进程(kerneld)准备加载适当的模块。这个核心后台进程仅仅是个带有终极 用户权限的普通用户进程。当系统启动时他也被启动并为核心打开了一个进程间通讯(IPC)通道。核心需要执行各种任务时用他来向kerneld发送消息。
kerneld的主要功能是加载和卸载核心模块, 不过他还能执行其他任务, 如通过串行线路建立PPP连接并在适当时候关闭他。kerneld自身并不执行这些任务,他通过某些程式如insmod来做此工作。他只是核心的代理,为核心进行调度。
insmod 程式必须找到需求加载的核心模块。请求加载核心模块一般被保存在/lib/modules/kernel-version 中。这些核心模块和系统中其他程式相同是已连接的目标文件,不过他们被连接成可重定位映象。即映象没有被连接到在特定地址上运行。这些核心模块能是 a.out或ELF文件格式。insmod将执行一个特权级系统调用来找到核心的输出符号。这些都以符号名及数值形式,如地址值成对保存。核心输出符号表 被保存在核心维护的模块链表的第一个module结构中,同时module_list指针指向此结构。只有特别符号被添加到此表中,他们在核心编译和连接 时确定,不是核心每个符号都被输出到其模块中。例如设备驱动为了控制某个特定系统中断而由核心例程调用的"request_irq"符号。在我的系统中, 其值为0x0010cd30。我们能通过使用ksyms工具或查看/proc/ksyms来观看当前核心输出符号。ksyms工具既能显示所有核心输出符 号也能只显示那些已加载模块的符号。insmod将模块读入虚拟内存并通过使用来自核心输出符号来修改其未解析的核心例程和资源的引用地址。这些修改工作 采取由insmod程式直接将符号的地址写入模块中相应地址来修改内存中的模块映象。
当insmod修改完模块对核心输出符号的引用后,他将再次使用特权级系统调用来申请足够的空间来容纳新核 心。核心将为其分配一个新的module结构及足够的核心内存来保存新模块, 并将他放到核心模块链表的尾部。 然后将其新模块标志为UNINITIALIZED。
图1给出了一个加载两个模块:VFAT和FAT后的核心链表示意图。不过图中没有画出链表中的第一个模块: 用来存放核心输出符号表的一个伪模块。lsmod能帮助我们列出系统中所有已加载的核心模块及相互间 依赖关系。他是通过重新格式化从核心module结构中建立的/proc/modules来进行这项工作的。核心为其分配的内存被映射到insmod的地 址空间, 这样他就能访问核心空间。insmod将模块拷贝到已分配空间中, 如果为他分配的核心内存已用完,则他将再次申请。不过不要指望多次将加载模块到相同地址,更不用说在两个不同 Linux系统的相同位置。另外此重定位工作包括使用适当地址来修改模块映象。
这个新模块也希望将其符号输出到核心中,insmod将为其构造输出符号映象表。每个核心模块必须包含模块 初始化和模块清除例程,他们的符号被设计成故意不输出, 不过insmod必须知道这些地址, 这样他能将他们传递给核心。所有这些工作做完之后,insmod将调用初始化代码并执行一个特权级系统调用将模块的初始化和清除例程地址传递给核心。
当将一个新模块加载到核心中间时,核心必须更新其符号表并修改那些被新模块使用的老模块。那些依赖于其他模块的模块必须维护在其符号表尾部维护一个引用链 表并在其module数据结构中指向他。图12.1中VFAT 依赖于FAT文件系统模块。所以FAT模块包含一个对VFAT模块的引用;这个引用在加载VFAT模块时添加。核心调用模块的初始化例程,如果成功他将安 装此模块。模块的清除例程地址被存储在其module结构中,他将在 模块卸载时由核心调用。最后模块的状态被设置成RUNNING。
2 模块的卸载
模块能通过使用rmmod命令来删除, 不过请求加载模块将被kerneld在其使用记数为0时自动从系统中删除。 kerneld在其每次idle定时器到期时都执行一个系统调用以将系统中所有不再使用的请求加载模块从系统中 删除。这个定时器的值在启动kerneld时设置;我系统上的值为180秒。这样如果你安装一个iso9660 CDROM并且你的iso9660文件系统是个可加载模块, 则在卸载CD ROM后的非常短时间内此iso9660模块将从核心中删除。
如果核心中的其他部分还在使用某个模块, 则此模块不能被卸载。例如如果你的系统中安装了多个VFAT文件系统则你将不能卸载VFAT模块。执行lsmod我们将看到每个模块的引用记数。如:
Module: #pages: Used by:
msdos 5 1
vfat 4 1 (autoclean)
fat 6 [vfat msdos] 2 (autoclean)
此记数表示依赖此模块的核心实体个数。在上例中VFAT和msdos模块都依赖于fat模块, 所以fat模块的引用记数为2。vfat和msdos模块的引用记数都为1,表示各有一个已安装文件系统。如果我们安装另一个VFAT文件系统则vfat 模块的引用记数将为2。模块的引用记数被保存在其映象的第一个长字中。这个字同时还包含AUTOCLEAN和VISITED标志。请求加载模块使用这两个 标志域。如果模块被标记成AUTOCLEAN则核心知道此模 块能自动卸载。VISITED标志表示此模块正被一个或多个文件系统部分使用;只要有其他部分使用此模块则这个标志被置位。每次系统被kerneld需求 将没有谁使用的请求模块删除时,核心将在所有模块中扫描可能的候选者。不过一般只查看那些被标志成AUTOCLEAN并处于RUNNING状态的模块。如 果某模块的VISITED 标记被清除则他将被删除出去。如果某模块能卸载,则能调用其清除例程来释放掉分配给他的核心资源。他所对应的module结构将被标记成DELETED并 从核心模块链表中断开。其他依赖于他的模块将修改他们各自的引用域来表示他们间的依赖关系不复存在。此模块需要的核心内存都将被回收。
编程实现
模块的组织结构
2.0/2.2
至少需要两个函数:init_module()和cleanup_module()。一般在init_module()完成初始化工作,例如内存分配(kmalloc);在cleanup_module()中完成回收工作。
/* The necessary header files */
/* Standard in kernel modules */
#include /* We e doing kernel work */
#include /* Specifically, a module */
/* Deal with CONFIG_MODVERSIONS */
#if CONFIG_MODVERSIONS==1
#define MODVERSIONS /这两行应该修改为#ifdef MODVERSIONS
#include
#endif
/* Initialize the module */
int init_module()
{
Printk("Hello, world - this is the kernel speakingn");
/* If we return a non zero value, it means that
* init_module failed and the kernel module
* can be loaded */
Return 0;
}
/* Cleanup - undid whatever init_module did */
void cleanup_module()
{
Printk("Short is the life of a kernel modulen");
}
2.3.*/2.4.*中的用法:
2.3/2.4中的用法不同,应该使用:
module_init(init_proc_fs)
module_exit(exit_proc_fs)
好处:有了返回值。
static int __init init_proc_fs(void)
{
int err = register_filesystem(&proc_fs_type);
if (!err) {
proc_mnt = kern_mount(&proc_fs_type);
err = PTR_ERR(proc_mnt);
if (IS_ERR(proc_mnt))
unregister_filesystem(&proc_fs_type);
Else
err = 0;
}
return err;
}
static void __exit exit_proc_fs(void)
{
unregister_filesystem(&proc_fs_type);
kern_umount(proc_mnt);
}
module_init(init_proc_fs)
module_exit(exit_proc_fs)
模块的Makefile
Options:
-D__KERNEL__ / in kernel space
-DMODULE / create module
-DLINUX / which can be compiled on more than one operating system
-D__SMP__ / Symmetrical MultiProcessing
-DCONFIG_MODVERSIONS / should include /usr/include/linux/modversions.h
fomit-frame-pointer告诉gcc不要为那些不必的函数保存页面指针.这会使得我们的寄存器在调用init_module以后保持不变.
多个源程式组成的模块的Makefile
1.在除了一个以外的所有源文件中,增加一行#define __NO_VERSION__。这是非常重要的,因为module.h一般包括kernel_version的定义,这是个全局变量,包含模块编译的内核 版本。如果你需要version.h,你需要把自己把他包含进去,因为如果有__NO_VERSION__的话module.h不会自动包含。
2.象通常相同编译源文件。
3.把所有目标文件联编成一个。在X86下,用ld ?m elf_i386 ?r ?o .o
printk
printk是内核空间中printf的替代品,其用法为:printk("format string", var)。n定义了日志等级,范围从0到7,其中0到4是紧急事件,5和6是普通信息,7为调试(例如SMP_DEBUG)。其他用户空间的函数也不能使 用;程式员在内核空间中能使用的函数都记录在/proc/ksyms中,也能使用ksyms -a命令查看。
注:在终端下insmod模块,printk信息送往终端
By the way, the reason why the Makefile recommends against doing insmod from X is because when the kernel has a message to print with printk, it sends it to the console. When you don use X, it just goes to the virtual terminal you e using (the one you chose with Alt-F) and you see it. When you do use X, on the other hand, there are two possibilities. Either you have a console open with xterm -C, in which case the output will be sent there, or you don , in which case the output will go to virtual terminal 7 -- the one `covered by X.
函数/变量和内核版本的关系
刚才我们说到 kernel 本身会 export 出一些 function 或 variable 来让 module 使用,不过,我们不是万能的,我们怎幺知道 kernel 有开放那里东西让我们使用呢 ? Linux 提供一个 command,叫 ksyms,你只要执行 ksyms -a 就能知道 kernel 或目前载到 kernel 里的 module 提供了那些 function 或 variable。底下是我的系统的情形:
c0216ba0 drive_info_R744aa133
c01e4a44 boot_cpu_data_R660bd466
c01e4ac0 EISA_bus_R7413793a
c01e4ac4 MCA_bus_Rf48a2c4c
c010cc34 __verify_write_R203afbeb
. . . . .
在 kernel 里,有一个 symbol table 是用来记录 export 出去的 function 或 variable。除此之外,也会记录着那个 module export 那些 function。上面几行中,表示 kernel 提供了 drive_info 这个 function/variable。所以,我们能在 kernel 里直接使用他,等载到 kernel 里时,会自动做好 link 的动作。由此,我们能知道,module 本身其实是还没做 link 的一些 object code。一切都要等到 module 被加载 kernel 之后,link 才会完成。各位应该能看到 drive_info 后面还接着一些奇怪的字符串。_R744aa133,这个字符串是根据目前 kernel 的版本再做些 encode 得出来的结果。为什幺额外需要这一个字符串呢 ?
Linux 不知道从那个版本以来,就多了一个 config 的选项,叫做 Set version number in symbols of module。这是为了避免对系统造成不稳定。我们知道 Linux 的 kernel 更新的非常快。在 kernel 更新的过程,有时为了效率起见,会对某些旧有的 data structure 或 function 做些改动,而且一变可能有的 variable 被拿掉,有的 function 的 prototype 跟原来的都不太相同。如果这种情形发生的时候,那可能以前 2.0.33 版本的 module 拿到 2.2.1 版本的 kernel 使用,假设原来 module 使用了 2.0.33 kernel 提供的变量叫 A,不过到了 2.2.1 由于某些原因必须把 A 都设成 NULL。那当此 module 用在 2.2.1 kernel 上时,如果他没去检查 A 的值就直接使用的话,就会造成系统的错误。也许不会整个系统都死掉,不过这个 module 肯定是非常难发挥他的功能。为了这个原因,Linux 就在 compile module 时,把 kernel 版本的号码 encode 到各个 exported function 和 variable 里。
所以,刚才也许我们不应该讲 kernel 提供了 drive_info,而应该说 kernel 提供了 driver_info_R744aa133 来让我们使用。这样也许各位会比较明白。也就是说,kernel 认为他提供的 driver_info_R744aa133 这个东西,而不是 driver_info。所以,我们能发现有的人在加载 module 时,系统都一直告诉你某个 function 无法 resolved。这就是因为 kernel 里没有你要的 function,要不然就是你的 module 里使用的 function 跟 kernel encode 的结果不相同。所以无法 resolve。解决方式,要嘛就是将 kernel 里的 set version 选项关掉,要嘛就是将 module compile 成 kernel 有办法接受的型式。
那有人就会想说,如果 kernel 认定他提供的 function 名字叫做 driver_info_R744aa133 的话,那我们写程式时,是不是用到这个 funnction 的地方都改成 driver_info_R744aa133 就能了。答案是 Yes。不过,如果每个 function 都要你这样写,你不会觉得非常烦吗 ? 比方说,我们在写 driver 时,非常多人都会用到 printk 这个 function。这是 kernel 所提供的 function。他的功能跟 printf 非常像。用法也几乎都相同。是 debug 时非常好用的东西。如果我们 module 里用了一百次 printk,那是不是我们也要打一百次的 printk_Rdd132261 呢 ? 当然不是,聪明的人马上会想到用 #define printk printk_Rdd132261 就好了嘛。所以?,Linux 非常体贴的帮我们做了这件事。
如果各位的系统有将set version的选项打开的话,那大家能到/usr/src/linux/include/linux/modules这个目录底下。这个目录底下有所多 的..ver档案。这些档案其实就是用来做#define用的。我们来看看ksyms.ver 这个档案里,里面有一行是这样子的 :
#define printk _set_ver(printk)
set_ver是个macro,就是用来在printk后面加上version number的。有兴趣的朋友能自行去观看这个macro的写法。用了这些ver?,我们就能在module里直接使用printk这样的名字了。而这些 ver档会自动帮我们做好#define的动作。可是,我们能发现这个目录有非常多非常多的ver?。有时候,我们怎幺知道我们要呼叫的function 是在那个ver档里有定义呢?Linux又帮我们做了一件事。/usr/src/linux/include/linux/modversions.h这 个档案已将全部的ver档都加进来了。所以在我们的module里只要include这个档,那名字的问题都解决了。不过,在此,我们奉劝各位一件事,不 要将modversions.h这个档在module里include进来,如果真的要,那也要加上以下数行:
#ifdef MODVERSIONS
#include linux/modversions.h
#endif
加入这三行的原因是,避免这个 module 在没有设定 kernel version 的系统上,将 modversions.h 这个档案 include 进来。各位能去试试看,当你把 set version 的选项关掉时,modversions.h 和 modules 这个目录都会不见。如果没有上面三行,那 compile 就不会过关。所以一般来讲,modversions.h 我们会选择在 compile 时传给 gcc 使用。就像下面这个样子。
gcc -c -D__KERNEL__ -DMODULE -DMODVERSIONS main.c
-include usr/src/linux/include/linux/modversions.h
在这个 command line 里,我们看到了 -D__KERNEL__,这是说要定义 __KERNEL__ 这个 constant。非常多跟 kernel 有关的 header file,都必须要定义这个 constant 才能 include 的。所以建议你最佳将他定义起来。另外更有一个 -DMODVERSIONS。这个 constant 我刚才忘了讲。刚才我们说要解决 fucntion 或 variable 名字 encode 的方式就是要 include modversions.h,其实除此之外,你还必须定义 MODVERSIONS 这个 constant。再来就是 MODULE 这个 constant。其实,只要是你要写 module 就一定要定义这个变量。而且你还要 include module.h 这个档案,因为 _set_ver 就是定义在这里的。
讲到这里,相信各位应该对 module 有一些认识了,以后遇见 module unresolved 应该不会感到困惑了,应该也有办法解决了。
变量/函数的导出(export)
刚才讲的都是使用别人的 function 上遇见的名字 encode 问题。不过,如果我们自己的 module 想要 export 一些东西让别的 module 使用呢。非常简单。在 default 上,在你的 module 里所有的 global variable 和 function 都会被认定为你要 export 出去的。所以,如果你的 module 里有 10 个 global variable,经由 ksyms,你能发现这十个 variable 都会被 export 出去。这当然是个非常方便的事啦,不过,你知道,有时候我们根本不想把所有的 variable 都 export 出去,万一有个 module 没事乱改我们的 variable 怎幺办呢 ? 所以,在非常多时候,我们都只会限定几个必要的东西 export 出去。在 2.2.1 之前的 kernel (不是非常确定) 能利用 register_symtab 来帮我们。不过,目前更新的版本早就出来了。所以,在此,我会介绍 kernel 2.2.1 里所提供的。kernel 2.2.1 里提供了一个 macro,叫做 EXPORT_SYMBOL,这是用来帮我们选择要 export 的 variable 或 function。比方说,我要 export 一个叫 full 的 variable,那我只要在 module 里写:
EXPORT_SYMBOL(full);
就会自动将 full export 出去,你马上就能从 ksyms 里发现有 full 这个变量被 export 出去。在使用 EXPORT_SYMBOL 之前,要小心一件事,就是必须在 gcc 里定义 EXPORT_SYMTAB 这个 constant,否则在 compile 时会发生 parser error。所以,要使用 EXPORT_SYMBOL 的话,那 gcc 应该要下:
gcc -c -D__KERNEL__ -DMODULE -DMODVERSIONS -DEXPORT_SYMTAB
main.c -include /usr/src/linux/include/linux/modversions.h
如果我们不想 export 所有的东西,那我们只要在 module 里下
EXPORT_NO_SYMBOLS;
就能了。使用 EXPORT_NO_SYMBOLS 用不着定义所有的 constant。其实,如果各位使用过旧版的 register_symbol 的话,一定会觉得新版的方式比较好用。至少我是这样觉得啦。因为使用 register_symbol 还要先定义出自己的 symbol_table,感觉有点麻烦。
当我们使用 EXPORT_SYMBOL 把一些 function 或 variable export 出来之后,我们使用 ksyma -a 去看一些结果。我们发现 EXPORT_SYMBOL(full) 的确是把 full export出来了 :
c8822200 full [my_module]
c01b8e08 pci_find_slot_R454463b5
. . .
不过,结果怎幺跟我们想象中的不太相同,照理说,应该是 full_Rxxxxxx 之类的东西才对啊,怎幺才出现 full 而已呢 ? 奇怪,问题在那里呢 ?
其实,问题就在于我们没有对本身的 module 所 export 出来的 function 或 variable 的名字做 encode。想想,如果在 module 的开头。我们加入一行
#define full full_Rxxxxxx
之后,我们再重新 compile module 一次,载到 kernel 之后,就能发现 ksyms -a 显示的是
c8822200 full_Rxxxxxx [my_module]
c01b8e08 pci_find_slot_R454463b5
. . . . .
了。那是不是说,我们要去对每一个 export 出来的 variable 和 function 做 define 的动作呢 ? 当然不是?。记得吗,前头我们讲去使用 kernel export 的 function 时,由于 include 了一些 .ver 的档案,以致于我们不用再做 define 的动作。目前,我们也要利用 .ver 的档案来帮我们,使我们 module export 出来的 function 也能自动加入 kernel version 的 information。也就是变成 full_Rxxxxxx 之类的东西。
Linux 里提供了一个 command,叫 genksyms,就是用来帮我们产生这种 .ver 的档案的。他会从 stdin 里读取 source code,然后检查 source code 里是否有 export 的 variable 或 function。如果有,他就会自动为每个 export 出来的东西产生一些 define。这些 define 就是我们之前说的。等我们有了这些 define 之后,只要在我们的 module 里加入这些 define,那 export 出来的 function 或 variable 就会变成上面那个样子。
假设我们的程式都放在一个叫 main.c 的档案里,我们能使用下列的方式产生这些 define。
gcc -E -D__GENKSYMS__ main.c | genksyms -k 2.2.1 > main.ver
gcc 的 -E 参数是指将 preprocessing 的结果 show 出来。也就是说将他 include 的档案,一些 define 的结果都展开。-D__GENKSYMS__ 是一定要的。如果没有定义这个 constant,你将不会看到所有的结果。用一个管线是因为 genksyms 是从 stdin 读资料的,所以,经由管线将 gcc 的结果传给 genksyms。-k 2.2.1 是指目前使用的 kernel 版本是 2.2.1,如果你的 kernel 版本不相同,必须指定你的 kernel 的版本。产生的 define 将会被放到 main.ver 里。产生完 main.ver 档之后,在 main.c 里将他 include 进来,那一切就 OK 了。有件事要告诉各位的是,使用这个方式产生的 module,其 export 出来的东西会经由 main.ver 的 define 改头换面。所以如果你要让别人使用,那你必须将 main.ver 公开,不然,别人就没办法使用你 export 出来的东西了。
内核模块和系统的交互
/proc和设备驱动程式是内核和系统进行交互的两种方式。
/proc
/proc的使用:
defined in /kerneltree/include/linux/proc_fs.h
2.4.0:
struct proc_dir_entry {
unsigned short low_ino;
unsigned short namelen;
const char *name;
mode_t mode;
nlink_t nlink;
uid_t uid;
gid_t gid;
unsigned long size;
struct inode_operations * proc_iops;
struct file_operations * proc_fops;
get_info_t *get_info;
struct module *owner;
struct proc_dir_entry *next, *parent, *subdir;
void *data;
read_proc_t *read_proc;
write_proc_t *write_proc;
atomic_t count; /* use count */
int deleted; /* delete flag */
kdev_t rdev;
};
extern struct proc_dir_entry *proc_sys_root;
#ifdef CONFIG_SYSCTL
EXPORT_SYMBOL(proc_sys_root);
#endif
EXPORT_SYMBOL(proc_symlink);
EXPORT_SYMBOL(proc_mknod);
EXPORT_SYMBOL(proc_mkdir);
EXPORT_SYMBOL(create_proc_entry);
EXPORT_SYMBOL(remove_proc_entry);
EXPORT_SYMBOL(proc_root);
EXPORT_SYMBOL(proc_root_fs);
EXPORT_SYMBOL(proc_net);
EXPORT_SYMBOL(proc_bus);
EXPORT_SYMBOL(proc_root_driver);
2.2.18
struct proc_dir_entry {
unsigned short low_ino;
unsigned short namelen;
const char *name;
mode_t mode;
nlink_t nlink;
uid_t uid;
gid_t gid;
unsigned long size;
struct inode_operations * ops;
int (*get_info)(char *, char **, off_t, int, int);
void (*fill_inode)(struct inode *, int);
struct proc_dir_entry *next, *parent, *subdir;
void *data;
int (*read_proc)(char *page, char **start, off_t off,
int count, int *eof, void *data);
int (*write_proc)(struct file *file, const char *buffer,
unsigned long count, void *data);
int (*readlink_proc)(struct proc_dir_entry *de, char *page);
unsigned int count; /* use count */
int deleted; /* delete flag */
};
#ifdef CONFIG_SYSCTL
EXPORT_SYMBOL(proc_sys_root);
#endif
EXPORT_SYMBOL(proc_register);
EXPORT_SYMBOL(proc_unregister);
EXPORT_SYMBOL(create_proc_entry);
EXPORT_SYMBOL(remove_proc_entry);
EXPORT_SYMBOL(proc_root);
EXPORT_SYMBOL(proc_root_fs);
EXPORT_SYMBOL(proc_get_inode);
EXPORT_SYMBOL(proc_dir_inode_operations);
EXPORT_SYMBOL(proc_net_inode_operations);
EXPORT_SYMBOL(proc_net);
EXPORT_SYMBOL(proc_bus);
example:
struct proc_dir_entry Our_Proc_File =
{
0, /* Inode number - ignore, it will be filled by
* proc_register[_dynamic] */
4, /* Length of the file name */
"test", /* The file name */
S_IFREG | S_IRUGO, /* File mode - this is a regular
* file which can be read by its
* owner, its group, and everybody
* else */
1, /* Number of links (directories where the
* file is referenced) */
0, 0, /* The uid and gid for the file - we give it
* to root */
80, /* The size of the file reported by ls. */
NULL, /* functions which can be done on the inode
* (linking, removing, etc.) - we don
* support any. */
procfile_read, /* The read function for this file,
* the function called when somebody
* tries to read something from it. */
NULL /* We could have here a function to fill the
* files inode, to enable us to play with
* permissions, ownership, etc. */
};
使用:
2.2.* & 2.0.*
#if LINUX_VERSION_CODE > KERNEL_VERSION(2,2,0)
/* In version 2.2, proc_register assign a dynamic
* inode number automatically if it is zero in the
* structure , so theres no more need for
* proc_register_dynamic
*/
return proc_register(&proc_root, &Our_Proc_File);
#else
return proc_register_dynamic(&proc_root, &Our_Proc_File);
#endif
proc_unregister(&proc_root, Our_Proc_File.low_ino);
2.4.*
#ifndef _LINUX_SYSCTL_H
#define _LINUX_SYSCTL_H
#include
#include
#include
/* A sysctl table is an array of struct ctl_table: */
struct ctl_table
{
int ctl_name; /* Binary ID */
const char *procname; /* Text ID for /proc/sys, or zero */
void *data;
int maxlen;
mode_t mode;
ctl_table *child;
proc_handler *proc_handler; /* Callback for text formatting */
ctl_handler *strategy; /* Callback function for all r/w */
struct proc_dir_entry *de; /* /proc control block */
void *extra1;
void *extra2;
};
/* struct ctl_table_header is used to maintain dynamic lists of
ctl_table trees. */
struct ctl_table_header
{
ctl_table *ctl_table;
struct list_head ctl_entry;
};
struct ctl_table_header * register_sysctl_table(ctl_table * table,
int insert_at_head);
void unregister_sysctl_table(struct ctl_table_header * table);
例:
/kerneltree/net/khttpd/sysctl.c
1.#inlclude
2.对/kerneltree/inlcude/linux/sysctl.h进行修改
设备驱动程式
设备文件的使用:
/usr/include/linux/fs.h
struct file_operations {
loff_t (*llseek) (struct file *, loff_t, int);
ssize_t (*read) (struct file *, char *, size_t, loff_t *);
ssize_t (*write) (struct file *, const char *, size_t, loff_t *);
int (*readdir) (struct file *, void *, filldir_t);
unsigned int (*poll) (struct file *, struct poll_table_struct *);
int (*ioctl) (struct inode *, struct file *, unsigned int, unsigned long);
int (*mmap) (struct file *, struct vm_area_struct *);
int (*open) (struct inode *, struct file *);
int (*flush) (struct file *);
int (*release) (struct inode *, struct file *);
int (*fsync) (struct file *, struct dentry *);
int (*fasync) (int, struct file *, int);
int (*check_media_change) (kdev_t dev);
int (*revalidate) (kdev_t dev);
int (*lock) (struct file *, int, struct file_lock *);
};
重新定义相应的函数。
设备和系统的交互:
#include /* The character device
* definitions are here */
#include /* A wrapper which does
* next to nothing at
* at present, but may
* help for compatibility
* with future versions
* of Linux */
主码/从码
printk("Device: %d.%dn", inode->i_rdev >> 8, inode->i_rdev & 0xFF);
primary key secondery key
1. 字符设备
Major = module_register_chrdev(0,
DEVICE_NAME,
&Fops);
ret = module_unregister_chrdev(Major, DEVICE_NAME);
2. 块设备
Major = module_register_blkdev(0,
DEVICE_NAME,
&Fops);
ret = module_unregister_blkdev(Major, DEVICE_NAME);
/defined in &
系统调用
和模块有关的系统调用
sys_create_module()
sys_init_module()
sys_delete_module()
sys_get_kernel_syms()
get_module_list()
get_ksyms_list()
sys_query_module()
int request_module (const char *name);
int release_module (const char* name, int waitflag);
int delayed_release_module (const char *name);
int cancel_release_module (const char *name);
系统调用原型:
syscalln(rettype, name, type1, parm1,……)
#include
系统调用的使用:
1. 系统调用表
#include
asmlinkage int (*original_call)(const char *, int, int);
asmlinkage int our_sys_open(const char *filename,
int flags,
int mode)
original_call = sys_call_table[__NR_open];
sys_call_table[__NR_open] = our_sys_open;
if (sys_call_table[__NR_open] != our_sys_open) {
printk("Somebody else also played with the ");
printk("open system calln");
printk("The system may be left in ");
printk("an unstable state.n");
}
sys_call_table[__NR_open] = original_call;
2. syscalln
static inline _syscall1(int, brk, void *, end_data_segment);
...
int ret, tmp;
char *truc = OLDEXEC;
char *nouveau = NEWEXEC;
unsigned long mmm;
mmm = current->mm->brk; /*定位当前进程数据段大小*/
ret = brk((void ) (mmm + 256)); /*利用系统调用brk为当前进程增加内存256个字节*/
if (ret = 0)
return (type) __res;
errno = -__res;
return -1;
}
.................
end