1. 驱动程序的基本函数
类别 |
函数名 |
功能 |
函数形成 |
参数 |
描述 |
驱动程序入口和出口点 |
module_init |
驱动程序初始化入口点 |
module_init ( x) |
x为启动时或插入模块时要运行的函数 |
如果在启动时就确认把这个驱动程序 插入内核或以静态形成链接,则module_init 将其初始化例程加入到"__initcall.int"代码段,否则将用init_module封装其初始化例程,以便该驱动程序作为模块来使用。 |
module_exit |
驱动程序退出出口点 |
module_exit ( x) |
x为驱动程序被卸载时要运行的函数 |
当驱动程序是一个模块,用rmmod卸载一个模块时module_exit()将用cleanup_module()封装clean-up代码。如果驱动程序是静态地链接进内核,则module_exit()函数不起任何作用。 |
|
原子和指针操作 |
atomic_read |
读取原子变量 |
atomic_read ( v) |
v为指向atomic_t类型的指针 |
原子地读取v的值。注意要保证atomic的有用范围只有24位。 |
atomic_set |
设置原子变量 |
atomic_set ( v, i) |
v为指向atomic_t类型的指针,i为待设置的值 |
原子地把v的值设置为i。注意要保证atomic的有用范围只有24位。 |
|
atomic_add |
把整数增加到原子变量 |
void atomic_add (int i, atomic_t * v) |
i为要增加的值,v为指向atomic_t类型的指针。 |
原子地把i 增加到v。注意要保证atomic的有用范围只有24位。 |
|
atomic_sub |
减原子变量的值 |
void atomic_sub (int i, atomic_t * v) |
i为要减取的值,v为指向atomic_t类型的指针。 |
原子地从v减取i。注意要保证atomic的有用范围只有24位。 |
|
atomic_sub_and_test |
从变量中减去值,并测试结果 |
int atomic_sub_and_test (int i, atomic_t * v) |
i为要减取的值,v为指向atomic_t类型的指针。 |
原子地从v减取i的值,如果结果为0,则返回真,其他所有情况都返回假。注意要保证atomic的有用范围只有24位。 |
|
atomic_inc |
增加原子变量的值 |
void atomic_inc (atomic_t * v) |
v为指向atomic_t类型的指针。 |
原子地从v减取1。注意要保证atomic的有用范围只有24位。 |
|
atomic_dec |
减取原子变量的值 |
void atomic_dec (atomic_t * v) |
v为指向atomic_t类型的指针。 |
原子地给v增加1。注意要保证atomic的有用范围只有24位。 |
|
atomic_dec_and_test |
减少和测试 |
int atomic_dec_and_test (atomic_t * v) |
v为指向atomic_t类型的指针。 |
原子地给v减取1,如果结果为0,则返回真,其他所有情况都返回假。注意要保证atomic的有用范围只有24位。 |
|
atomic_inc_and_test |
增加和测试 |
int atomic_ inc _and_test (atomic_t * v) |
v为指向atomic_t类型的指针。 |
原子地给v增加1,如果结果为0,则返回真,其他所有情况都返回假。注意要保证atomic的有用范围只有24位。 |
|
atomic_add_negative |
如果结果为负数,增加并测试 |
int atomic_add_negative (int i, atomic_t * v) |
i为要减取的值,v为指向atomic_t类型的指针。 |
原子地给v增加i,如果结果为负数,则返回真,如果结果大于等于0,则返回假。注意要保证atomic的有用范围只有24位。 |
|
et_unaligned |
从非对齐位置获取值 |
get_unaligned ( ptr) |
ptr指向获取的值 |
这个宏应该用来访问大于单个字节的值,该值所处的位置不在按字节对齐的位置,例如从非u16对齐的位置检索一个u16的值。注意,在某些体系结构中,非对齐访问要化费较高的代价。 |
|
put_unaligned |
把值放在一个非对齐位置 |
put_unaligned ( val, ptr) |
val为要放置的值,ptr指向要放置的位置 |
这个宏用来把大于单个字节的值放置在不按字节对齐的位置,例如把一个u16值写到一个非u16对齐的位置。注意事项同上。 |
|
延时、调度及定时器例程 |
schedule_timeout |
睡眠到定时时间到 |
signed long schedule_timeout (signed long timeout) |
timeout为以jiffies为单位的到期时间 |
使当前进程睡眠,直到所设定的时间到期。如果当前进程的状态没有进行专门的设置,则睡眠时间一到该例程就立即返回。如果当前进程的状态设置为: TASK_UNINTERRUPTIBLE:则睡眠到期该例程返回0 TASK_INTERRUPTIBLE:如果当前进程接收到一个信号,则该例程就返回,返回值取决于剩余到期时间。 当该例程返回时,要确保当前进程处于TASK_RUNNING状态。 |