Chinaunix首页 | 论坛 | 博客
  • 博客访问: 1758728
  • 博文数量: 272
  • 博客积分: 1272
  • 博客等级: 少尉
  • 技术积分: 1866
  • 用 户 组: 普通用户
  • 注册时间: 2011-03-09 15:51
文章分类

全部博文(272)

文章存档

2016年(16)

2015年(28)

2014年(97)

2013年(59)

2012年(25)

2011年(47)

分类: LINUX

2016-01-04 17:18:32

netlink socket是一种用于用户态进程和内核态进程之间的通信机制。它通过为内核模块提供一组特殊的API,并为用户提供了一组标准的socket接口的方式,实现了全双工的通讯连接。

Netlink的特点:

  • 双向传输,异步通信
  • 用户空间中使用标准socket API
  • 内核空间中使用专门的API
  • 支持多播
  • 可由内核端发起通信
  • 支持32种协议类型

netlink仅支持32种协议类型,这在实际应用中可能并不足够。因此产生了generic netlink(以下简称为genl)。
generic netlink支持1023个子协议号,弥补了netlink协议类型较少的缺陷。支持协议号自动分配。它基于netlink,但是在内核中,generic netlink的接口与netlink并不相同。

1. Generic Netlink框架概述

图1表示了Generic Netlink框架。Kernel socket API向用户空间和内核空间分别提供接口。
Netlink子系统(1)是所有genl通信的基础。Netlink子系统中收到的所有Generic类型的netlink数据都被送到genl总线(2)上;从内核发出的数据也经由genl总线送至netlink子系统,再打包送至用户空间。
Generic Netlink控制器(4)作为内核的一部分,负责动态地分配genl通道(即genl family id),并管理genl任务。genl控制器是一个特殊的genl内核用户,它负责监听genl bus上的通信通道。genl通信建立在一系列的通信通道的基础上,每个genl family对应多个通道,这些通道由genl控制器动态分配。

 +---------------------+      +---------------------+
      | (3) application "A" |      | (3) application "B" |
      +------+--------------+      +--------------+------+
             |                                    |
             \                                    /
              \                                  /
               |                                |
       +-------+--------------------------------+-------+
       |        :                               :       |   user-space
  =====+        :   (5)  Kernel socket API      :       +================
       |        :                               :       |   kernel-space
       +--------+-------------------------------+-------+
                |                               |
          +-----+-------------------------------+----+
          |        (1)  Netlink subsystem            |
          +---------------------+--------------------+
                                |
          +---------------------+--------------------+
          |       (2) Generic Netlink bus            |
          +--+--------------------------+-------+----+
             |                          |       |
     +-------+---------+                |       |
     |  (4) Controller |               /         \
     +-----------------+              /           \
                                      |           |
                   +------------------+--+     +--+------------------+
                   | (3) kernel user "X" |     | (3) kernel user "Y" |
                   +---------------------+     +---------------------+ 
图1:generic netlink框架


2 Generic Netlink相关结构体
2.1 genl family

Generic Netlink是基于客户端-服务端模型的通信机制。服务端注册family(family是对genl服务的各项定义的集合)。控制器和客户端都通过已注册的信息与服务端通信。
genl family的结构体如下:

struct genl_family
{
      unsigned int            id;
      unsigned int            hdrsize;
      char                    name[GENL_NAMSIZ];
      unsigned int            version;
      unsigned int            maxattr;
      struct nlattr **        attrbuf;
      struct list_head        ops_list;
      struct list_head        family_list;
};

对此结构体元素具体解释如下:

* id: family id。当新注册一个family的时候,应该用GENL_ID_GENERATE宏(0x0),表示请控制器自动为family分配的一个id。0x10保留供genl控制器使用。
* hdrsize: 用户自定议头部长度。即图2中User Msg的长度。如果没有用户自定义头部,这个值被赋为0。
* version: 版本号,一般填1即可。
* name: family名,要求不同的family使用不同的名字。以便控制器进行正确的查找。
* maxattr:genl使用netlink标准的attr来传输数据。此字段定义了最大attr类型数。(注意:不是一次传输多少个attr,而是一共有多少种attr,因此,这个值可以被设为0,为0代表不区分所收到的数据的attr type)。在接收数据时,可以根据attr type,获得指定的attr type的数据在整体数据中的位置。

