终于理解list_entry和list_for_each_entry

内核中经常采用链表来管理对象，先看一下内核中对链表的定义

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

一般将该数据结构嵌入到其他的数据结构中，从而使得内核可以通过链表的方式管理新的数据结构，看一个例子:

  struct example {
        member a;
        struct list_head list;
        member b;
    };

 1、链表的定义和初始化

可以通过两种方式来定义和初始化一个链表头结点，例如，您想定义一个链表头结点mylist，那么您可以这么做：
① LIST_HEAD(mylist);  // 使用LIST_HEAD宏定义并初始化一个链表

② struct list_head mylist;  // 定义一个链表
    INIT_LIST_HEAD(&mylist); // 使用INIT_LIST_HEAD函数初始化链表

可以看出方式①稍微简单一点，我们先来分析一下LIST_HEAD宏：

  #define LIST_HEAD_INIT(name) { &(name), &(name) }
  #define LIST_HEAD(name) /
         struct list_head name = LIST_HEAD_INIT(name)

 很容易看出LIST_HEAD(mylist);会被扩展为：
  struct list_head mylist = { &(mylist), &(mylist) };

list_head结构只有两个成员：next和prev。从上面的代码可以看出，next和prev都被赋值为链表mylist的地址，也就是说，链表初始化后next和prev都是指向自己的。

大多数情况下，list_head是被嵌入到其他数据结构中的，比如上面的example结构里的list成员，那么如何对list成员进行初始化？通过调用INIT_LIST_HEAD函数：

struct example test;
INIT_LIST_HEAD(&test.list); 
该函数简单地将list成员的prev和next指针指向自己。

可以看出链表结点在初始化时，都将prev和next指向自己。注意：对链表的初始化非常重要，因为如果使用一个未被初始化的链表结点，很有可能会导致内核异常。

2、对链表常用的操作

对链表常用的操作无非就是增加、删除、遍历等。当然内核还提供很多其他的操作，如替换某个结点、将某个结点移动到链表尾端等等，这些操作都是通过调用基本的增加、删除等操作完成的。

2.1 增加：list_add和list_add_tail
调用list_add可以将一个新链表结点插入到一个已知结点的后面；
调用list_add_tail可以将一个新链表结点插入到一个已知结点的前面；

下面分析它们的具体实现，它们都以不同的参数调用了相同的函数__list_add：

static inline void __list_add(struct list_head *new,
             struct list_head *prev,
             struct list_head *next)
    {
         next->prev = new;
         new->next = next;
         new->prev = prev;
         prev->next = new;
    }

static inline void list_add(struct list_head *new, struct list_head *head)
    {
         __list_add(new, head, head->next);
    }

list_add函数中以new、head、head->next为参数调用__list_add，将new结点插入到head和head->next之间，也就是将new结点插入到特定的已知结点head的后面；

static inline void list_add_tail(struct list_head *new, struct list_head *head)
{
     __list_add(new, head->prev, head);
}

而list_add_tail函数则以new、head->prev、head为参数调用__list_add，将new结点插入到head->prev和head之间，也就是将new结点插入到特定的已知结点head的前面。

有了list_add和list_add_tail，我们可以很方便地实现栈（list_add）和队列（list_add_tail）

2.2 删除：list_del和list_del_init
调用list_del函数删除链表中的一个结点； 
调用list_del_init函数删除链表中的一个结点，并初始化被删除的结点（也就是使被删除的结点的prev和next都指向自己）；

下面分析它们的具体实现，它们都调用了相同的函数__list_del：

 static inline void __list_del(struct list_head * prev, struct list_head * next)
    {
         next->prev = prev;
         prev->next = next;
    }

该函数实际的作用是让prev结点和next结点互相指向；

  static inline void list_del(struct list_head *entry)
    {
         __list_del(entry->prev, entry->next);
         entry->next = LIST_POISON1;
         entry->prev = LIST_POISON2;
    }

该函数中以entry->prev和entry->next为参数调用__list_del函数，使得entry结点的前、后结点绕过entry直接互相指向，然后将entry结点的前后指针指向LIST_POISON1和LIST_POISON2，从而完成对entry结点的删除。此函数中的LIST_POISON1和LIST_POISON2有点让人费解，因为一般情况下我们删除entry后，应该让entry的prev和next指向NULL的，可是这里却不是，原因有待调查。

static inline void list_del_init(struct list_head *entry)
    {
         __list_del(entry->prev, entry->next);
         INIT_LIST_HEAD(entry);
    }

与list_del不同，list_del_init将entry结点删除后，还会对entry结点做初始化，使得entry结点的prev和next都指向自己。

3、几个重要的宏

内核提供了一组宏，以方便对链表进行管理。

3.1 list_entry
前面说过，list_head结构通常被嵌入到其他数据结构中，以便内核可以通过链表的方式管理这些数据结构。假设这样一种场景：我们已知类型为example的对象的list成员的地址ptr（struct list_head *ptr），那么我们如何通过ptr来得到该example对象的地址呢？答案很明显，使用container_of宏。不过，在这样的情况下我们应该通过使用list_entry宏来完成container_of宏的功能，因为这样更容易理解一点。其实list_entry宏很简单：#define list_entry(ptr, type, member)  container_of(ptr, type, member) ......

上述情况，我们可以这样： list_entry(ptr, struct example, list); 来获取example对象的指针。

3.2 list_for_each_entry
 对链表的一个重要的操作就是对链表进行遍历，以达到某种应用目的，比如统计链表结点的个数等等。先来看看内核中对该宏的定义：

#define list_for_each_entry(pos, head, member)    /
         for (pos = list_entry((head)->next, typeof(*pos), member); /
               prefetch(pos->member.next), &pos->member != (head);  /
               pos = list_entry(pos->member.next, typeof(*pos), member))

其中，pos是指向宿主结构的指针，在for循环中是一个迭代变量；head是要进行遍历的链表头指针；member是list_head成员在宿主结构中的名字。

4 .链表使用例程

查看例程