genl-netlink 协议 Linux kernel 实现 欣赏

当注册一个genl_ops时，会根据genl_ops->cmd 到链表上查找有没有同名的genl_ops.
比较:
在设备驱动模型中，当你添加一个device的时候，需要到device链表来查找有无同名的device，
添加deviec_driver的时候，也是一样利用name来查找有没有同名的device_driver(具体的是driver_find() 函数)，
添加genl_ops原理一样，只不过这里是利用cmd来判断的.Linu内核中重要的结构体大部分都是这样组织成链表(另一部分是数组)，
然后对该链表进行增加、删除、遍历.. list_entry()取出一个 然后调用该节点中的回调函数，

/*
@family
通用netlink家族
在调用该函数前，需要构造结构体struct genl_family，然后调用函数genl_register_family()来注册
这个函数很丰富，最终还是把构造的genl_family 添加到散列表上,下面会说

注意，
它的pre_doit()函数比 genl_ops 的 doit()函数调用还要早，
post_doit()函数在doit()函数调用后调用
这样的设计 比 ioctl 要好多了
@ops
这个参数很重要，而且对该参数的校验也是很严格的
必需提供回调函数 doit()或 dumpit(),不然，你就别想注册成功了
*/
int genl_register_ops(struct genl_family *family, struct genl_ops *ops)
{
int err = -EINVAL;

/**
这里对传入的参数进行校验，不合法的别想进来，如果不提供过doit、dupit 就会错误，
其实，这里校验不是最严重的地方，最严重的是对 注册的组播组的名字进行校验，连续用了两个BUG_ON(),
这是Linux kernel中为数不多的一次
源码 :
int genl_register_mc_group()
{
......
BUG_ON(grp->name[0] == '\0');
BUG_ON(memchr(grp->name, '\0', GENL_NAMSIZ) == NULL);
*/
if (ops->dumpit == NULL && ops->doit == NULL)
goto errout;

/**
该函数就是上图说的了，遍历整条链表,发现有相同命令的，就在这儿返回了
源码:
static struct genl_ops *genl_get_cmd()
{
struct genl_ops *ops;
遍历链表吧
list_for_each_entry(ops, &family->ops_list, ops_list)
if (ops->cmd == cmd) 比较CMD
return ops;
return NULL;
}
*/
if (genl_get_cmd(ops->cmd, family)) {
err = -EEXIST;
goto errout;
}
/*
#define GENL_ADMIN_PERM     0x01
#define GENL_CMD_CAP_DO     0x02
#define GENL_CMD_CAP_DUMP   0x04
#define GENL_CMD_CAP_HASPOL 0x08

如果你注册的genl_ops提供了dumpit、doit、policy时，会改变ops中的flags的位，
以后的函数 会检查这个flags的位吗 ?
内核中仅有一处检查这个flags的位，而且检查的是 #define GENL_CMD_CAP_DUMP 0x04
那么 netlink内核 用这个flags字段 又有哪些含义呢！

使用通用netlink套接字从user space 发送的数据，会交给这个函数处理
genl_rcv()
{
↓
genl_rcv_msg()
{
↓
genl_family_rcv_msg()
{
if ((ops->flags & GENL_ADMIN_PERM) &&!netlink_capable(skb,CAP_NET_ADMIN))
}
}
}
*/
if (ops->dumpit)   // 转储回调函数
ops->flags |= GENL_CMD_CAP_DUMP;
if (ops->doit)    // 命令回调函数
ops->flags |= GENL_CMD_CAP_DO;
if (ops->policy)  // 属性有效性策略
ops->flags |= GENL_CMD_CAP_HASPOL;

/*
这里用了两把锁，保护临界区
down_write(&cb_lock);
mutex_lock(&genl_mutex);
读写锁、互斥锁 同时用上了，
*/
genl_lock_all();
/*
添加到链表上去把
*/
list_add_tail(&ops->ops_list, &family->ops_list);
genl_unlock_all();

/**
在这里函数中有一个 大的switch case，
if (!init_net.genl_sock)
return 0;
switch (event)
{
case CTRL_CMD_NEWFAMILY:
case CTRL_CMD_DELFAMILY:
case CTRL_CMD_NEWMCAST_GRP:
default:
return -EINVAL;
}
看该函数的第一个参数 CTRL_CMD_NEWOPS
没有匹配任何一个，直接 return 了
*/
genl_ctrl_event(CTRL_CMD_NEWOPS, ops);
err = 0;
errout:
return err;
}