* struct nlattr **attrbuf
* struct list_head ops_list
* struct list_head family_list
以上的三个字段为私有字段,由系统自动配置,开发者不需要做配置。

图2 genl报文与linux中各变量的对应关系

图3 genl报文格式
2.2 genl_ops 结构体

点击(此处)折叠或打开

  1. struct genl_ops
  2. {
  3.       u8 cmd;
  4.       unsigned int flags;
  5.       struct nla_policy *policy;
  6.       int (*doit)(struct sk_buff *skb, struct genl_info *info);
  7.       int (*dumpit)(struct sk_buff *skb, struct netlink_callback *cb);
  8.       struct list_head ops_list;
  9. };
  • cmd: 命令名。用于识别各genl_ops
  •   flag: 各种设置属性,以“或”连接。在需要admin特权级别时,使用GENL_ADMIN_PERM
  •   policy:定义了attr规则。如果此指针非空,genl在触发事件处理程序之前,会使用这个字段来对帧中的attr做校验(见nlmsg_parse函数)。该字段可以为空,表示在触发事件处理程序之前,不做校验。
        policy是一个struct nla_policy的数组。struct nla_policy结构体表示如下:

点击(此处)折叠或打开

  1. struct nla_policy
  2. {
  3.    u16 type;
  4.    u16 len;
  5. };
其中,type字段表示attr中的数据类型,可被配置为:
       NLA_UNSPEC--未定义
       NLA_U8, NLA_U16, NLA_U32, NLA_U64为8bits, 16bits, 32bits, 64bits的无符号整型
       NLA_STRING--字符串
       NLA_NUL_STRING--空终止符字符串
       NLA_NESTED--attr流

       len字段的意思是:如果在type字段配置的是字符串有关的值,要把len设置为字符串的最大长度(不包含结尾的'\0')。如果type字段未设置或被设置为NLA_UNSPEC,那么这里要设置为attr的payload部分的长度。

  • doit:这是一个回调函数。在generic netlink收到数据时触发,运行在进程上下文。

        doit传入两个参数,skb为触发此回调函数的socket buffer。第二个参数是一个genl_info结构体,定义如下:


点击(此处)折叠或打开

  1. struct genl_info
  2. {
  3.       u32 snd_seq;
  4.       u32 snd_pid;
  5.       struct nlmsghdr * nlhdr;
  6.       struct genlmsghdr * genlhdr;
  7.       void * userhdr;
  8.       struct nlattr ** attrs;
  9.  };
* snd_seq:发送序号                

                 * snd_pid:发送客户端的PID               

                 * nlhdr:netlink header的指针                

                 * genlmsghdr:genl头部的指针(即family头部)                

                 * userhdr:用户自定义头部指针                

                * attrs:attrs,如果定义了genl_ops->policy,这里的attrs是被policy过滤以后的结果。在完成了操作以后,如果 执行正确,返回0;否则,返回一个负数。负数的返回值会触发NLMSG_ERROR消息。当genl_ops的flag标志被添加了 NLMSG_ERROR时,即使doit返回0,也会触发NLMSG_ERROR消息。

  • dumpit

这是一个回调函数,当genl_ops的flag标志被添加了NLM_F_DUMP以后,每次收到genl消息即会回触发这个函数。 dumpit与doit的区别是:dumpit的第一个参数skb不会携带从客户端发来的数据。相反地,开发者应该在skb中填入需要传给客户端的数据, 然后,并skb的数据长度(可以用skb->len)return。skb中携带的数据会被自动送到客户端。只要dumpit的返回值大于 0,dumpit函数就会再次被调用,并被要求在skb中填入数据。当服务端没有数据要传给客户端时,dumpit要返回0。如果函数中出错,要求返回一 个负值。关于doit和dumpit的触发过程,可以查看源码中的genl_rcv_msg函数。

  • ops_list

