2.4 kernel API

 

 

 

内核源码学习：Linux 2.4内核API（一）

2008-09-18 14:10

驱动程序的基本函数 类别 函数名 功能 函数形成 参数 描述 驱动程序入口和出口点 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状态。

 

内核源码学习：Linux 2.4内核API（二）

2008-09-18 14:11

双向循环链表的操作 函数名 功能 函数形成 参数 描述 list_add 增加一个新元素 void list_add (struct list_head * new, struct list_head * head) new为要增加的新元素，head为增加以后的链表头 在指定的头元素后插入一个新元素，用于栈的操作。 list_add_tail 增加一个新元素 void list_add_tail (struct list_head * new, struct list_head * head); new为要增加的新元素，head为增加以前的链表头 在指定的头元素之前插入一个新元素，用于队列的操作。 list_del 从链表中删除一个元素 void list_del (struct list_head * entry); entry为要从链表中删除的元素   list_del_init 从链表删除一个元素，并重新初始化链表 void list_del_init (struct list_head * entry) entry为要从链表中删除的元素   list_empty 测试一个链表是否为空 int list_empty (struct list_head * head) head为要测试的链表   list_splice 把两个链表合并在一起 void list_splice (struct list_head * list, struct list_head * head) list为新加入的链表，head为第一个链表   list_entry 获得链表中元素的结构 list_entry ( ptr, type, member) ptr为指向list_head的指针，type为一个结构体，而member为结构type中的一个域，其类型为list_head。   list_for_each 扫描链表 list_for_each ( pos, head) pos为指向list_head的指针，用于循环计数，head为链表头。

 

内核源码学习：Linux 2.4内核API（三）

2008-09-18 14:18

基本C库函数 当编写驱动程序时，一般情况下不能使用C标准库的函数。Linux内核也提供了与标准库函数功能相同的一些函数，但二者还是稍有差别。 类别 函数名 功能 函数形成 参数 描述 字符串转换 simple_strtol 把一个字符串转换为一个有符号长整数 long simple_strtol (const char * cp, char ** endp, unsigned int base) cp指向字符串的开始，endp为指向要分析的字符串末尾处的位置，base为要用的基数。   simple_strtoll 把一个字符串转换为一个有符号长长整数 long long simple_strtoll (const char * cp, char ** endp, unsigned int base) cp指向字符串的开始，endp为指向要分析的字符串末尾处的位置，base为要用的基数。   simple_strtoul 把一个字符串转换为一个无符号长整数 long long simple_strtoul (const char * cp, char ** endp, unsigned int base) cp指向字符串的开始，endp为指向要分析的字符串末尾处的位置，base为要用的基数。   simple_strtoull 把一个字符串转换为一个无符号长长整数 long long simple_strtoull (const char * cp, char ** endp, unsigned int base) cp指向字符串的开始，endp为指向要分析的字符串末尾处的位置，base为要用的基数。   vsnprintf 格式化一个字符串，并把它放在缓存中。 int vsnprintf (char * buf, size_t size, const char * fmt, va_list args) buf为存放结果的缓冲区, size为缓冲区的大小，fmt为要使用的格式化字符串，args为格式化字符串的参数。   snprintf 格式化一个字符串，并把它放在缓存中。 int snprintf (char * buf, size_t size, const char * fmt, ... ...) buf为存放结果的缓冲区, size为缓冲区的大小，fmt为格式化字符串，使用@…来对格式化字符串进行格式化，…为可变参数。   vsprintf 格式化一个字符串，并把它放在缓存中。 int vsprintf (char * buf, const char * fmt, va_list args) buf为存放结果的缓冲区, size为缓冲区的大小，fmt为要使用的格式化字符串，args为格式化字符串的参数。   sprintf 格式化一个字符串，并把它放在缓存中。 int sprintf (char * buf, const char * fmt, ... ...) buf为存放结果的缓冲区, size为缓冲区的大小，fmt为格式化字符串，使用@…来对格式化字符串进行格式化，…为可变参数。

 

 

内核源码学习：Linux 2.4内核API（四）

2008-09-18 14:19

符串操作 strcpy 拷贝一个以NUL结束的字符串 char * strcpy (char * dest, const char * src) dest为目的字符串的位置, src为源字符串的位置。   strncpy 拷贝一个定长的、以NUL结束的字符串 char * strncpy (char * dest, const char * src, size_t count) dest为目的字符串的位置, src为源字符串的位置，count为要拷贝的最大字节数 与用户空间的strncpy不同，这个函数并不用NUL填充缓冲区，如果与源串超过count，则结果以非NUL结束 strcat 把一个以NUL结束的字符串添加到另一个串的末尾 char * strcat (char * dest, const char * src) dest为要添加的字符串, src为源字符串。   strncat 把一个定长的、以NUL结束的字符串添加到另一个串的末尾 char * strncat (char * dest, const char * src, size_t count) dest为要添加的字符串, src为源字符串，count为要拷贝的最大字节数 注意，与strncpy,形成对照， strncat正常结束。 strchr 在一个字符串中查找第一次出现的某个字符 char * strchr (const char * s, int c) s为被搜索的字符串，c为待搜索的字符。   strrchr 在一个字符串中查找最后一次出现的某个字符 char * strrchr (const char * s, int c) s为被搜索的字符串，c为待搜索的字符。   strlen 给出一个字符串的长度 size_t strlen (const char * s) s为给定的字符串   strnlen 给出给定长度字符串的长度 size_t strnlen (const char * s, size_t count) s为给定的字符串   strpbrk 在一个字符串中查找第一次出现的一组字符 char * strpbrk (const char * cs, const char * ct) cs为被搜索的字符串，ct为待搜索的一组字符   strtok 把一个字符串分割为子串 char * strtok (char * s, const char * ct) s为被搜索的字符串，ct为待搜索的子串 注意，一般不提倡用这个函数，而应当用strsep memset 用给定的值填充内存区 void * memset (void * s, int c, size_t count) s为指向内存区起始的指针，c为 要填充的内容，count为内存区的大小 I/O空间的访问不能使用memset，而应当使用memset_io。 bcopy 把内存的一个区域拷贝到另一个区域 char * bcopy (const char * src, char * dest, int count) src为源字符串，dest为目的字符串，而count为内存区的大小 注意，这个函数的功能与memcpy相同，这是从BSD遗留下来的，对I/O空间的访问应当用memcpy_toio或 memcpy_fromio memcpy 把内存的一个区域拷贝到另一个区域 void * memcpy (void * dest, const void * src, size_t count) dest为目的字符串，Src为源字符串，而count为内存区的大小 对I/O空间的访问应当用memcpy_toio或 memcpy_fromio memmove 把内存的一个区域拷贝到另一个区域 void * memmove (void * dest, const void * src, size_t count) dest为目的字符串，Src为源字符串，而count为内存区的大小 memcpy和memmove处理重叠的区域，而该函数不处理。 memcmp 比较内存的两个区域 int memcmp (const void * cs, const void * ct, size_t count) cs为一个内存区，ct为另一个内存区，而count为内存区的大小   memscan 在一个内存区中查找一个字符 void * memscan (void * addr, int c, size_t size) addr为内存区，c为要搜索的字符，而size为内存区的大小 返回c第一次出现的地址，如果没有找到c，则向该内存区传递一个字节。 strstr 在以NUL结束的串中查找第一个出现的子串 char * strstr (const char * s1, const char * s2) s1为被搜索的串，s2为待搜索的串。   memchr 在一个内存区中查找一个字符 void * memchr (const void * s, int c, size_t n) s为内存区，为待搜索的字符，n为内存的大小 返回c第一次出现的位置，如果没有找到c，则返回空。

 

内核源码学习：Linux 2.4内核API（五）

2008-09-18 14:21

