2.7. 初始化与关停.pdfVIP

2.7. 初始化和关停 2.7. 初始化和关停 如已提到的, 模块初始化函数注册模块提供的任何功能. 这些功能, 我们指的是新功能, 可以由应⽤ 序存取的或者⼀整个驱动或者⼀个新软件抽象. 实际的初始化函数定义 常常如: static int __init initialization_function(void) { /* Initialization code here */ } module_init(initialization_function); 初始化函数应当声明成静态的, 因为它们不会在特定⽂件之外可见; 没有硬性规定这个, 然⽽, 因为没有函数能输出给内核其他部分, 除⾮明确请求. 声明中的 init 标志可能看 起来有点怪; 它是⼀个给内核的暗⽰, 给定的函数只是在初始化 ⽤. 模块加载者在模 块加载后会丢掉这个初始化函数, 它的内存可做其他⽤途. ⼀个类似的标签 (initdata) 给只在初始化时⽤的数据. 使⽤ init 和 initdata 是可选的, 但是它带来的⿇烦是值得的. 只是要确认不要⽤在那些在初始化完成后还使⽤的函数(或者数据结构)上. 你可能还会 遇到 devinit 和 devinitdata 在内核源码⾥; 这些只在内核没有配置⽀持 hotplug 设备时 转换成 __init 和 _initdata. 我们会在 14 章谈论 hotplug ⽀持. 使⽤ moudle_init 是强制的. 这个宏定义增加了特别的段到模块⽬标代码中, 表明在哪⾥ 找到模块的初始化函数. 没有这个定义, 你的初始化函数不会被调⽤. 模块可以注册许多的不同设施, 包括不同类型的设备, ⽂件系统, 加密转换, 以及更多. 对每⼀个设施, 有⼀个特定的内核函数来完成这个注册. 传给内核注册函数的参数常常 是⼀些数据结构的指针, 描述新设施以及要注册的新设施的名⼦. 数据结构常常包含模 块函数指针, 模块中的函数就是这样被调⽤的. 能够注册的项⽬远远超出第 1 章中提到的设备类型列表. 它们包括, 其他的, 串⼜, 多样 设备, sysfs ⼊⼜, /proc ⽂件, 执⾏域, 链路规 . 这些可注册项的⼤部分都⽀持不直接和 硬件相关的函数, 但是处于软件抽象区域⾥. 这些项可以注册, 是因为它们以各种⽅式 (例如象 /proc ⽂件和链路规 )集成在驱动的功能中. 对某些驱动有其他的设施可以注册作为补充, 但它们的使⽤太特别, 所以不值得讨论它 们. 它们使⽤堆叠技术, 在内核符号表⼀节中讲过. 如果你想深⼊探求, 你可以在内核 源码⾥查找 XPORTSYMBOL , 找到由不同驱动提供的⼊⼜点. ⼤部分注册函数以 register 做前缀, 因此找到它们的另外⼀个⽅法是在内核源码⾥查找 register_ . 2.7.1. 清理函数 每个⾮试验性的模块也要求有⼀个清理函数, 它注销接⼜, 在模块被去除之前返回所有 资源给系统. 这个函数定义为: static void __exit cleanup_function(void) { /* Cleanup code here */ } module_exit(cleanup_function); 清理函数没有返回值, 因此它被声明为 void . exit 修饰符标识这个代码是只⽤于模块卸 载( 通过 编译器把它放在特殊的 ELF 段). 如果你的模块直接建⽴在内核⾥, 或者如 果你的内核配置成不允许模块卸载, 标识为 exit 的函数被简单地丢弃. 因为这个原因, ⼀个标识 __exit 的函数只在模块卸载或者系统停⽌时调⽤; 任何别的使⽤是错的. 再⼀ 次, moudle_exit 声明对于使得内核能够找到你的清理函数是必要的. 如果你的模块没有定义⼀个清理函数, 内核不会允许它被卸载. 2.7.2. 初始化中的错误处理 你必须记住⼀件事, 在注册内核设施时, 注册可能失败. 即便最简单的动作常常需要内 存分配, 分配的内存可能不可⽤. 因此模块代码必须⼀直检查返回值, 并且确认要求的 操作实际上已经成功. 如果在你注册⼯具时发⽣任何错误, ⾸先第⼀的事情是决定模块是否能够⽆论如何继 续初始化它⾃⼰. 常常, 在⼀个注册失败后模块可以继续操作, 如果需要可以功能降级. 在任何可能的时候, 你的模块应当尽⼒向前, 并提供事情失败后具备的能⼒. 如果证实你的模块在⼀个特别类型的失败后完全不能加载, 你必须取消任何在