为私有字段,由系统自动配置,开发者不需要做配置。

3 Generic Netlink服务端(内核)初始化

初始化Generic Netlink的过程分为以下四步:定义family,定义operation,注册family,注册operation。下面通过一个简单例子来说明 如何完成Generic Netlink的初始化。我们首先创建一个genl_family结构体的实例。我们在这里定义一个名为"DOC_EXMPL"的family


点击(此处)折叠或打开

  1. /* attribute type */
  2.   enum {
  3.         DOC_EXMPL_A_UNSPEC,
  4.         DOC_EXMPL_A_MSG,
  5.         __DOC_EXMPL_A_MAX,
  6.   };
  7.   #define DOC_EXMPL_A_MAX (__DOC_EXMPL_A_MAX - 1)

  8.   /* family definition */
  9.   static struct genl_family doc_exmpl_gnl_family = {
  10.         .id = GENL_ID_GENERATE,
  11.         .hdrsize = 0,
  12.         .name = "DOC_EXMPL",
  13.         .version = 1,
  14.         .maxattr = DOC_EXMPL_A_MAX,

  15.   };
以上,我们定义了一个仅有一种attribuste type的family。.id被配置为GENL_ID_GENERATE,指示genl控制器自动分配一个id。

第二步为family创建operations。我们至少要创建一个genl_ops结构体的实例。

点击(此处)折叠或打开

  1. /* doit handler */
  2.   int doc_exmpl_echo(struct sk_buff *skb, struct genl_info *info)
  3.   {
  4.         /* message handling code goes here; return 0 on success, negative
  5.          * values on failure */
  6.   }


  7.   /* attribute policy */
  8.   static struct nla_policy doc_exmpl_genl_policy = [DOC_EXMPL_A_MAX + 1] = {
  9.         [DOC_EXMPL_A_MSG] = { .type = NLA_NUL_STRING },
  10.   }

  11.   /* commands */
  12.   enum {
  13.         DOC_EXMPL_C_UNSPEC,
  14.         DOC_EXMPL_C_ECHO,
  15.         __DOC_EXMPL_C_ECHO,
  16.   };
  17.   #define DOC_EXMPL_C_MAX (__DOC_EXMPL_C_MAX - 1)

  18.   /* operation definition */
  19.   struct genl_ops doc_exmpl_gnl_ops_echo = {
  20.         .cmd = DOC_EXMPL_C_ECHO,
  21.         .flags = 0,
  22.         .policy = doc_exmpl_genl_policy,
  23.         .doit = genl_recv_doit,
  24.         .dumpit = NULL,
  25.   }
这里,我们把attribute policy设为NLA_NUL_STRING,表示attr中数据的属性为无NULL结尾的字符串。控制器在收到数据时会自动完成这一类型检查。

我们定义一个operation,它的id为DOC_EXMPL_C_ECHO,把上述的policy配置给它。一旦本family的genl消息在被总到genl总线上,doit函数(doc_exmpl_echo)会被调用。

接下来两步是注册family和注册operations。

genl_register_family(&doc_exmpl_gnl_family);

genl_register_ops(&doc_exmpl_gnl_family, &doc_exmpl_gnl_ops_echo);

在完成genl操作后,记对完成对family的注销操作。

genl_unregister_family(&doc_exmpl_gnl_family);

4 Generic Netlink客户端(用户空间)初始化
Generic Netlink在用户空间的初始化和通常的socket通信一致。大致分为两步,创建socket,把socket绑定到地址上(bind)。

下面也通过一个例子简要说明一下用户空间genl初始化的过程。

点击(此处)折叠或打开

  1. struct sockaddr_nl saddr;
  2.     int sock;
  3.     sock = socket(AF_NETLINK, SOCK_RAW, NETLINK_GENERIC);

  4.     if (sock < 0) {
  5.         return -1;
  6.     }

  7.     memset(&saddr, 0, sizeof(saddr));
  8.     saddr.nl_family = AF_NETLINK;
  9.     saddr.nl_pid = getpid();
  10.     if (bind(sock, (struct sockaddr*)&saddr, sizeof(saddr)) < 0) {
  11.         printf("bind fail!\n");
  12.         close(*p_sock);
  13.         return -1;
  14.     }
