int vnet_app_add_cert_key_pair (vnet_app_add_cert_key_pair_args_t * a) { app_cert_key_pair_t *ckpair = app_cert_key_pair_alloc (); vec_validate (ckpair->cert, a->cert_len - 1); clib_memcpy_fast (ckpair->cert, a->cert, a->cert_len); vec_validate (ckpair->key, a->key_len - 1); clib_memcpy_fast (ckpair->key, a->key, a->key_len); a->index = ckpair->cert_key_index; return 0; }

void vnet_send_dns_request(vlib_main_t *vm, dns_main_t *dm, dns_cache_entry_t *ep): 该函数用于发送DNS请求。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - ep：指向DNS缓存条目的指针。 int vnet_dns_cname_indirection_nolock(vlib_main_t *vm, dns_main_t *dm, u32 ep_index, u8 *reply): 该函数用于处理DNS CNAME间接寻址。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - ep_index：DNS缓存条目索引。 - reply：DNS回复消息。 int vnet_dns_delete_entry_by_index_nolock(dns_main_t *dm, u32 index): 该函数用于删除指定索引的DNS缓存条目。参数含义如下： - dm：指向DNS主结构的指针。 - index：DNS缓存条目索引。 int vnet_dns_resolve_name(vlib_main_t *vm, dns_main_t *dm, u8 *name, dns_pending_request_t *t, dns_cache_entry_t **retp): 该函数用于解析DNS名称。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - name：DNS名称。 - t：DNS挂起请求。 - retp：指向DNS缓存条目指针的指针。 void vnet_dns_send_dns6_request(vlib_main_t *vm, dns_main_t *dm, dns_cache_entry_t *ep, ip6_address_t *server): 该函数用于发送IPv6的DNS请求。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - ep：指向DNS缓存条目的指针。 - server：IPv6地址。 void vnet_dns_send_dns4_request(vlib_main_t *vm, dns_main_t *dm, dns_cache_entry_t *ep, ip4_address_t *server): 该函数用于发送IPv4的DNS请求。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - ep：指向DNS缓存条目的指针。 - server：IPv4地址。 void vnet_send_dns4_reply(vlib_main_t *vm, dns_main_t *dm, dns_pending_request_t *t, dns_cache_entry_t *ep, vlib_buffer_t *b0): 该函数用于发送IPv4的DNS回复。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - t：DNS挂起请求。 - ep：DNS缓存条目。 - b0：VLIB缓冲区。 void vnet_send_dns6_reply(vlib_main_t *vm, dns_main_t *dm, dns_pending_request_t *t, dns_cache_entry_t *ep, vlib_buffer_t *b0): 该函数用于发送IPv6的DNS回复。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。 - t：DNS挂起请求。 - ep：DNS缓存条目。 - b0：VLIB缓冲区。 u8 *vnet_dns_labels_to_name(u8 *label, u8 *full_text, u8 **parse_from_here): 该函数用于将DNS标签转换为名称。参数含义如下： - label：DNS标签。 - full_text：完整文本。 - parse_from_here：从此处开始解析。 void vnet_dns_create_resolver_process(vlib_main_t *vm, dns_main_t *dm): 该函数用于创建DNS解析器进程。参数含义如下： - vm：指向VLIB主结构的指针。 - dm：指向DNS主结构的指针。

