DPDK rte_acl 学习踩坑及示例

最近开始需要用 DPDK ACL 来实现一些如包负载长度匹配的需求，因此开始学习 ACL 相关的内容，刚开始上手觉得还是挺难的，花了大概三四天看了官方的文档和一些示例，大概搞明白了 ACL 的用法，也踩了一些坑，这篇博客记录下这段时间的学习内容，最后提供了一个我写的小例子来参考。

rte_acl_field_def

要用 ACL 首先要定义规则的结构，这里会用到 rte_acl_field_def 结构体，下面解释一下各个字段的含义：

1. type：有三种取值：

取值	含义
RTE_ACL_FIELD_TYPE_BITMASK	和 MASK 不同，MASK 里 mask_range 表示的是掩码的长度，而 BITMASK 的 mask_range 则是实际用 bit 表示的掩码，通常我们用于协议号的匹配，比如要匹配的协议号是 0x6，则 value 为 0x6,mask_range 为 0xff 即可，value 和 range 全 0 表示匹配所有
RTE_ACL_FIELD_TYPE_MASK	字段值/掩码，非常像带掩码的 IP 地址，一般也是用来匹配 IP 地址，mask 是掩码的长度，value 和 range 全 0 表示匹配所有的 IP 地址
RTE_ACL_FIELD_TYPE_RANGE	用来一个范围，比如端口范围，value 和 mask 是上下限，value 为 0，range 为 65535 表示匹配所有端口，value 和 range 为同一个值则表示匹配一个具体的数值

这里的掩码和 range 类型实际上给我们提供了挺大的灵活性，可以实现诸如 ip 范围匹配，端口的大于等于等逻辑，还是非常给力的。

2. size
   表示字段的大小，可以是 1、2、4、8 个字节，不可以随意设置

3. field_index
   该字段是第几个字段，通常和下面的示例一样定义一个 enum 递增就可以了，没啥好说的

4. input_index
   该字段属于那个分组，这里有一个坑，ACL 要求第一个字段一定是 1 个字节大小，后面的要字段要 4 个字节为一个分组，不满的要自己凑齐

5. offset
   该字段在待匹配数据中的偏移

RTE_ACL_RULE_DEF

这是一个宏定义，可以根据我们之前写的 rte_acl_field_def 生成对应的规则结构体，然后你就可以定义这样的结构体并往里填充数据了

ACL 使用流程

1. 定义规则结构和匹配数据结构
2. 创建 ACL 的上下文
3. 添加规则到 ACL 上下文中
4. 编译 ACL 规则
5. 进行报文数据匹配
6. 销毁 ACL 上下文

字节序问题

ACL 中添加规则用的是小端序，而匹配时数据需要大端序

IPV4 匹配示例代码

#include <netinet/in.h>
#include <rte_acl.h>
#include <rte_eal.h>
#include <rte_ip.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#define ACL_MAX_RULE_NUM 1000

struct pkt_data {
   
   
    uint8_t proto;
    uint32_t ip1;
    uint32_t ip2;
    uint16_t port1;
    uint16_t port2;
};

enum {
   
    PROTO_FIELD_IPV4, SRC_FIELD_IPV4, DST_FIELD_IPV4, SRCP_FIELD_IPV4, DSTP_FIELD_IPV4, NUM_FIELDS_IPV4 };

enum {
   
    ACL_IPV4_PROTO = 0, ACL_IPV4_SRC, ACL_IPV4_DST, ACL_IPV4_PORTS, ACL_IPV4_NUM };
struct rte_acl_field_def ipv4_defs[NUM_FIELDS_IPV4] = {
   
   
    {
   
   
        .type = RTE_ACL_FIELD_TYPE_BITMASK,
        .size = sizeof(uint8_t),
        .field_index = PROTO_FIELD_IPV4,
        .input_index = ACL_IPV4_PROTO,
        .offset = offsetof(struct pkt_data, proto),
    },
    {
   
   
        .type = RTE_ACL_FIELD_TYPE_MASK,
        .size = sizeof(uint32_t),
        .field_index = SRC_FIELD_IPV4,
        .input_index = ACL_IPV4_SRC,
        .offset = offsetof(struct pkt_data, ip1),
    },
    {
   
   
        .type = RTE_ACL_FIELD_TYPE_MASK,
        .size = sizeof(