上述代码中,我们先创建一个socket,注意,第一个参数必须为AF_NETLINK 或 PF_NETLINK,表示创建netlink socket,第二个参数必须是SOCK_RAW或SOCK_DGRAM, 第三个参数指定netlink协议类型,我们要使用generic netlink,那么就要将其设置为:NETLINK_GENERIC。

接下来,对于genl不可缺少的一步就是获取family id。family id是服务端注册family时,由控制器自动分配的。此时客户端尚不知道family id为多少,因此需要向客户端请求family id。

下面是一段获取family id的函数

点击(此处)折叠或打开

  1. static int genl_get_family_id(int sd, char *family_name)
  2. {
  3.     msgtemplate_t ans;
  4.     int id, rc;
  5.     struct nlattr *na;
  6.     int rep_len;

  7.     rc = genl_send_msg(sd, GENL_ID_CTRL, 0, CTRL_CMD_GETFAMILY, 1,
  8.                     CTRL_ATTR_FAMILY_NAME, (void *)family_name,
  9.                     strlen(family_name)+1);

  10.     rep_len = recv(sd, &ans, sizeof(ans), 0);
  11.     if (rep_len < 0) {
  12.         return 0;
  13.     }
  14.     if (ans.n.nlmsg_type == NLMSG_ERROR || !NLMSG_OK((&ans.n), rep_len)) {
  15.         return 0;
  16.     }

  17.     na = (struct nlattr *) GENLMSG_DATA(&ans);
  18.     na = (struct nlattr *) ((char *) na + NLA_ALIGN(na->nla_len));
  19.     if (na->nla_type == CTRL_ATTR_FAMILY_ID) {
  20.         id = *(__u16 *) NLA_DATA(na);
  21.     } else {
  22.         id = 0;
  23.     }

  24.     return id;
  25. }
在这个函数中,调用genl_send_msg(这个函数会在下文中介绍并给出源码)发送请求family id的消息,并调用recv接收服务端的反馈消息。这个消息中即包含了family id。

这个函数的第一个参数是已创建好的socket。第二个参数是family name,注意这里family name需要与服务端注册famile时的name字段一致。该函数返回值即是family id以下是一个调用示例。
int fid = genl_get_family_id(sock, "DOC_EXMPL");
5 Generic Netlink通信
这一节对如何使用Generic Netlink完成内核空间与用户空间的通信做介绍。并把我的示例代码贡献出来。

示例代码呈现了内核(服务端)和用户空间(客户端)收发数据的过程。
5.1 内核发送数据
以下是内核端发送数据的源码。在genl_msg_send_to_user中,调用genl_msg_prepare_usr_msg和 genl_msg_mk_usr_msg来准备socket buffer,为数据加上各种数据头(参考图2)。genlmsg_end把整个数据打包完成,通过genlmsg_unicast完成单播发送。