位操作 set_bit 在位图中原子地设置某一位 void set_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址 这个函数是原子操作，如果不需要原子操作，则调用__set_bit函数，nr可以任意大，位图的大小不限于一个字。 __set_bit 在位图中设置某一位 void __set_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址   clear_bit 在位图中清某一位 void clear_bit (int nr, volatile void * addr) nr为要清的位，addr为位图的起始地址 该函数是原子操作，但不具有加锁功能，如果要用于加锁目的，应当调用smp_mb__before_clear_bit 或smp_mb__after_clear_bit函数，以确保任何改变在其他的处理器上是可见的。 __change_bit 在位图中改变某一位 void __change_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址。 与change_bit不同，该函数是非原子操作。 change_bit 在位图中改变某一位 void change_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址。   test_and_set_bit 设置某一位并返回该位原来的值 int test_and_set_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址。 该函数是原子操作 __test_and_set_bit 设置某一位并返回该位原来的值 int __test_and_set_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址。 该函数是非原子操作，如果这个操作的两个实例发生竞争，则一个成功而另一个失败，因此应当用一个锁来保护对某一位的多个访问。 test_and_clear_bit 清某一位，并返回原来的值 int test_and_clear_bit (int nr, volatile void * addr); nr为要设置的位，addr为位图的起始地址。 该函数是原子操作 __test_and_clear_bit 清某一位，并返回原来的值 int __test_and_clear_bit (int nr, volatile void * addr); nr为要设置的位，addr为位图的起始地址。 该函数为非原子操作 test_and_change_bit 改变某一位并返回该位的新值 int test_and_change_bit (int nr, volatile void * addr) nr为要设置的位，addr为位图的起始地址。 该函数为原子操作 test_bit 确定某位是否被设置 int test_bit (int nr, const volatile void * addr) nr为要测试的第几位，addr为位图的起始地址。   find_first_zero_bit 在内存区中查找第一个值为0的位 int find_first_zero_bit (void * addr, unsigned size) addr为内存区的起始地址，size为要查找的最大长度 返回第一个位为0的位号 find_next_zero_bit 在内存区中查找第一个值为0的位 int find_next_zero_bit (void * addr, int size, int offset) addr为内存区的起始地址，size为要查找的最大长度，offset开始搜索的起始位号。   ffz 在字中查找第一个0 unsigned long ffz (unsigned long word); word为要搜索的字。   ffs 查找第一个已设置的位 int ffs (int x) x为要搜索的字。 这个函数的定义方式与Libc中的一样。 hweight32 返回一个N位字的加权平衡值 hweight32 ( x) x为要加权的字 一个数的加权平衡是这个数所有位的总和。

 

 

内核源码学习：Linux 2.4内核API（六）

2008-09-18 14:22

Linux内存管理中Slab缓冲区 函数名 功能 函数形成 参数 描述 kmem_cache_create 创建一个缓冲区 kmem_cache_t * kmem_cache_create (const char * name, size_t size, size_t offset, unsigned long flags, void (*ctor) (void*, kmem_cache_t *, unsigned long), void (*dtor) (void*, kmem_cache_t *, unsigned long)); Name为在/proc/slabinfo中标识这个缓冲区的名字；size 为在这个缓冲区中创建对象的大小；offset为页中的位移量；flags为Slab标志；ctor 和dtor分别为构造和析构对象的函数。 成功则返回指向所创建缓冲区的指针，失败则返回空。不能在一个中断内调用该函数，但该函数的执行过程可以被中断。当通过该缓冲区分配新的页面时ctor运行，当页面被还回之前dtor运行。 kmem_cache_shrink 缩小一个缓冲区 int kmem_cache_shrink (kmem_cache_t * cachep) Cachep为要缩小的缓冲区 为缓冲区释放尽可能多的Slab。为了有助于调试，返回0意味着释放所有的Slab。 kmem_cache_destroy 删除一个缓冲区 int kmem_cache_destroy (kmem_cache_t * cachep); cachep为要删除的缓冲区 从Slab缓冲区删除kmem_cache_t 对象，成功则返回0。    这个函数应该在卸载模块时调用。调用者必须确保在kmem_cache_destroy执行期间没有其他对象再从该缓冲区分配内存。 kmem_cache_alloc 分配一个对象 void * kmem_cache_alloc (kmem_cache_t * cachep, int flags); cachep为要删除的缓冲区，flags请参见kmalloc() 从这个缓冲区分配一个对象。只有当该缓冲区没有可用对象时，才用到标志flags。 kmalloc 分配内存 void * kmalloc (size_t size, int flags) size为所请求内存的字节数，flags为要分配的内存类型 kmalloc 是在内核中分配内存常用的一个函数。flags 参数的取值如下： GFP_USER – 代表用户分配内存，可以睡眠。 GFP_KERNEL – 分配内核中的内存，可以睡眠 GFP_ATOMIC – 分配但不睡眠，在中断处理程序内部使用。 另外，设置GFP_DMA标志表示所分配的内存必须适合DMA，例如在i386平台上，就意味着必须从低16MB分配内存。 kmem_cache_free 释放一个对象 void kmem_cache_free (kmem_cache_t * cachep, void * objp) cachep为曾分配的缓冲区，objp为曾分配的对象。 释放一个从这个缓冲区中曾分配的对象 kfree 释放以前分配的内存 void kfree (const void * objp) objp为由kmalloc（）返回的指针

 

内核源码学习：Linux 2.4内核API（七）

2008-09-18 14:28

