3. l3fwd 核心数据结构：路由表、LPM 库、mbuf 与 rte_flow

l3fwd 示例应用的核心是高效的数据结构设计。理解这些结构及其交互关系，是定位路由故障（如表项缺失）和 NIC 丢包问题的前提。本章深入剖析路由表、LPM 库、mbuf 和 rte_flow 四大核心组件。

3.1 路由表与 LPM 库

l3fwd 使用 DPDK LPM（Longest Prefix Match，最长前缀匹配）库实现 IPv4 路由查找。LPM 库在软件层面通过两级哈希表（tbl24 + tbl8）实现 O(1) 查找性能。

3.1.1 LPM 路由表结构

3.1.2 LPM 路由表初始化与配置

以下代码展示了 l3fwd 中 LPM 路由表的创建与规则添加流程：

// 创建 LPM 路由表
struct rte_lpm_config lpm_conf = {
    .max_rules = 1024,          // 最大规则数
    .number_tbl8s = 256,        // tbl8 表数量
    .flags = 0,
};
struct rte_lpm *lpm = rte_lpm_create("l3fwd_lpm", SOCKET_ID_ANY, &lpm_conf);
if (lpm == NULL) {
    rte_exit(EXIT_FAILURE, "Unable to create LPM table\n");
}

// 添加路由规则
struct rte_lpm_rule rule = {
    .ip = IPv4(192, 168, 1, 0),
    .depth = 24,
    .next_hop = port_id,  // 出口端口 ID
};
int ret = rte_lpm_add(lpm, rule.ip, rule.depth, rule.next_hop);
if (ret < 0) {
    printf("Failed to add route: %d\n", ret);
}

3.2 mbuf：报文缓冲区

mbuf 是 DPDK 中报文存储的基本单元。l3fwd 在转发路径中频繁操作 mbuf，其结构完整性直接影响转发正确性。

3.2.1 mbuf 关键字段

3.2.2 l3fwd 中的 mbuf 处理流程

static void l3fwd_simple_forward(struct rte_mbuf *m, uint16_t portid) {
    struct rte_ether_hdr *eth_hdr;
    struct rte_ipv4_hdr *ip_hdr;
    uint32_t dst_ip;
    uint16_t next_hop;

    // 1. 解析以太网头
    eth_hdr = rte_pktmbuf_mtod(m, struct rte_ether_hdr *);
    // 2. 解析 IP 头（跳过以太网头）
    ip_hdr = (struct rte_ipv4_hdr *)(eth_hdr + 1);
    dst_ip = rte_be_to_cpu_32(ip_hdr->dst_addr);
    // 3. LPM 路由查找
    if (rte_lpm_lookup(lpm, dst_ip, &next_hop) == 0) {
        // 4. 更新 MAC 地址并转发
        update_mac_and_send(m, next_hop);
    } else {
        // 路由未命中，丢包
        rte_pktmbuf_free(m);
    }
}

3.3 rte_flow：硬件流规则

rte_flow 是 DPDK 的硬件卸载框架。l3fwd 在支持 rte_flow 的 NIC 上，可将路由规则卸载到硬件，实现线速转发。

3.3.1 rte_flow 规则结构

3.3.2 l3fwd 中 rte_flow 的典型用法

// 创建 rte_flow 规则：将目的 IP 为 192.168.1.0/24 的流量定向到队列 0
struct rte_flow_attr attr = { .ingress = 1 };
struct rte_flow_item pattern[3] = {
    { .type = RTE_FLOW_ITEM_TYPE_ETH },
    { .type = RTE_FLOW_ITEM_TYPE_IPV4,
      .spec = &ipv4_spec, .mask = &ipv4_mask },
    { .type = RTE_FLOW_ITEM_TYPE_END },
};
struct rte_flow_action actions[2] = {
    { .type = RTE_FLOW_ACTION_TYPE_QUEUE,
      .conf = &(struct rte_flow_action_queue){ .index = 0 } },
    { .type = RTE_FLOW_ACTION_TYPE_END },
};
struct rte_flow_error error;
struct rte_flow *flow = rte_flow_create(port_id, &attr, pattern, actions, &error);
if (flow == NULL) {
    printf("Flow create failed: %s\n", error.message);
}

3.4 核心数据结构交互关系

下图展示了 l3fwd 中 mbuf、LPM 和 rte_flow 之间的数据流与交互关系：

3.5 数据结构故障排查清单

1. LPM 表项缺失： 使用 rte_lpm_lookup 返回值判断。若返回 -EINVAL，检查 IP 地址字节序；若返回 -ENOENT，确认路由已通过 rte_lpm_add 添加。
2. mbuf 解析错误： 打印 m->packet_type 确认 DPDK 硬件解析结果。若为 0，说明 NIC 未启用硬件解析，需软件解析。
3. rte_flow 规则失效： 使用 rte_flow_query 查询规则统计，确认匹配计数是否增长。若计数为 0，检查 pattern 中 IP 掩码是否正确。
4. NIC 丢包： 读取 rte_eth_stats 中的 imissed 字段。若该值持续增长，说明 NIC 内部 FIFO 溢出，需增大 RX 描述符数量。