函数语法快速参考（构造和运行模块、字符设备驱动程序）

构造和运行模块

insmod
modprobe
rmmod
用来装载到正运行的内核和移除模块的用户空间工具。

__init
__initdata
__exit
__exitdata
仅用于模块初始化或者清除阶段的函数(__init和__exit)和数据(__initdata和__exitdata)标记。标记为初始化的项目会在初始化结束之后丢弃；而退出项目在内核未被配置为可卸载模块的情况下被丢弃。内核通过将相遇的目标对象放置在可执行文件的特殊ELF段中而让这些标记起作用。

#include <linux/sched.h>
最重要的头文件之一。改文件包含了驱动程序使用的大部分内核API定义，包括睡眠函数以及各种变量的声明。

struct task_struct *current; 当前进程。
current->pid 当前的进程ID。
currend->comm 命令名。

obj-m
由内核构造系统使用的makefile符号。用来确定在当前目录中应该构造哪些模块。

/sys/module 是sysfs目录层次结构中包含当前已装载模块信息的目录。
/proc/modules 是早期用法，只在单个文件中包含这些信息，其中包含了模块名称、每个模块使用的内存总量以及使用计数等。每一行之后还有追加额外的字符串，用来指定模块当前的活动标志。

vermagic.o
内核源代码目录中的一个目标文件，它描述了模块的构造环境。

#include <linux/module.h>
必须的头文件，它必须包含在模块源码中。

#include <linux/verison.h>
包含所构造内核版本信息的头文件。

LINUX_VERISON_CODE
整数宏，在处理版本依赖的预处理条件语句中非常有用。

EXPORT_SYMBOL(symbol);
EXPORT_SYMBOL_GPL(symbol);
用来导出单个符号到内核的宏。第二个宏导出的符号的使用限于GPL许可证下的模块。

MODULE_AUTHOR(author);
MODULE_DESCRIPTION(description);
MODULE_VERISON(version_string)
MODULE_DEVICE_TABLE(table_info);
MODULE_ALIAS(alternate_name);
添加模块的相关文档信息。

module_init(init_function);
module_exit(exit_function);
用来声明模块初始化和清除函数的宏。

#include <linux/moduleparam.h>
module_param(variable, type, perm)
用来创建模块参数的宏，用户可以在装载模块的时候（或者对内建代码引导的时候）调整这些参数的值。其中的类型可以是bool、charp、init、invbool、long、short、ushort、uint、ulong、intarray。

#include <linux/kernel.h>
int printk(const char** ***fmt, ...); 内核打印函数。
 

字符设备驱动程序

#include <linux/types.h>
dev_t：内核中用来表示设备编号的数据类型
int MAJOR(dev_t dev);抽取主设备号
int MINOR(dev_t dev);抽取次设备号
dev_t MKDEV(unsigned int major, unsigned int minor);由主次设备号构造一个dev_t数据

#include <linux/fs.h>
“文件系统”头文件，它是编写设备驱动程序必须的头文件，其中声明了很多重要的函数和数据结构

int register_chrdev_region(dev_t first, unsigned int count, char *name); 静态分配
int alloc_chrdev_region(dev_t *dev, unsigned int firstminor, unsigned int count, char *name); 动态分配
void unregister_chrdev_region(dev_t first, unsigned int count);
提供给驱动程序用来分配和释放设备编号的函数。

int register_chrdev(unsigned int major, const char *name, struct file_operations *fops);
原来的（2.6之前的）字符设备注册函数

int unregister_chrdev(unsigned int major, const char *name);
用于注销register_chrdev函数注册的驱动程序。major和name必须和register_chrdev一致

struct file_operations;
struct file;
struct inode;
三个重要的数据结构。file_operations结构保存了字符驱动程序的方法；struct file表示一个打开的文件；struct inode表示一个磁盘上的文件

#include <linux/cdev.h>
struct cdev *cdev_alloc(void);
void cdev_init(struct cdev *dev, struct file_operations *fops); 初始化设备
int cdev_add(struct cdev *dev, dev_t num, unsigned int count); 添加设备
void cdev_del(struct cdev *dev); 移除设备
用来管理cdev结构的函数，内核中使用cdev结构表示字符设备

#include <linux/kernel.h>
container_of(pointer, type, field);
一个方便使用的宏，它可用于从包含在某个结构中的指针来获得结构本身的指针

#include <asm/uaccess.h>
#include <linux/uaccess.h>
该头文件声明了在内核代码和用户空间之间移动数据的函数
unsigned long copy_from_user(void *to, const void *from, unsigned long count); 从用户空间拷贝
unsigned long copy_to_user(void *to, const void *from, unsigned long count); 拷贝到用户空间
在用户空间和内核空间之间拷贝数据，返回值为未拷贝的字节数