klist函数的简单分析

            klist浅析

一.结构
struct klist {
    spinlock_t        k_lock;
    struct list_head    k_list;
    void            (*get)(struct klist_node *);
    void            (*put)(struct klist_node *);
} __attribute__ ((aligned (4)));       链表头

struct klist_node {
    void            *n_klist;    /* never access directly */
    struct list_head    n_node;
    struct kref        n_ref;
};                    链表结点

二.函数
void klist_init(struct klist *k, void (*get)(struct klist_node *),
        void (*put)(struct klist_node *))
{
    INIT_LIST_HEAD(&k->k_list);
    spin_lock_init(&k->k_lock);
    k->get = get;
    k->put = put;
}            klist链表头的初始化，及结点的操作接口

void klist_add_tail(struct klist_node *n, struct klist *k)
{
    klist_node_init(k, n);  ／／初始化结点，计数初始化为1，n->klist指向链表头
    add_tail(k, n);        ／／将结点n添加到klist->k_list链表尾
}

void klist_add_head(struct klist_node *n, struct klist *k)
{
    klist_node_init(k, n);
    add_head(k, n);
}初始化结点，及添加到头部

void klist_add_after(struct klist_node *n, struct klist_node *pos)
{
    struct klist *k = knode_klist(pos);

    klist_node_init(k, n);
    spin_lock(&k->k_lock);
    list_add(&n->n_node, &pos->n_node);
    spin_unlock(&k->k_lock);
}／／添加到一个已存在结点之后
void klist_add_before(struct klist_node *n, struct klist_node *pos)
{
    struct klist *k = knode_klist(pos);

    klist_node_init(k, n);
    spin_lock(&k->k_lock);
    list_add_tail(&n->n_node, &pos->n_node);
    spin_unlock(&k->k_lock);
}／／添加到一个已存在结点之前

三.重要结构之遍历结构
struct klist_iter {
    struct klist        *i_klist;  ／／链表头指针
    struct klist_node    *i_cur;        ／／结点指针
};
四.看操作函数
void klist_iter_init(struct klist *k, struct klist_iter *i)
{
    klist_iter_init_node(k, i, NULL);
}初始化iter结构体

void klist_iter_init_node(struct klist *k, struct klist_iter *i,
              struct klist_node *n)
{
    i->i_klist = k;  ／／链表头
    i->i_cur = n;    ／／传入的结点
    if (n)            ／／如果不为空
        kref_get(&n->n_ref);／／引用加1
}可见这两个初始化用的是同一个函数

void klist_iter_exit(struct klist_iter *i)
{
    if (i->i_cur) {         ／／如果当前结点不为空
        klist_put(i->i_cur, false);    ／／减少引用计数
        i->i_cur = NULL;        ／／设iter当前结点为空
    }
}
struct klist_node *klist_next(struct klist_iter *i)
{
    void (*put)(struct klist_node *) = i->i_klist->put;
    struct klist_node *last = i->i_cur;
    struct klist_node *next;

    spin_lock(&i->i_klist->k_lock);

    if (last) {
        next = to_klist_node(last->n_node.next);    ／／获得下一个结点
        if (!klist_dec_and_del(last))            ／／如果已减为0，则不需要调用put
            put = NULL;
    } else
        next = to_klist_node(i->i_klist->k_list.next);

    i->i_cur = NULL;
    while (next != to_klist_node(&i->i_klist->k_list)) {／／判断否链表已遍历完
        if (likely(!knode_dead(next))) {        ／／是否dead
            kref_get(&next->n_ref);
            i->i_cur = next;        获得下一个结点
            break;
        }
        next = to_klist_node(next->n_node.next);
    }

    spin_unlock(&i->i_klist->k_lock);

    if (put && last)
        put(last);
    return i->i_cur;
}

五.等待结结构体，用于唤醒进程
struct klist_waiter {
    struct list_head list;
    struct klist_node *node;
    struct task_struct *process;
    int woken;
};

六.所要操作的函数
static DEFINE_SPINLOCK(klist_remove_lock);  ／／定义并初始化一个自旋锁
static LIST_HEAD(klist_remove_waiters);        ／／定义初始化一个wait链表

static void klist_release(struct kref *kref)
{
    struct klist_waiter *waiter, *tmp;
    struct klist_node *n = container_of(kref, struct klist_node, n_ref);

    WARN_ON(!knode_dead(n));
    list_del(&n->n_node);
    spin_lock(&klist_remove_lock);
    list_for_each_entry_safe(waiter, tmp, &klist_remove_waiters, list) { ／／遍历找到结点n
        if (waiter->node != n)
            continue;

        waiter->woken = 1;        ／／唤醒标志
        mb();
        wake_up_process(waiter->process);    ／／唤醒等待进程
        list_del(&waiter->list);             ／／删除链表入口
    }
    spin_unlock(&klist_remove_lock);
    knode_set_klist(n, NULL);        设置n_klist指向为空            
}

static int klist_dec_and_del(struct klist_node *n)
 {
            /* n->nref减引用次数，若引用次数减完不为0，调用klist_release清除节点对象，返回0；则返回1 */
         return kref_put(&n->n_ref, klist_release);
 }

int klist_node_attached(struct klist_node *n)
{
        return (n->n_klist != NULL); 判断是否为链表边界
}
EXPORT_SYMBOL_GPL(klist_node_attached);






有的可能不正确，望大家指出来，因为没有结合例子，等以后用到时，才会有更深的体会