我们先从整体上分析这段代码的用途和作用，然后逐步展开并解释宏的具体内容。 --- ### 宏的作用 `VNET_FEATURE_INIT` 是一个用于注册功能模块（features）到 VPP 网络栈的宏。它允许开发者将某个节点（如 `snort-enq` 节点）插入到指定弧线（arc）的工作流中，并可以规定该节点在其他节点之前运行。 在这个例子中： ```c VNET_FEATURE_INIT(snort_enq, static) = { .arc_name = "ip4-unicast", .node_name = "snort-enq", .runs_before = VNET_FEATURES("ip4-lookup"), }; ``` 这条声明的意思是： - 注册名为 `"snort-enq"` 的节点。 - 将其加入到弧线 `"ip4-unicast"` 中。 - 并且保证该节点会在 `"ip4-lookup"` 节点之前运行。 接下来，我们将逐步展开 `VNET_FEATURE_INIT` 宏的内容。 --- ### 展开宏的过程 #### 第一步：定义静态变量 ```c __VA_ARGS__ vnet_feature_registration_t vnet_feat_snort_enq; ``` 这里通过 `__VA_ARGS__` 替换掉传入的第一个参数 `static`，因此等价于： ```c static vnet_feature_registration_t vnet_feat_snort_enq; ``` 这是一个全局范围内的静态变量，类型为 `vnet_feature_registration_t`，它的名字由 `vnet_feat_ + x` 组成（这里是 `vnet_feat_snort_enq`）。 --- #### 第二步：构造函数——添加功能注册表项 ```c static void __vnet_add_feature_registration_snort_enq (void) __attribute__((__constructor__)); ``` 这是一段 **构造函数**，利用 GCC 扩展 `__attribute__((__constructor__))` 实现。这意味着当程序启动时，这段代码会被自动执行一次。 进入函数体内： ```c { vnet_feature_main_t * fm = &feature_main; vnet_feat_snort_enq.next = fm->next_feature; fm->next_feature = &vnet_feat_snort_enq; } ``` 上述代码实现了以下步骤： 1. 获取当前特征管理主结构体指针 `&feature_main`。 2. 把新创建的功能条目 `vnet_feat_snort_enq` 添加到链表头部（即将其作为第一个元素）。 --- #### 第三步：析构函数——移除功能注册表项 ```c static void __vnet_rm_feature_registration_snort_enq (void) __attribute__((__destructor__)); ``` 这是对应的 **析构函数**，同样借助 GCC 扩展 `__attribute__((__destructor__))` 实现。当进程退出时，这段代码会被自动调用。 进入函数体内： ```c { vnet_feature_main_t * fm = &feature_main; vnet_feature_registration_t *r = &vnet_feat_snort_enq; VLIB_REMOVE_FROM_LINKED_LIST(fm->next_feature, r, next); } ``` 上述代码完成了以下任务： 1. 再次获取特征管理主结构体地址 `&feature_main`。 2. 查找需要删除的功能条目 `vnet_feat_snort_enq`。 3. 使用辅助宏 `VLIB_REMOVE_FROM_LINKED_LIST` 将该条目从链表中安全地卸载。 --- #### 最终生成完整的静态变量定义 最后，宏还会补充完成这个静态变量的实际赋值过程： ```c static vnet_feature_registration_t vnet_feat_snort_enq = { .arc_name = "ip4-unicast", /* 弧线名称 */ .node_name = "snort-enq", /* 节点名称 */ .runs_before = {"ip4-lookup"}, /* 需要在 ip4-lookup 之前运行 */ }; ``` 至此，整个宏已经被完整展开！ --- ### 总结 经过展开后的结果如下所示： ```c // 全局静态变量 static vnet_feature_registration_t vnet_feat_snort_enq; // 构造函数：注册 feature 到链表头 static void __vnet_add_feature_registration_snort_enq(void) __attribute__((__constructor__)); static void __vnet_add_feature_registration_snort_enq(void) { vnet_feature_main_t *fm = &feature_main; vnet_feat_snort_enq.next = fm->next_feature; fm->next_feature = &vnet_feat_snort_enq; } // 析构函数：从链表中移除已注册的 feature static void __vnet_rm_feature_registration_snort_enq(void) __attribute__((__destructor__)); static void __vnet_rm_feature_registration_snort_enq(void) { vnet_feature_main_t *fm = &feature_main; vnet_feature_registration_t *r = &vnet_feat_snort_enq; VLIB_REMOVE_FROM_LINKED_LIST(fm->next_feature, r, next); } // 初始化静态变量 static vnet_feature_registration_t vnet_feat_snort_enq = { .arc_name = "ip4-unicast", .node_name = "snort-enq", .runs_before = {"ip4-lookup"}, }; ``` ---