4. 新旧内核API差异：核心API变更模式与兼容性宏

在Linux内核长达三十年的演进中，网络协议栈的API经历了多次重构与优化。当驱动程序或内核模块需要在多个内核版本间移植时，理解API变更的三种核心模式——参数增减、结构体字段变化、函数重命名——是编写兼容代码的基础。本章将系统梳理这些变更模式，并深入讲解#ifdef、IS_ENABLED等兼容性宏的正确使用方法。

4.1 核心API变更模式

内核社区遵循“不破坏用户空间”的原则，但内核内部API（KAPI）允许在主要版本间发生不兼容变更。以下三种模式覆盖了超过90%的兼容性问题场景。

4.1.1 参数增减

函数签名变化是最常见的API变更。典型场景包括：增加新的标志位参数、添加gfp_t内存分配掩码、或移除已废弃的参数。

4.1.2 结构体字段变化

结构体字段的增删改直接影响内存布局和偏移量。网络协议栈中，struct sock、struct sk_buff、struct net_device等核心结构体几乎每个大版本都有字段调整。

以下SVG展示了struct sk_buff在三个内核版本中的字段布局演变：

4.1.3 函数重命名

函数重命名通常伴随语义澄清或命名空间规范化。例如，skb_linearize()在v4.7被重命名为skb_linearize()（实际未变），但dev_kfree_skb()系列函数经历了多次重命名：

4.2 常见兼容性宏

Linux内核提供了丰富的预编译机制来处理版本差异。正确使用这些宏是编写可移植内核模块的基础。

4.2.1 #ifdef / #ifndef 版本检测

最直接的兼容性手段是通过检测内核版本宏或特定功能宏来决定编译路径。

/* 检测内核版本，选择正确的函数名 */
#include <linux/version.h>

#if LINUX_VERSION_CODE >= KERNEL_VERSION(3,14,0)
    /* 新内核：使用 kfree_skb() */
    kfree_skb(skb);
#else
    /* 旧内核：使用 dev_kfree_skb() */
    dev_kfree_skb(skb);
#endif

/* 检测特定功能是否被 backport */
#ifdef CONFIG_XPS
    /* 支持发送包 steering */
    netdev_reset_tc(dev);
#endif

4.2.2 IS_ENABLED() 运行时检测

IS_ENABLED()宏在v3.14引入，用于在运行时检测内核编译选项是否启用。与#ifdef的编译期决策不同，IS_ENABLED()允许同一份二进制代码根据运行时条件选择路径。

/* IS_ENABLED() 用法示例 */
#include <linux/kconfig.h>

void my_netfilter_hook(void)
{
    /* 编译期：两个分支都会被编译 */
    /* 运行时：根据 CONFIG_NETFILTER 是否为 y 或 m 决定 */
    if (IS_ENABLED(CONFIG_NETFILTER)) {
        /* Netfilter 可用路径 */
        nf_register_hook(&my_hook);
    } else {
        /* 回退路径 */
        pr_warn("Netfilter not available\n");
    }
}

/* 与 #ifdef 的对比 */
#ifdef CONFIG_NETFILTER
    /* 编译期：CONFIG_NETFILTER 未设置时，此块完全不存在 */
    nf_register_hook(&my_hook);
#endif

以下SVG展示了#ifdef与IS_ENABLED()在编译和运行时的行为差异：

4.2.3 其他兼容性宏

4.3 实战：兼容性宏组合模式

在实际项目中，单一宏往往不足以应对复杂场景。以下是一个处理dev_queue_xmit()参数变化的兼容性代码模板：

/* 兼容 dev_queue_xmit() 参数变化 */
#include <linux/version.h>
#include <linux/netdevice.h>

static inline int my_dev_queue_xmit(struct sk_buff *skb,
                                    struct net_device *sb_dev,
                                    __u16 queue_mapping)
{
#if LINUX_VERSION_CODE >= KERNEL_VERSION(5,10,0)
    /* v5.10+ : 三个参数版本 */
    return dev_queue_xmit(skb, sb_dev, queue_mapping);
#elif LINUX_VERSION_CODE >= KERNEL_VERSION(3,14,0)
    /* v3.14 ~ v5.9 : 两个参数版本 */
    return dev_queue_xmit(skb, sb_dev);
#else
    /* v3.14 之前 : 单参数版本 */
    return dev_queue_xmit(skb);
#endif
}

/* 使用示例 */
void my_packet_send(struct sk_buff *skb)
{
    int ret = my_dev_queue_xmit(skb, NULL, 0);
    if (ret)
        pr_err("xmit failed: %d\n", ret);
}

4.4 兼容性调试检查清单

• 编译阶段：使用make oldconfig确保内核配置一致；检查include/linux/version.h中的版本宏定义。
• 链接阶段：使用nm或objdump验证导出的符号是否存在：nm /lib/modules/$(uname -r)/build/Module.symvers | grep dev_queue_xmit。
• 运行时阶段：使用printk或trace_printk输出实际执行的代码路径；通过/sys/kernel/debug/tracing跟踪函数调用。
• 结构体布局：使用pahole工具检查结构体字段偏移：pahole -C sk_buff /lib/modules/$(uname -r)/build/vmlinux。