Linux中的VFS 类别 函数名 功能 函数形成 参数 描述 目录 项缓存 d_invalidate 使一个目录项无效 int d_invalidate (struct dentry * dentry) dentry为要无效的目录项 如果通过这个目录项能够到达其他的目录项，就不能删除这个目录项，并返回-EBUSY。如果该函数操作成功，则返回0。 d_find_alias 找到索引节点一个散列的别名 struct dentry * d_find_alias (struct inode * inode为要讨论的索引节点 如果 inode 有一个散列的别名，就获取对这个别名，并返回它，否则返回空。注意，如果inode 是一个目录，就只能有一个别名，如果它没有子目录，就不能进行散列。 prune_dcache 裁减目录项缓存 void prune_dcache (int count) count为要释放的目录项的一个域 缩小目录项缓存。当需要更多的内存，或者仅仅需要卸载某个安装点（在这个安装点上所有的目录项都不使用），则调用该函数。    如果所有的目录项都在使用，则该函数可能失败。 shrink_dcache_sb 为一个超级块而缩小目录项缓存 void shrink_dcache_sb (struct super_block * sb) sb为超级块 为一个指定的超级块缩小目录缓存。在卸载一个文件系统是调用该函数释放目录缓存。 have_submounts 检查父目录或子目录是否包含安装点 int have_submounts (struct dentry * parent) parent为要检查的目录项 如果parent或它的子目录包含一个安装点，则该函数返回真。 shrink_dcache_parent 裁减目录项缓存 void shrink_dcache_parent (struct dentry * parent) parent为要裁减目录项的父目录项 裁减目录项缓存以删除父目录项不用的子目录项。 d_alloc 分配一个目录项 struct dentry * d_alloc (struct dentry * parent, const struct qstr * name) parent为要分配目录项的父目录项，name为指向qstr结构的指针。 分配一个目录项。如果没有足够可用的内存，则返回NULL。成功则返回目录项。 d_instantiate 为一个目录项填充索引节点信息 void d_instantiate (struct dentry * entry, struct inode * inode) entry为要完成的目录项，inode为这个目录项的inode。 在目录项中填充索引节点的信息。注意，这假定 inode的 count域已由调用者增加，以表示inode正在由该目录项缓存使用。 d_alloc_root 分配根目录项 struct dentry * d_alloc_root (struct inode * root_inode) root_inode为要给根分配的inode。 为给定的inode分配一个根("/") 目录项，该in ode被实例化并返回。如果没有足够的内存或传递的inode参数为空，则返回空。 d_lookup 查找一个目录项 struct dentry * d_lookup (struct dentry * parent, struct qstr * name) parent为父目录项，name为要查找的目录项名字的qstr结构。 为name搜索父目录项的子目录项。如果该目录项找到，则它的引用计数加1，并返回所找到的目录项。调用者在完成了对该目录项的使用后，必须调用d_put释放它。 d_validate 验证由不安全源所提供的目录项 int d_validate (struct dentry * dentry, struct dentry * dparent) dentry是dparent有效的子目录项，dparent是父目录项（已知有效） 一个非安全源向我们发送了一个dentry，在这里，我们要验证它并调用dget。该函数由ncpfs用在readdir的实现。如果dentry无效，则返回0。 d_delete 删除一个目录项 void d_delete (struct dentry * dentry) dentry为要删除的目录项 如果可能，把该目录项转换为一个负的目录项，否则从哈希队列中移走它以便以后的删除。

 

内核源码学习：Linux 2.4内核API（八）

2008-09-18 14:29

d_rehash 给哈希表增加一个目录项 void d_rehash (struct dentry * entry) dentry为要增加的目录项 根据目录项的名字向哈希表增加一个目录项 d_move 移动一个目录项 void d_move (struct dentry * dentry, struct dentry * target) dentry为要移动的目录项，target为新目录项 更新目录项缓存以反映一个文件名的移动。目录项缓存中负的目录项不应当以这种方式移动。 __d_path 返回一个目录项的路径 char * __d_path (struct dentry * dentry, struct vfsmount * vfsmnt, struct dentry * root, struct vfsmount * rootmnt, char * buffer, int buflen) dentry为要处理的目录项，vfsmnt为目录项所属的安装点，root为根目录项，rootmnt为根目录项所属的安装点，buffer为返回值所在处，buflen为buffer的长度。 把一个目录项转化为一个字符串路径名。如果一个目录项已被删除，串“(deleted)”被追加到路径名，注意这有点含糊不清。返回值放在buffer中。 "buflen"应该为页大小的整数倍。调用者应该保持dcache_lock锁。 is_subdir 新目录项是否是父目录项的子目录 int is_subdir (struct dentry * new_dentry, struct dentry * old_dentry) new_dentry为新目录项， old_dentry为旧目录项。 如果新目录项是父目录的子目录项（任何路径上），就返回1，否则返回0。     find_inode_number 检查给定名字的目录项是否存在 ino_t find_inode_number (struct dentry * dir, struct qstr * name) dir为要检查的目录，name 为要查找的名字。 对于给定的名字，检查这个目录项是否存在，如果该目录项有一个inode，则返回其索引节点号，否则返回0。 d_drop 删除一个目录项 void d_drop (struct dentry * dentry) dentry为要删除的目录项 d_drop从父目录项哈希表中解除目录项的哈希连接，以便通过VFS的查找再也找不到它。注意这个函数与d_delete的区别，d_delete尽可能地把目录项表记为负的，查找时会得到一个负的目录项，而d_drop会使查找失败。 d_add 向哈希队列增加目录项 void d_add (struct dentry * entry, struct inode * inode) dentry为要增加的目录项，inode为与目录项对应的索引节点。 该函数将把目录项加到哈希队列，并初始化inode。这个目录项实际上已在d_alloc（）函中得到填充。 dget 获得目录项的一个引用 struct dentry * dget (struct dentry * dentry) dentry为要获得引用的目录项 给定一个目录项或空指针，如果合适就增加引用count的值。当一个目录项有引用时（count不为0），就不能删除这个目录项。引用计数为0的目录项永远也不会调用dget。 d_unhashed 检查目录项是否被散列 int d_unhashed (struct dentry * dentry) dentry为要检查的目录项 如果通过参数传递过来的目录项没有用哈希函数散列过，则返回真。

 

内核源码学习：Linux 2.4内核API（九）

2008-09-18 14:29

索引节点处理 __mark_inode_dirty 使索引节点“脏” void __mark_inode_dirty (struct inode * inode, int flags) inode为要标记的索引节点，flags为标志，应当为I_DIRTY_SYNC 这是一个内部函数，调用者应当调用mark_inode_dirty 或mark_inode_dirty_sync。 write_inode_now 向磁盘写一个索引节点 void write_inode_now (struct inode * inode, int sync) inode为要写到磁盘的索引节点，sync表示是否需要同步。 如果索引节点为脏，该函数立即把它写到给磁盘。主要由knfsd来使用。 clear_inode 清除一个索引节点 void clear_inode (struct inode * inode) inode为要写清除的索引节点 由文件系统来调用该函数，告诉我们该索引节点不再有用。 invalidate_inodes 丢弃一个设备上的索引节点 int invalidate_inodes (struct super_block * sb); sb为超级块 对于给定的超级块，丢弃所有的索引节点。如果丢弃失败，说明还有索引节点处于忙状态，则返回一个非0值。如果丢弃成功，则超级块中所有的节点都被丢弃。 get_empty_inode 获得一个索引节点 struct inode * get_empty_inode ( void) 无 这个函数的调用发生在诸如网络层想获得一个无索引节点号的索引节点，或者文件系统分配一个新的、无填充信息的索引节点。 成功则返回一个指向inode的指针，失败则返回一个NULL指针。返回的索引节点不在任何超级块链表中。 iunique 获得一个唯一的索引节点号 ino_t iunique (struct super_block * sb, ino_t max_reserved) sb为超级块，max_reserved为最大保留索引节点号 对于给定的超级块，获得该系统上一个唯一的索引节点号。这一般用在索引节点编号不固定的文件系统中。返回的节点号大于保留的界限但是唯一。 注意，如果一个文件系统有大量的索引节点，则这个函数会很慢。 insert_inode_hash 把索引节点插入到哈希表 void insert_inode_hash (struct inode * inode) inode为要插入的索引节点 把一个索引节点插入到索引节点的哈希表中，如果该节点没有超级块，则把它加到一个单独匿名的链中。 remove_inode_hash 从哈希表中删除一个索引节点 void remove_inode_hash (struct inode * inode) inode为要删除的索引节点 从超级块或匿名哈希表中删除一个索引节点 iput 释放一个索引节点 void iput (struct inode * inode) inode为要释放的索引节点 如果索引节点的引用计数变为0，则释放该索引节点，并且可以撤销它。 bmap 在一个文件中找到一个块号 int bmap (struct inode * inode, int block) inode为文件的索引节点，block为要找的块。 返回设备上的块号，例如，寻找索引节点1的块4，则该函数将返回相对于磁盘起始位置的盘块号。 update_atime 更新访问时间 void update_atime (struct inode * inode) inode为要访问的索引节点 更新索引节点的访问时间，并把该节点标记为写回。这个函数自动处理只读文件系统、介质、“noatime”标志以及具有“noatime”标记者的索引节点。 make_bad_inode 由于I/O错误把一个索引节点标记为坏 void make_bad_inode (struct inode * inode) inode为要标记为坏的索引节点 由于介质或远程网络失败而造成不能读一个索引节点时，该函数把该节点标记为“坏”，并引起从这点开始的I/O操作失败。 is_bad_inode 是否是一个错误的inode int is_bad_inode (struct inode * inode) inode为要测试的索引节点 如果要测试的节点已标记为坏，则返回真。 注册以及超级块 register_filesystem 注册一个新的文件系统 int register_filesystem (struct file_system_type * fs) fs为指向文件系统结构的指针 把参数传递过来的文件系统加到文件系统的链表中。成功则返回0，失败则返回一个负的错误码。     unregister_filesystem 注销一个文件系统 int unregister_filesystem (struct file_system_type * fs) fs为指向文件系统结构的指针 把曾经注册到内核中的文件系统删除。如果没有找到个文件系统，则返回一个错误码，成功则返回0。 这个函数所返回的file_system_type结构被释放或重用。 get_super 获得一个设备的超级块 struct super_block * get_super (kdev_t dev) dev为要获得超级块的设备 扫描超级块链表，查找在给定设备上安装的文件系统的超级块。如果没有找到，则返回空。

 

内核源码学习：Linux 2.4内核API（十）

2008-09-18 14:33

Linux的连网 套接字缓冲区函数 函数名 功能 函数形成 参数 描述 skb_queue_empty 检查队列是否为空 int skb_queue_empty (struct sk_buff_head * list) list为队列头 如果队列为空返回真，否则返回假 skb_get 引用缓冲区 struct sk_buff * skb_get (struct sk_buff * skb) skb为要引用的缓冲区 对套接字缓冲区再引用一次，返回指向缓冲区的指针 kfree_skb 释放一个sk_buff void kfree_skb (struct sk_buff * skb) sk为要释放的缓冲区 删除对一个缓冲区的引用，如果其引用计数变为0，则释放它 skb_cloned 缓冲区是否是克隆的 int skb_cloned (struct sk_buff * skb) skb为要检查的缓冲区 如果以skb_clone标志来产生缓冲区，并且是缓冲区多个共享拷贝中的一个，则返回真。克隆的缓冲区具有共享数据，因此在正常情况下不必对其进行写。 skb_shared 缓冲区是否是共享的 int skb_shared (struct sk_buff * skb) skb为要检查的缓冲区 如果有多于一个的人引用这个缓冲区就返回真。 skb_share_check 检查缓冲区是否共享的，如果是就克隆它 struct sk_buff * skb_share_check (struct sk_buff * skb, int pri) skb为要检查的缓冲区，pri为内存分配的优先级 如果缓冲区是共享的，就克隆这个缓冲区，并把原来缓冲区的引用计数减1，返回新克隆的缓冲区。如果不是共享的，则返回原来的缓冲区。当从中断状态或全局锁调用该函数时，pri必须是GFP_ATOMIC。 内存分配失败则返回NULL。 skb_unshare 产生一个共享缓冲区的拷贝 struct sk_buff * skb_unshare (struct sk_buff * skb, int pri); skb为要检查的缓冲区，pri为内存分配的优先级 如果套接字缓冲区是克隆的，那么这个函数就创建一个新的数据拷贝，并把原来缓冲区的引用计数减1，返回引用计数为1的新拷贝。如果不是克隆的，就返回原缓冲区。当从中断状态或全局锁调用该函数时，pri必须是GFP_ATOMIC。 内存分配失败则返回NULL。 skb_queue_len 获得队列的长度 __u32 skb_queue_len (struct sk_buff_head * list_) list_为测量的链表 返回&sk_buff 队列的指针。 __skb_queue_head 在链表首部对一个缓冲区排队 void __skb_queue_head (struct sk_buff_head * list, struct sk_buff * newsk) list为要使用的链表， newsk为要排队的缓冲区。 在链表首部对一个缓冲区进行排队。这个函数没有锁，因此在调用它之前必须持有必要的锁。一个缓冲区不能同时放在两个链表中。 skb_queue_head 在链表首部对一个缓冲区排队 void skb_queue_head (struct sk_buff_head * list, struct sk_buff * newsk) list为要使用的链表， newsk为要排队的缓冲区。 在链表首部对一个缓冲区进行排队。这个函持有锁，因此可以安全地使用。一个缓冲区不能同时放在两个链表中。 __skb_queue_tail 在链表尾部对一个缓冲区排队 void __skb_queue_tail (struct sk_buff_head * list, struct sk_buff * newsk) list为要使用的链表， newsk为要排队的缓冲区。 在链表尾部对一个缓冲区进行排队。这个函数没有锁，因此在调用它之前必须持有必要的锁。一个缓冲区不能同时放在两个链表中。 skb_queue_tail 在链表尾部对一个缓冲区排队 void skb_queue_tail (struct sk_buff_head * list, struct sk_buff * newsk) list为要使用的链表， newsk为要排队的缓冲区。 在链表尾部对一个缓冲区进行排队。这个函持有锁，因此可以安全地使用。一个缓冲区不能同时放在两个链表中。 __skb_dequeue 从队列的首部删除一个缓冲区 struct sk_buff * __skb_dequeue (struct sk_buff_head * list) list为要操作的队列 删除链表首部。这个函数不持有任何锁，因此使用时应当持有适当的锁。如果队链表为空则返回NULL，成功则返回首部元素。 skb_dequeue 从队列的首部删除一个缓冲区 struct sk_buff * skb_dequeue (struct sk_buff_head * list) list为要操作的队列 删除链表首部，这个函数持有锁，因此可以安全地使用。如果队链表为空则返回NULL，成功则返回首部元素。 skb_insert 插入一个缓冲区 void skb_insert (struct sk_buff * old, struct sk_buff * newsk) old为插入之前的缓冲区，newsk为要插入的缓冲区 把一个数据包放在链表中给定的包之前。该函数持有链表锁，并且是原子操作。一个缓冲区不能同时放在两个链表中。

 

 

内核源码学习：Linux 2.4内核API（十一）

2008-09-18 14:47

skb_append 追加一个缓冲区 void skb_append (struct sk_buff * old, struct sk_buff * newsk) old为插入之前的缓冲区，newsk为要插入的缓冲区 把一个数据包放在链表中给定的包之前。该函数持有链表锁，并且是原子操作。一个缓冲区不能同时放在两个链表中。 skb_unlink 从链表删除一个缓冲区 void skb_unlink (struct sk_buff * skb); Skb为要删除的缓冲区 把一个数据包放在链表中给定的包之前。该函数持有链表锁，并且是原子操作。 _skb_dequeue_tail 从队尾删除 struct sk_buff * __skb_dequeue_tail (struct sk_buff_head * list) List为要操作的链表 从链表尾部删除。这个函数不持有任何锁，因此必须持以合适的锁来使用。如果链表为空，则返回NULL，成功则返首部元素。 skb_dequeue_tail 从队头删除 struct sk_buff * skb_dequeue_tail (struct sk_buff_head * list) List为要操作的链表 删除链表尾部，这个函数持有锁，因此可以安全地使用。如果队链表为空则返回NULL，成功则返回首部元素。 skb_put 把数据加到缓冲区 unsigned char * skb_put (struct sk_buff * skb, unsigned int len) skb为要使用的缓冲区，len为要增加的数据长度 这个函数扩充缓冲区所使用的数据区。如果扩充后超过缓冲区总长度，内核会产生警告。函数返回的指针指向所扩充数据的第一个字节。 skb_push 把数据加到缓冲区的开始 unsigned char * skb_push (struct sk_buff * skb, unsigned int len); skb为要使用的缓冲区，len为要增加的数据长度 这个函数扩充在缓冲区的开始处缓冲区所使用的数据区。如果扩充后超过缓冲区首部空间的总长度，内核会产生警告。函数返回的指针指向所扩充数据的第一个字节。 skb_pull 从缓冲区的开始删除数据 unsigned char * skb_pull (struct sk_buff * skb, unsigned int len) skb为要使用的缓冲区，len为要删除的数据长度 这个函数从链表开始处删除数据，把腾出的内存归还给首部空间。把指向下一个缓冲区的指针返回。 skb_headroom 缓冲区首部空闲空间的字节数 int skb_headroom (const struct sk_buff * skb) skb为要检查的缓冲区 返回&sk_buff首部空闲空间的字节数 skb_tailroom 缓冲区尾部的空闲字节数 int skb_tailroom (const struct sk_buff * skb) skb为要检查的缓冲区 返回&sk_buff尾部空闲空间的字节数 skb_reserve 调整头部的空间 void skb_reserve (struct sk_buff * skb, unsigned int len) skb为要改变的缓冲区，len为要删除的字节数 通过减少尾部空间，增加一个空&sk_buff的首部空间。这仅仅适用于空缓冲区。 skb_trim 从缓冲区删除尾部 void skb_trim (struct sk_buff * skb, unsigned int len); skb为要改变的缓冲区，len为新的长度 通过从尾部删除数据，剪切缓冲区的长度。如果缓冲区已经处于指定的长度，则不用改变。 skb_orphan 使一个缓冲区成为孤儿 void skb_orphan (struct sk_buff * skb); skb是要成为孤儿的缓冲区 如果一个缓冲区当前有一个拥有者，我们就调用拥有者的析构函数，使skb没有拥有者。该缓冲区继续存在，但以前的拥有者不再对其“负责”。 skb_queue_purge 使一个链表空 void skb_queue_purge (struct sk_buff_head * list) list为要腾空的链表 删除在&sk_buff链表上的所有缓冲区。这个函数持有链表锁，并且是原子的。 __skb_queue_purge 使一个链表空 void __skb_queue_purge (struct sk_buff_head * list); list为要腾空的链表 删除在&sk_buff链表上的所有缓冲区。这个函数不持有链表锁，调用者必须持有相关的锁来使用它。 dev_alloc_skb 为发送分配一个skbuff struct sk_buff * dev_alloc_skb (unsigned int length) Length为要分配的长度 分配一个新的&sk_buff，并赋予它一个引用计数。这个缓冲区有未确定的头空间。用户应该分配自己需要的头空间。 如果没有空闲内存，则返回NULL。尽管这个函数是分配内存，但也可以从中断来调用。 skb_cow 当需要时拷贝skb的首部 struct sk_buff * skb_cow (struct sk_buff * skb, unsigned int headroom) Skb为要拷贝的缓冲区，headroom为需要的头空间 如果传递过来的缓冲区缺乏足够的头空间或是克隆的，则该缓冲区被拷贝，并且附加的头空间变为可用。如果没有空闲的内存，则返回空。如果缓冲区拷贝成功，则返回新的缓冲区，否则返回已存在的缓冲区。 skb_over_panic 私有函数 void skb_over_panic (struct sk_buff * skb, int sz, void * here) skb为缓冲区，sz为大小，here为地址。 用户不可调用。 skb_under_panic 私有函数 void skb_under_panic (struct sk_buff * skb, int sz, void * here) skb为缓冲区，sz为大小，here为地址。 用户不可调用。

 

内核源码学习：Linux 2.4内核API（十二）

2008-09-18 14:48

alloc_skb 分配一个网络缓冲区 struct sk_buff * alloc_skb (unsigned int size, int gfp_mask) size为要分配的大小，gfp_mask为分配掩码 分配一个新的&sk_buff。返回的缓冲区没有size大小的头空间和尾空间。新缓冲区的引用计数为1。返回值为一缓冲区，如果失败则返回空。从中断分配缓冲区，掩码只能使用GFP_ATOMIC的gfp_mask。 __kfree_skb 私有函数 void __kfree_skb (struct sk_buff * skb) skb为缓冲区 释放一个sk_buff。释放与该缓冲区相关的所有事情，清除状态。这是一个内部使用的函数，用户应当调用kfree_skb。 skb_clone 复制一个sk_buff struct sk_buff * skb_clone (struct sk_buff * skb, int gfp_mask) skb为要克隆的缓冲区，gfp_mask为分配掩码。 复制一个&sk_buff。新缓冲区不是由套接字拥有。两个拷贝共享相同的数据包而不是结构。新缓冲区的引用计数为1。如果分配失败，函数返回NULL，否则返回新的缓冲区。如果从中断调用这个函数，掩码只能使用GFP_ATOMIC的gfp_mask。 skb_copy 创建一个sk_buff的私有拷贝 struct sk_buff * skb_copy (const struct sk_buff * skb, int gfp_mask) skb为要拷贝的缓冲区，gfp_mask为分配优先级。 既拷贝&sk_buff也拷贝其数据。该函数用在调用者希望修改数据并需要数据的私有拷贝来进行改变时。失败返回NULL，成功返回指向缓冲区的指针。 返回的缓冲区其引用计数为1。如果从中断调用，则必须传递的优先级为GFP_ATOMIC。 skb_copy_expand 拷贝并扩展sk_buff struct sk_buff * skb_copy_expand (const struct sk_buff * skb, int newheadroom, int newtailroom, int gfp_mask); skb为要拷贝的缓冲区，newheadroom为头部的新空闲字节数，newtailroom为尾部的新空闲字节数。 既拷贝&sk_buff也拷贝其数据，同时分配额外的空间。当调用者希望修改数据并需要对私有数据进行改变，以及给新的域更多的空间时调用该函数。失败返回NULL，成功返回指向缓冲区的指针。 返回的缓冲区其引用计数为1。如果从中断调用，则必须传递的优先级为GFP_ATOMIC。

 

内核源码学习：Linux 2.4内核API（十三）

2008-09-18 14:53

网络设备支持 驱动程序的支持 函数名 功能 函数形成 参数 描述 init_etherdev 注册以太网设备 truct net_device * init_etherdev (struct net_device * dev, int sizeof_priv) dev为要填充的以太网设备结构，或者要分配一个新的结构时为NULL，sizeof_priv是为这个以太网设备要分配的额外私有结构的大小。 用以太网的通用值填充这个结构的域。如果传递过来的dev为NULL，则构造一个新的结构，包括大小为sizeof_priv的私有数据区。强制将这个私有数据区在32字节（不是位）上对齐。 dev_add_pack 增加数据包处理程序 void dev_add_pack (struct packet_type * pt) pt为数据包类型 把一个协议处理程序加到网络栈，把参数传递来的&packet_type链接到内核链表中。 dev_remove_pack 删除数据包处理程序 void dev_remove_pack (struct packet_type * pt) pt为数据包类型 删除由dev_add_pack曾加到内核的协议处理程序。把&packet_type 从内核链表中删除，一旦该函数返回，这个结构还能再用。 __dev_get_by_name 根据名字找设备 struct net_device * __dev_get_by_name (const char * name); name为要查找的名字 根据名字找到一个接口。必须在RTNL 信号量或dev_base_lock锁的支持下调用。如果找到这个名字，则返回指向设备的指针，如果没有找到，则返回NULL。引用计数器并没有增加，因此调用者必须小心地持有锁。 dev_get_by_name 根据名字找设备 struct net_device * dev_get_by_name (const char * name) name为要查找的名字 根据名字找到一个接口。这个函数可以在任何上下文中调用并持有自己的锁。返回句柄的引用计数增加，调用者必须在其不使用时调用dev_put释放它，如果没有匹配的名字，则返回NULL。 dev_get 测试设备是否存在 int dev_get (const char * name) name为要测试的名字 测试名字是否存在。如果找到则返回真。为了确保在测试期间名字不被分配或删除，调用者必须持有rtnl信号量。这个函数主要用来与原来的驱动程序保持兼容。    __dev_get_by_index 根据索引找设备 struct net_device * __dev_get_by_index (int ifindex) ifindex为设备的索引 根据索引搜索一个接口。如果没有找到设备，则返回NULL，找到则返回指向设备的指针。该设备的引用计数没有增加，因此调用者必须小心地关注加锁，调用者必须持有RTNL 信号量或dev_base_lock锁。 dev_get_by_index 根据名字找设备 struct net_device * dev_get_by_index (int ifindex) ifindex为设备的索引 根据索引搜索一个接口。如果没有找到设备，则返回NULL，找到则返回指向设备的指针。所返回设备的引用计数加1，因此，在用户调用dev_put释放设备之前，返回指针是安全的。 dev_alloc_name 为设备分配一个名字 int dev_alloc_name (struct net_device * dev, const char * name) dev为设备，name 为格式化字符串。 传递过来一个格式化字符串，例如ltd，该函数试图找到一个合适的 id。设备较多时这是很低效的。调用者必须在分配名字和增加设备时持有dev_base 或 rtnl锁，以避免重复。返回所分配的单元号或出错返回一个复数。 dev_alloc 分配一个网络设备和名字 struct net_device * dev_alloc (const char * name, int * err) name 为格式化字符串,err为指向错误的指针 传递过来一个格式化字符串，例如ltd，函数给该名字分配一个网络设备和空间。如果没有可用内存，则返回NULL。如果分配成功，则名字被分配，指向设备的指针被返回。如果名字分配失败，则返回NULL，错误的原因放在err指向的变量中返回。调用者必须在做这一切时持有dev_base 或 RTNL锁，以避免重复分配名字。     netdev_state_change 设备改变状态 void netdev_state_change (struct net_device * dev) name 为引起通告的设备 当一个设备状态改变时调用该函数。 dev_load 装入一个网络模块 void dev_load (const char * name) name 为接口的名字 如果网络接口不存在，并且进程具有合适的权限，则这个函数装入该模块。如果在内核中模块的装入是不可用的，则装入操作就变为空操作。 dev_open 为使用而准备一个接口 int dev_open (struct net_device * dev) device为要打开的设备 以从低层到上层的过程获得一个设备。设备的私有打开函数被调用，然后多点传送链表被装入，最后设备被移到上层，并把NETDEV_UP信号发送给网络设备的notifier chain。 在一个活动的接口调用该函数只能是个空操作。失败则返回一个负的错误代码。

 

 

内核源码学习：Linux 2.4内核API（十四）

2008-09-18 14:56

dev_close 关闭一个接口 int dev_close (struct net_device * dev) dev为要关闭的设备 这个函数把活动的设备移到关闭状态。向网络设备的notifier chain发送一个NETDEV_GOING_DOWN。然后把设备变为不活动状态，并最终向notifier chain发NETDEV_DOWN信号。 register_netdevice_notifier 注册一个网络通告程序块 int register_netdevice_notifier (struct notifier_block * nb) nb为通告程序 当网络设备的事件发生时，注册一个要调用的通告程序。作为参数传递来的通告程序被连接到内核结构，在其被注销前不能重新使用它。失败则返回一个负的错误码。 unregister_netdevice_notifier 注销一个网络通告块 int unregister_netdevice_notifier (struct notifier_block * nb) nb为通告程序 取消由register_netdevice_notifer曾注册的一个通告程序。把这个通告程序从内核结构中解除，然后还可以重新使用它。失败则返回一个负的错误码。 dev_queue_xmit 传送一个缓冲区 int dev_queue_xmit (struct sk_buff * skb) skb为要传送的缓冲区 为了把缓冲区传送到一个网络设备，对缓冲区进行排队。调用者必须在调用这个函数前设置设备和优先级，并建立缓冲区。该函数也可以从中断中调用。失败返回一个负的错误码。成功并不保证帧被传送，因为也可能由于拥塞或流量调整而撤销这个帧。 netif_rx 把缓冲区传递到网络协议层 void netif_rx (struct sk_buff * skb) skb为要传送的缓冲区 这个函数从设备驱动程序接受一个数据包，并为上层协议的处理对其进行排队。该函数总能执行成功。在处理期间，可能因为拥塞控制而取消这个缓冲区。 net_call_rx_atomic   void net_call_rx_atomic(void(fn) (void)) fn为要调用的函数 使一个函数的调用就协议层而言是原子的。 register_gifconf 注册一个SIOCGIF处理程序 int register_gifconf (unsigned int family, gifconf_func_t * gifconf) family为地址组，gifconf为处理程序 注册由地址转储例程决定的协议。当另一个处理程序替代了由参数传递过来的处理程序时，才能释放或重用后者。 netdev_set_master 建立主／从对 int netdev_set_master (struct net_device * slave, struct net_device * master) slave为从设备，master为主设备。 改变从设备的主设备。传递NULL以中断连接。调用者必须持有RTNL信号量。失败返回一个负错误码。成功则调整引用计数，RTM_NEWLINK发送给路由套接字，并且返回0。 dev_set_allmulti 更新设备上多个计数 void dev_set_allmulti (struct net_device * dev, int inc) dev为设备，inc为修改者。 把接收的所有多点传送帧增加到设备或从设备删除。当设备上的引用计数依然大于0时，接口保持着对所有接口的监听。一旦引用计数变为0，设备回转到正常的过滤操作。负的inc值用来在释放所有多点传送需要的某个资源时减少其引用计数。 dev_ioctl 网络设备的ioctl int dev_ioctl (unsigned int cmd, void * arg) cmd为要发出的命令，arg为用户空间指向ifreq结构的指针。 向设备发布ioctl函数。这通常由用户空间的系统调用接口调用，但有时也用作其他目的。返回值为一个正数，则表示从系统调用返回，为负数，则表示出错。 dev_new_index 分配一个索引 int dev_new_index ( void) 无 为新的设备号返回一个合适而唯一的值。调用者必须持有rtnl信号量以确保它返回唯一的值。 netdev_finish_unregister 完成注册 int netdev_finish_unregister (struct net_device * dev) dev为设备。 撤销或释放一个僵死的设备。成功返回0。           unregister_netdevice 从内核删除设备 int unregister_netdevice (struct net_device * dev) dev为设备。 这个函数关闭设备接口并将其从内核表删除。成功返回0，失败则返回一个负数。

 

内核源码学习：Linux 2.4内核API（十五）

2008-09-18 15:02

8390网卡 ei_open 打开／初始化网板 int ei_open (struct net_device * dev) dev为要初始化的网络设备。 尽管很多注册的设备在每次启动时仅仅需要设置一次，但这个函数在每次打开设备时还彻底重新设置每件事。 ei_close 关闭网络设备 int ei_close (struct net_device * dev) dev为要关闭的网络设备。 ei_open的相反操作，在仅仅在完成“ifconfig<devname>down”时使用 ei_interrupt 处理来自8390的中断 void ei_interrupt (int irq, void * dev_id, struct pt_regs * regs); irq为中断号，dev_id为指向net_devicede 指针，regs没有使用。 处理以太网接口中断。我们通过网卡指定的函数从8390取回数据包，并在网络栈触发它们。如果需要，我们也处理传输的完成并激活传输路径。我们也根据需要更新计数器并处理其他的事务。 ethdev_init 初始化8390设备结构的其余部分 int ethdev_init (struct net_device * dev) dev为要初始化的网络设备结构。 初始化8390设备结构的其余部分。不要用__init（），因为这也由基于8390的模块驱动程序使用。 NS8390_init 初始化8390硬件 void NS8390_init (struct net_device * dev, int startp) dev为要初始化的设备，startp为布尔值，非0启动芯片处理。 必须持以

 

内核源码学习：Linux 2.4内核API（十六）

2008-09-18 15:03

模块支持 模块装入 函数名 功能 函数形成 参数 描述 request_module 试图装入一个内核模块 int request_module (const char * module_name) module_name为模块名 使用用户态模块装入程序装入一个模块。成功返回0，失败返回一个负数。注意，一个成功的装入并不意味着这个模块在自己出错时就能卸载和退出。调用者必须检查他们所提出的请求是可用的，而不是盲目地调用。 如果自动装入模块的功能被启用，那么这个函数就不起作用。 call_usermodehelper 启动一个用户态的应用程序 int call_usermodehelper (char * path, char ** argv, char ** envp); path为应用程序的路径名，argv为以空字符结束的参数列表，envp为以空字符结束的环境列表。 运行用户空间的一个应用程序。该应用程序被异步启动。它作为keventd的子进程来运行，并具有root的全部权能。Keventd在退出时默默地获得子进程。 必须从进程的上下文中调用该函数，成功返回0，失败返回一个负数。 内部模块支持 inter_module_register 注册一组新的内部模块数据 void inter_module_register (const char * im_name, struct module * owner, const void * userdata) im_name为确定数据的任意字符串，必须唯一，owner为正在注册数据的模块，通常用THIS_MODULE ，userdata指向要注册的任意用户数据。 检查im_name还没有被注册，如果已注册就发出“抱怨”。对新数据，则把它追加到inter_module_entry链表。 inter_module_unregister 注销一组内部模块数据 void inter_module_unregister (const char * im_name) im_name为确定数据的任意字符串，必须唯一。 检查im_name已经注册，如果没有注册就发出“抱怨”。 对现有的数据，则把它从inter_module_entry链表中删除。 inter_module_get 从另一模块返回任意的用户数据 const void * inter_module_get (const char * im_name) im_name为确定数据的任意字符串，必须唯一。 如果im_name还没有注册，则返回NULL。增加模块拥有者的引用计数，如果失败则返回NULL，否则返回用户数据。 inter_module_get_request 内部模块自动调用request_module const void * inter_module_get_request (const char * im_name, const char * modname) im__name为确定数据的任意字符串，必须唯一；modname为期望注册m_name的模块。 如果inter_module_get失败，调用request_module，然后重试。 inter_module_put 释放来自另一个模块的数据 void inter_module_put (const char * im_name) im__name为确定数据的任意字符串，必须唯一。 如果im_name还没有被注册，则“抱怨”，否则减少模块拥有者的引用计数。

 

内核源码学习：Linux 2.4内核API（十七）

2008-09-18 15:03

块设备 函数名 功能 函数形式 参数     描述 其他 blk_cleanup_queue 当不再需要一个请求队列时，释放一个request_queue_t void blk_cleanup_queue (request_queue_t * q); q为要释放的请求队列。 blk_cleanup_queue与blk_init_queue是成对出现的。应该在释放请求队列时调用该函数；典型的情况是块设备正被注销时调用。该函数目前的主要任务是释放分配到队列中所有的struct request结构。 低级驱动程序有希望首先完成任何重要的请求… blk_queue_headactive 指明请求队列的头是否可以是活跃的。 void blk_queue_headactive (request_queue_t * q, int active) q为这次申请的队列，active为一个标志，表示队列头在哪儿是活跃的。 块设备驱动程序可以选定把当前活动请求留在请求队列，只有在请求完成时才移走它。队列处理例程为安全起见把这种情况假定为缺省值，并在请求被撤销时，将不再在合并或重新组织请求时包括请求队列的头。 如果驱动程序在处理请求之前从队列移走请求，它就可以在合并和重新安排中包含队列头。这可以通过以active标志为0来调用blk_queue_headactive。 如果一个驱动程序一次处理多个请求，它必须从请求队列移走他们（或至少一个）。 当一个队列被插入，则假定该队列头为不活跃的。   blk_queue_make_request 为设备定义一个交替的make_request 函数。 void blk_queue_make_request (request_queue_t * q, make_request_fn * mfn) q为受影响设备的请求队列，mfn为交替函数。 把buffer_heads结构传递到设备驱动程序的常用方式为让驱动程序把请求收集到请求队列，然后让驱动程序准备就绪时把请求从那个队列移走。这种方式对很多块设备驱动程序很有效。但是，有些块设备（如虚拟设备md或lvm）并不是这样，而是把请求直接传递给驱动程序，这可以通过调用 blk_queue_make_request（）函数来达到。 按以上方式操作的驱动程序必须能够恰当地处理在“高内存”的缓冲区，这是通过调用 bh_kmap 获得一个内核映射，或通过调用 create_bounce 在常规内存创建一个缓冲区。 blk_init_queue 为块设备的使用准备一个请求队列。 void blk_init_queue (request_queue_t * q, request_fn_proc * rfn) q为要初始化的请求队列，rfn为处理请求所调用的函数。 如果一个块设备希望使用标准的请求处理例程，就调用该函数。当请求队列上有待处理的请求时，调用rfn函数。 blk_init_queue的反操作函数为 blk_cleanup_queue ，当撤销块设备时调用后者（例如在模块卸载时）。 generic_make_request 形成块设备的I/O请求。 void generic_make_request (int rw, struct buffer_head * bh) rw为I/O操作的类型，即READ、 WRITE或 READA，bh是内存和磁盘上的缓冲区首部。 READ和WRITE的含义很明确，READA为预读。该函数不返回任何状态。请求的成功与失败，以及操作的完成是由bh->b_end_io 递送的。   submit_bh 类似于上一个函数 void submit_bh (int rw, struct buffer_head * bh) rw为I/O操作的类型，即READ、 WRITE或 READA，bh为描述I/O的buffer_head 该函数与与generic_make_request的目的非常类似，但submit_bh做更多的事情。   ll_rw_block 对块设备的低级访问 void ll_rw_block (int rw, int nr, struct buffer_head * * bhs) rw为READ、 WRITE或 READA，nr为数组中buffer_heads的个数，bhs为指向buffer_heads的数组。 对普通文件的读／写和对块设备的读／写，都是通过调用该函数完成的。 所有的缓冲区必须是针对同一设备的。

 

内核源码学习：Linux 2.4内核API（十八）

2008-09-18 15:05

USB 设备 函数名 功能 函数形成 参数 描述 usb_register 注册一个USB设备 Int usb_register (struct usb_driver * new_driver) new_driver为驱动程序的USB操作 注册一个具有USB核心的USB驱动程序。只要增加一个新的驱动程序，就要扫描一系列独立的接口，并允许把新的驱动程序与任何可识别的设备相关联，成功则返回0，失败则返回一个负数。 usb_scan_devices 扫描所有未申明的USB接口 Usb_scan_devices ( void) 无 扫描所有未申明的USB接口，并通过“probe”函数向它们提供所有已注册的USB驱动程序。这个函数将在usb_register（）调用后自动地被调用。 usb_deregister 注销一个USB驱动程序 Usb_deregister (struct usb_driver * driver) Driver为要注销的驱动程序的USB操作。 从USB内部的驱动程序链表中取消指定的驱动程序 usb_alloc_bus 创建一个新的USB宿主控制器结构 Struct usb_bus * usb_alloc_bus (struct usb_operations * op) op为指向struct usb_operations的指针，这是一个总线结构 创建一个USB宿主控制器总线结构，并初始化所有必要的内部对象（仅仅由USB宿主控制器使用）。如果没有可用内存，则返回NULL。 usb_free_bus 释放由总线结构所使用的内存 Void usb_free_bus (struct usb_bus * bus) 无 （仅仅由USB宿主控制器驱动程序使用） usb_register_bus 注册具有usb核心的USB宿主控制器 Void usb_register_bus (struct usb_bus * bus); Bus指向要注册的总线 仅仅由USB宿主控制器驱动程序使用

 

内核源码学习：Linux 2.4内核API（十九）

2008-09-18 15:09

硬件接口 硬件处理 函数名 功能 函数形成 参数 描述 Disable_irq_nosync 不用等待使一个irq无效 void inline disable_irq_nosync (unsigned int irq) irq为中断号 使所选择的中断线无效。使一个中断栈无效。与disable_ irq不同，这个函数并不确保IRQ处理程序的现有实例在退出前已经完成。可以从IRQ的上下文中调用该函数。 Disable_irq 等待完成使一个irq无效 void disable_irq (unsigned int irq) irq为中断号 使所选择的中断线无效。使一个中断栈无效。 这个函数要等待任何挂起的处理程序在退出之前已经完成。如果你在使用这个函数，同时还持有IRQ处理程序可能需要的一个资源，那么，你就可能死锁。要小心地从IRQ的上下文中调用这个函数。 Enable_irq 启用irq的 void enable_irq (unsigned int irq) irq为中断号 重新启用这条IRQ线上的中断处理。在IRQ的上下文中调用这个函数。 Probe_irq_mask 扫描中断线的位图 unsigned int probe_irq_mask (unsigned long val) val为要考虑的中断掩码 扫描ISA总线的中断线，并返回活跃中断的位图。然后把中断探测的逻辑状态返回给它以前的值。 MTRR处理 Mtrr_add 增加一种内存区类型 int mtrr_add (unsigned long base, unsigned long size, unsigned int type, char increment) base为内存区的物理基地址，size为内存区大小，type为MTRR期望的类型，increment为布尔值，如果为真，则增加该内存区的引用计数。 内存区类型寄存器控制着较新的Intel处理器或非Intel处理器上的高速缓存。这个函数可以增加请求MTRR的驱动程序。每个处理器实现的详细资料和硬件细节都对调用者隐藏。如果不能增加内存区，则可能因为所有的区都在使用，或CPU就根本不支持，于是返回一个负数。成功则返回一个寄存器号，但应当仅仅当作一个cookie来对待。 可用的类型为： MTRR_TYPE_UNCACHEABLE ：无高速缓存 MTRR_TYPE_WRITEBACK：随时以猝发方式写回MTRR_TYPE_WRCOMB：立即写回，但允许猝发 Mtrr_del 删除一个内存区类型 int mtrr_del (int reg, unsigned long base, unsigned long size); reg为由mtrr_add返回的寄存器，base为物理基地址，size为内存区大小。 如果提供了寄存器reg，则base和size都可忽略。这就是驱动程序如何调用寄存器。如果引用计数降到0，则释放该寄存器，该内存区退回到缺省状态。成功则返回寄存器，失败则返回一个负数。

 

 

内核源码学习：Linux 2.4内核API（二十）

2008-09-18 15:11

PCI支持库 pci_find_slot 从一个给定的PCI插槽定位PCI struct pci_dev * pci_find_slot (unsigned int bus, unsigned int devfn) bus为所找PCI设备所驻留的PCI总线的成员，devfn为PCI插槽的成员。 给定一个PCI总线和插槽号，所找的PCI设备位于PCI设备的系统全局链表中。如果设备被找到，则返回一个指向它的数据结构，否则返回空。 pci_find_device 根据PCI标识号开始或继续搜索一个设备 struct pci_dev * pci_find_device (unsigned int vendor, unsigned int device, const struct pci_dev * from) vendor为要匹配的PCI商家id，或要与所有商家id匹配的PCI_ANY_ID，device为要匹配的PCI设备id，或要与所有商家id匹配的PCI_ANY_ID，from为以前搜索中找到的PCI设备，或对于一个新的搜索来说为空。 循环搜索已知PCI设备的链表。如果找到与vendor和device匹配的PCI设备，则返回指向设备结构的指针，否则返回NULL。 给from参数传递NULL参数则开始一个新的搜索，否则，如果from不为空，则从那个点开始继续搜索。 pci_find_class 根据类别开始或继续搜索一个设备 struct pci_dev * pci_find_class (unsigned int class, const struct pci_dev * from) class：根据类别名称搜索PCI设备； Previous：在搜索着找到的PCI设备，对于新的搜索则为NULL。 循环搜索已知PCI设备的链表。如果找到与 class匹配的PCI设备，则返回指向设备结构的指针，否则返回NULL。 给from参数传递NULL参数则开始一个新的搜索，否则，如果from不为空，则从那个点开始继续搜索。 pci_find_capability 查询设备的权能 int pci_find_capability (struct pci_dev * dev, int cap) dev为要查询的PCI设备， cap为权能取值。 断定一个设备是否支持给定PCI权能。返回在设备PCI配置空间内所请求权能结构的地址，如果设备不支持这种权能，则返回0。 pci_find_parent_resource 返回给定区父总线的资源区 struct resource * pci_find_parent_resource (const struct pci_dev * dev, struct resource * res) dev为设备结构，该结构包括要搜索的资源，res为要搜索的子资源记录。 对于给定设备的给定资源区，返回给定区所包含的父总线的资源区。 pci_set_power_state 设置一个设备电源管理的状态。 int pci_set_power_state (struct pci_dev * dev, int new_state) dev为PCI设备，new_state为新的电源管理声明(0 == D0, 3 == D3等)。 设置设备的电源管理状态。对于从状态D3的转换，并不像想象的那么简单，因为很多设备在唤醒期间忘了它们的配置空间。返回原先的电源状态。 pci_save_state 保存设备在挂起之前PCI的配置空间 int pci_save_state (struct pci_dev * dev, u32 * buffer) dev为我们正在处理的PCI设备，buffer为持有配置空间的上下文。 缓冲区必须足够大，以保持整个PCI2.2的配置空间(>= 64 bytes)。 pci_restore_state 恢复PCI设备保存的状态 int pci_restore_state (struct pci_dev * dev, u32 * buffer) dev为我们正在处理的PCI设备，buffer为保存的配置空间。   pci_enable_device 驱动程序使用设备前进行初始化 int pci_enable_device (struct pci_dev * dev) dev为要初始化的PCI设备。 驱动程序使用设备前对设备进行初始化。请求低级代码启用I/O和内存。如果设备被挂起，则唤醒它。小心，这个函数可能失败。 pci_disable_device 使用PCI设备之后使其无效 void pci_disable_device (struct pci_dev * dev) dev为使无效的PCI设备 向系统发送信号，以表明系统不再使用PCI设备。这仅仅包括使PCI总线控制（如果激活）无效。

 

内核源码学习：Linux 2.4内核API（二十一）

2008-09-18 15:11

pci_enable_wake 当设备被挂起时启用设备产生PME# int pci_enable_wake (struct pci_dev * dev, u32 state, int enable) dev为对其实施操作的PCI 设备，state为设备的当前状态，enable为启用或禁用“产生”的标志。 当系统被挂起时，在设备的PM能力中设置位以产生PME#。如果设备没有PM能力，则返回-EIO。如果设备支持它，则返回-EINVAL，但不能产生唤醒事件。如果操作成功，则返回0。 pci_release_regions 释放保留的PCI I/O和内存资源 void pci_release_regions (struct pci_dev * pdev) pdev 为PCI设备，其资源以前曾由pci_request_regions保留。 释放所有的PCI I/O和以前对pci_request_regions成功调用而使用的内存。只有在PCI区的所有使用都停止后才调用这个函数。 pci_request_regions 保留PCI I/O和内存资源 int pci_request_regions (struct pci_dev * pdev, char * res_name) pdev为PCI设备，它的资源要被保留，res_name为与资源相关的名字。 把所有与PCI设备pdev相关联的PCI区进行标记，设备pdev是由属主res_name保留的。除非这次调用成功返回，否则不要访问PCI内的任何地址。 成功返回0，出错返回EBUSY，失败时也打印警告信息。 pci_register_driver 注册一个PCI设备 int pci_register_driver (struct pci_driver * drv) drv为要注册的驱动程序结构。 把驱动程序结构增加到已注册驱动程序链表，返回驱动程序注册期间所声明的PCI设备号。即使返回值为0，驱动程序仍然是已注册。 pci_unregister_driver 注销一个PCI设备 void pci_unregister_driver (struct pci_driver * drv) drv为要注销的驱动程序结构。 从已注册的PCI驱动程序链表中删除驱动程序结构，对每个驱动程序所驱动的设备，通过调用驱动程序的删除函数，给它一个清理的机会，把把这些设备标记为无驱动程序的。 pci_insert_device 插入一个热插拔设备 void pci_insert_device (struct pci_dev * dev, struct pci_bus * bus) dev为要插入的设备，bus为PCI总线，设备就插入到该总线。 把一个新设备插入到设备列表，并向用户空间（/sbin/hotplug）发出通知。 pci_remove_device 删除一个热插拔设备 void pci_remove_device (struct pci_dev * dev) dev为要删除的设备 把一个新设备从设备列表删除，并向用户空间（/sbin/hotplug）发出通知。 pci_dev_driver 获得一个设备的pci_driver struct pci_driver * pci_dev_driver (const struct pci_dev * dev) dev为要查询的设备 返回合适的pci_driver结构，如果一个设备没有注册的驱动程序，则返回NULL。 pci_set_master 为设备dev启用总线控制 void pci_set_master (struct pci_dev * dev) dev为要启用的设备 启用设备上的总线控制，并调用pcibios_set_master对特定的体系结构进行设置。 pci_setup_device 填充一个设备的类和映射信息 int pci_setup_device (struct pci_dev * dev) dev为要填充的设备结构 用有关设备的商家、类型、内存及IO空间地址，IRO线等初始化设备结构。在PCI子系统初始化时调用该函数。成功返回0，设备类型未知返回-1

 

2.4 kernel API