点击(此处)折叠或打开

  1. /**
  2. * genl_msg_send_to_user - 通过generic netlink发送数据到netlink
  3. *
  4. * @data: 发送数据缓存
  5. * @len: 数据长度 单位:byte
  6. * @pid: 发送到的客户端pid
  7. *
  8. * return:
  9. * 0: 成功
  10. * -1: 失败
  11. */
  12. int genl_msg_send_to_user(void *data, int len, pid_t pid)
  13. {
  14.     struct sk_buff *skb;
  15.     size_t size;
  16.     void *head;
  17.     int rc;

  18.     size = nla_total_size(len); /* total length of attribute including padding */

  19.     rc = genl_msg_prepare_usr_msg(DOC_EXMPL_C_ECHO, size, pid, &skb);

  20.     if (rc) {
  21.         return rc;
  22.     }

  23.     rc = genl_msg_mk_usr_msg(skb, DOC_EXMPL_A_MSG, data, len);

  24.     if (rc) {
  25.         kfree_skb(skb);
  26.         return rc;
  27.     }

  28.     head = genlmsg_data(nlmsg_data(nlmsg_hdr(skb)));

  29.     rc = genlmsg_end(skb, head);
  30.     if (rc < 0) {
  31.         kfree_skb(skb);
  32.         return rc;
  33.     }

  34.     rc = genlmsg_unicast(&init_net, skb, pid);
  35.     if (rc < 0) {
  36.         return rc;
  37.     }

  38.     return 0;
  39. }


  40. static inline int genl_msg_mk_usr_msg(struct sk_buff *skb, int type, void *data, int len)
  41. {
  42.     int rc;

  43.     /* add a netlink attribute to a socket buffer */
  44.     if ((rc = nla_put(skb, type, len, data)) != 0) {
  45.         return rc;
  46.     }
  47.     return 0;
  48. }

  49. static inline int genl_msg_prepare_usr_msg(u8 cmd, size_t size, pid_t pid, struct sk_buff **skbp)
  50. {
  51.     struct sk_buff *skb;

  52.     /* create a new netlink msg */
  53.     skb = genlmsg_new(size, GFP_KERNEL);
  54.     if (skb == NULL) {
  55.         return -ENOMEM;
  56.     }

  57.     /* Add a new netlink message to an skb */
  58.     genlmsg_put(skb, pid, 0, &genl_family, 0, cmd);

  59.     *skbp = skb;
  60.     return 0;
  61. }
5.2 用户空间接收数据
客户端调用通用的recv函数即可完成从内核来的数据的接收。需要注意的是,接收到的数据包含几级的header(图3),我们需要准确地定位到我们所需数据的位置。

当没有用户自定义头部(即图3中的User Msg,在注册family时把hdrsize置0)时,可以构建这样的数据结构用于接收数据。这样,收到的数据中的netlink header和genl header就被很容易地剥离开来。

点击(此处)折叠或打开

  1. typedef struct msgtemplate {
  2.     struct nlmsghdr n;
  3.     struct genlmsghdr g;
  4.     char data[MAX_MSG_SIZE];
  5. } msgtemplate_t;
下面是客户端接收数据函数的源码:

点击(此处)折叠或打开

  1. #define GENLMSG_DATA(glh) ((void *)(NLMSG_DATA(glh) + GENL_HDRLEN))
  2. #define NLA_DATA(na) ((void *)((char *)(na) + NLA_HDRLEN))

  3. void genl_rcv_msg(int fid, int sock, char **string)
  4. {
  5.     int ret;
  6.     struct msgtemplate msg;
  7.     struct nlattr *na;

  8.     ret = recv(sock, &msg, sizeof(msg), 0);
  9.     if (ret < 0) {
  10.         return;
  11.     }
  12.     //printf("received length %d\n", ret);
  13.     if (msg.n.nlmsg_type == NLMSG_ERROR || !NLMSG_OK((&msg.n), ret)) {
  14.         return;
  15.     }
  16.     if (msg.n.nlmsg_type == fid && fid != 0) {
  17.         na = (struct nlattr *) GENLMSG_DATA(&msg);
  18.         *string = (char *)NLA_DATA(na);
  19.     }
  20. }
以上函数中,第一个参数为family id,第二个参数为socket,第三个参数为待接收数据的buffer。

5.3 用户空间发送数据
客户端发送数据简单地说就是调用通用的socket API---sendto来发送数据

