linux内核中的Hlist与List_head结构

List_Head
操作系统内核经常需要维护数据结构。内核有标准的循环链表、双向链表的实现。在<Linux/list.h>文件中定义了一个list_head类型简单结构：

struct list_head { struct list_head *next, *prev; };

通用链表的常用用途是将某一个数据结构本身串成链表，或将某些链表与一个数据结构联系起来，这两种情况实质上都是由结构list_head组成链表，只是list_head所“背负”的负载不一样。下面分别举例说明这两种用途。
以下示例说明了如何将某一个数据结构本身串成链表，并对链表进行操作，同时还说明list_head结构的实现与使用。
示例：将某一个数据结构本身串成链表。
（1）加入list_head结构成员。
假设有一个example_struct结构需连接成链表，因而在其结构里面加上list_head成员，就组成了结构链表，如下：

struct example_struct { struct list_head list; int priority; ……//其他成员 };

在example_struct结构中的list成员，用来将example_struct结构串成链表。可理解为list_head“背负”的负载是example_struct结构。
（2）创建list_head结构。
使用前必须申请链表头并用 INIT_LIST_HEAD 宏来初始化链表头。可使用两种方法。

方法1： struct list_head example_list; INIT_LIST_HEAD(&example_list); 方法2： LIST_HEAD(example_list);

其中，这两个宏在include/Linux/list.h中定义如下：

#define LIST_HEAD(name) / struct list_head name = LIST_HEAD_INIT(name) #define INIT_LIST_HEAD(ptr) do { / (ptr)->next = (ptr); (ptr)->prev = (ptr); / } while (0)

宏定义INIT_LIST_HEAD初始化了链表头，即向前、向后的指针都指向链表头。这样，就已初始化了一个example_list的链表头，以后就可以向链表中增加链表元素了。
（3）链表与用户结构连接。
list_entry宏将exmplelist链表与exmple_struct结构类型连接起来。

有两项链表的链表头

List_entry宏的效果

含list_head的定制结构

next

prev

list_head结构

空链表

<linux/list. h>中的链表

下面这个代码行就是从examplelist链表中得到节点对应的example_struct结构指针，其中ptr是examplelist链表中的指针，如ptr = examplelist->next。

struct example_struct *node = list_entry(ptr, struct example_struct, list);

在上面代码行中的宏定义list_entry将一个 list_head结构指针映射回一个指向结构example_struct的指针，即得到list_head的宿主结构。下面分析这个宏定义（在include/Linux/list.h中）：

#define list_entry(ptr, type, member) / container_of(ptr, type, member)

list_entry的功能是得到链表中节点的结构，它的参数含义为：
ØØ ptr是链表中的一个struct list_head结构元素指针。
ØØ type是用户定义的结构类型，其中，包含struct list_head结构成员。
ØØ member用户定义结构中的struct list_head结构成员名字。
在include/Linux/kernel.h中有container_of的定义，参数含义与list_entry中一致，container_of得到list的容器结构，即含有list成员的结构type。container_of的定义如下：

#define container_of(ptr, type, member) ({ / 　　　　//将链表中的元素ptr转换成结构type中成员member的类型 const typeof( ((type *)0)->member ) *__mptr = (ptr); / 　　　　//__mptr减去member成员偏移地址正好是type结构地址 (type *)( (char *)__mptr - offsetof(type,member) );})

在include/Linux/stddef.h中有宏offsetof的定义，列出如下：

#define offsetof(TYPE, MEMBER) ((size_t) &((TYPE *)0)->MEMBER)

offsetof宏对于上述示例的展开及分析是：&((struct example_struct *)0)->list表示当结构example_struct正好在地址0上时其成员list的地址，即成员位移。
（4）遍历链表
下面使用list_entry 宏遍历链表得到链表指针，再从链表指针映射回对应结构example_struct的指针。然后，对其成员priority进行操作。函数example_add_entry的功能是给链表加入新的结构成员。

void example_add_entry(struct example_struct *new) { struct list_head *ptr; struct example_struct *entry; 　　//遍历链表 for (ptr = exmple_list.next; ptr != &exmple_list; ptr = ptr->next) { //映射回对应结构example_struct的指针 entry = list_entry(ptr, struct todo_struct, list); if (entry->priority < new->priority) { list_add_tail(&new->list, ptr); return; } } list_add_tail(&new->list, &exmple_struct) }

示例：将某些链表与一个数据结构联系起来。
函数new_inode为给定的超级块分配一个新的节点，并将新的节点加到链表inode_in_use和sb->s_inodes中，从而在两个链表中链接了新的节点。一个是以inode_in_use为链表头的全局的节点链表；一个是超级块结构为链表头的节点链表。

fs/inode.c extern struct list_head inode_in_use; struct inode *new_inode(struct super_block *sb) { static unsigned long last_ino; struct inode * inode; spin_lock_prefetch(&inode_lock); inode = alloc_inode(sb); if (inode) { spin_lock(&inode_lock); inodes_stat.nr_inodes++; 　　　　　//将inode加到inode_in_use链表中 list_add(&inode->i_list, &inode_in_use); list_add(&inode->i_sb_list, &sb->s_inodes);　//将inode加到超级块的节点链表中 inode->i_ino = ++last_ino; inode->i_state = 0; spin_unlock(&inode_lock); } return inode; …… …… …… s_inodes i_sb_list i_sb_list list_head list_head list_head *next *prev *prev *prev *next *next Super_block inode inode }

在include/Linux/list.h中还定义了下面操作链表的函数。
ØØ list_add(struct list_head *new, struct list_head *head)；这个函数在链表头后面添加新的元素。如果是在链表的头部添加元素，就可以用来建立栈。还需要注意的是，head并不一定非得是链表的第一项，如果传递了一个恰巧位于链表中间某处的list_head结构，新入口会立即排在它的后面。因为Linux链表是循环的，链表头通常与其他入口没有本质区别。
ØØ list_add_tail(struct list_head *new, struct list_head *head)；在给定链表头的前面增加一个新的元素，即在链表的末尾添加。可使用list_add_tail建立“先入先出”队列。
ØØ list_del(struct list_head *entry)；从链表中将给定的入口删除。
ØØ list_empty(struct list_head *head)；如果给定的链表是空的，就返回一个非零值。
ØØ list_splice(struct list_head *list, struct list_head *head)；这个函数通过在head的后面插入list来合并两个链表。

Hlist
在include/Linux/list.h中有list链表与hlist哈希链表结构的定义，下面都列出它们的定义，可以对比一下：

struct list_head {struct list_head *next, *prev; }; struct hlist_head { struct hlist_node *first; }; struct hlist_node { struct hlist_node *next, **pprev; };

双头（next，prev）的双链表对于Hash表来说“过于浪费”，因而另行设计了一套Hash表专用的hlist数据结构——单指针表头双循环链表，hlist的表头仅有一个指向首节点的指针，而没有指向尾节点的指针，这样在可能是海量的Hash表中存储的表头就能减少一半的空间消耗。
pprev因为hlist不是一个完整的循环链表而不得不使用。在list中，表头和节点是同一个数据结构，直接用prev没问题；在hlist中，表头没有prev，也没有next，只有一个first。为了能统一地修改表头的first指针，即表头的first指针必须修改指向新插入的节点，hlist就设计了pprev。hlist节点的pprev不再是指向前一个节点的指针，而是指向前一个节点（可能是表头）中的next（对于表头则是first）指针（struct list_head **pprev），从而在表头插入的操作可以通过一致的“*(node->pprev)”访问和修改前节点的next（或first）指针。
下面是hlist中常用的几个宏：

#define HLIST_HEAD_INIT { .first = NULL } #define HLIST_HEAD(name) struct hlist_head name = { .first = NULL } #define INIT_HLIST_HEAD(ptr) ((ptr)->first = NULL) #define INIT_HLIST_NODE(ptr) ((ptr)->next = NULL, (ptr)->pprev = NULL)

下面只列出hlist_add_before操作函数，其他hlist链表操作函数操作方法类似。这个函数中的参数next不能为空。它在next前面加入了n节点。函数的实现与list中对应函数类似。

static inline void hlist_add_before(struct hlist_node *n, struct hlist_node *next) { n->pprev = next->pprev; n->next = next; next->pprev = &n->next; *(n->pprev) = n; }