点击(此处)折叠或打开

  1. /**
  2. * genl_send_msg - 通过generic netlink给内核发送数据
  3. *
  4. * @sd: 客户端socket
  5. * @nlmsg_type: family_id
  6. * @nlmsg_pid: 客户端pid
  7. * @genl_cmd: 命令类型
  8. * @genl_version: genl版本号
  9. * @nla_type: netlink attr类型
  10. * @nla_data: 发送的数据
  11. * @nla_len: 发送数据长度
  12. *
  13. * return:
  14. * 0: 成功
  15. * -1: 失败
  16. */
  17. int genl_send_msg(int sd, u_int16_t nlmsg_type, u_int32_t nlmsg_pid,
  18.         u_int8_t genl_cmd, u_int8_t genl_version, u_int16_t nla_type,
  19.         void *nla_data, int nla_len)
  20. {
  21.     struct nlattr *na;
  22.     struct sockaddr_nl nladdr;
  23.     int r, buflen;
  24.     char *buf;
  25.     msgtemplate_t msg;


  26.     if (nlmsg_type == 0) {
  27.         return 0;
  28.     }

  29.     msg.n.nlmsg_len = NLMSG_LENGTH(GENL_HDRLEN);
  30.     msg.n.nlmsg_type = nlmsg_type;
  31.     msg.n.nlmsg_flags = NLM_F_REQUEST;
  32.     msg.n.nlmsg_seq = 0;
  33.     /*
  34.      * nlmsg_pid是发送进程的端口号。
  35.      * Linux内核不关心这个字段,仅用于跟踪消息。
  36.      */
  37.     msg.n.nlmsg_pid = nlmsg_pid;
  38.     msg.g.cmd = genl_cmd;
  39.     msg.g.version = genl_version;
  40.     na = (struct nlattr *) GENLMSG_DATA(&msg);
  41.     na->nla_type = nla_type;
  42.     na->nla_len = nla_len + 1 + NLA_HDRLEN;
  43.     memcpy(NLA_DATA(na), nla_data, nla_len);
  44.     msg.n.nlmsg_len += NLMSG_ALIGN(na->nla_len);

  45.     buf = (char *) &msg;
  46.     buflen = msg.n.nlmsg_len ;
  47.     memset(&nladdr, 0, sizeof(nladdr));
  48.     nladdr.nl_family = AF_NETLINK;
  49.     while ((r = sendto(sd, buf, buflen, 0, (struct sockaddr *) &nladdr
  50.             , sizeof(nladdr))) < buflen) {
  51.         if (r > 0) {
  52.             buf += r;
  53.             buflen -= r;
  54.         } else if (errno != EAGAIN) {
  55.             return -1;
  56.         }
  57.     }
  58.     return 0;
  59. }
5.4 内核接收数据
内核端一旦收到generic netlink数据,会触发doit函数运行(上文第3节有提及doit的初始化方法)。

doit传入两个参数,skb即是接收到的数据,info包含了Genl消息的一些常用指针。这两个结构体字段详见内核源码。

skb收到的数据还包括了多层的包头,以下程序中的nlmsg_hdr,nlmsg_data,genlmsg_data,nla_data即是把这些包头层层剥开,para->string指向的数据即是用用户空间传来的“纯数据”。

点击(此处)折叠或打开

  1. int genl_recv_doit(struct sk_buff *skb, struct genl_info *info)
  2. {
  3.     /* doit 没有运行在中断上下文 */
  4.     static int kthread_num = 0;
  5.     struct nlmsghdr *nlhdr;
  6.     struct genlmsghdr *genlhdr;
  7.     struct nlattr *nlh;
  8.     struct thread_para *para; /* 给线程传递参数的结构体 */
  9.     
  10.      nlhdr = nlmsg_hdr(skb);
  11.      genlhdr = nlmsg_data(nlhdr);
  12.      nlh = genlmsg_data(genlhdr);
  13.     /* 配置给新开线程所传的参数 */
  14.     /* para 在线程函数thread_string_proc中释放 */
  15.     para = (struct thread_para *)kmalloc(sizeof(struct thread_para), GFP_KERNEL);
  16.     para->string = nla_data(nlh);
  17.     para->pid = nlhdr->nlmsg_pid;
  18.     
  19.     /* 每收到一个字符串开辟一个线程 */
  20.     kthread_run(thread_string_proc, (void *)(para), "kthread %d", kthread_num++);
  21.     
  22.     return 0;
  23. }













阅读(1469) | 评论(0) | 转发(0) |
0

上一篇:Linux Netlink基本使用

下一篇:连接跟踪

给主人留下些什么吧!~~