2、内核参数传递机制：内核命令行(cmdline)的组成与传递路径

内核命令行（Kernel Command Line，简称 cmdline）是系统启动早期，由 bootloader 传递给 Linux 内核的一段纯文本参数列表。这些参数决定了内核如何初始化硬件、挂载根文件系统、设置调试级别以及 systemd 如何接管用户空间。理解 cmdline 的组成与传递路径，是掌握 systemd 初始化阶段调试的基石。

2.1 内核命令行的组成结构

内核命令行本质上是一个以空格分隔的键值对或标志位字符串。其语法规则简单但严格：

• 键值对参数：格式为 key=value，例如 root=/dev/sda1、console=tty0。
• 标志位参数：仅包含键名，无等号与值，例如 quiet、nosplash、single。
• 带引号的值：如果值包含空格或特殊字符，需用双引号包裹，例如 initrd=“/boot/initrd.img-5.15.0”。
• systemd 专属参数：以 systemd. 为前缀，例如 systemd.unit=rescue.target、systemd.log_level=debug。

下表列出了启动阶段最常见的几类内核参数及其用途：

2.2 内核命令行的传递路径

从按下电源键到内核开始解析 cmdline，参数经历了多个阶段的传递。这条路径涉及固件、bootloader、内核引导协议以及内存中的特定数据结构。理解这条路径，有助于在启动失败时定位参数丢失或错误的位置。

下图展示了内核命令行从固件到内核的完整传递流程：

2.3 关键传递节点详解

2.3.1 Bootloader 阶段：参数拼接与覆盖

以 GRUB2 为例，内核命令行的最终内容由以下三部分拼接而成：

1. GRUB 配置文件中的 GRUB_CMDLINE_LINUX：对所有启动项生效的通用参数。
2. GRUB 配置文件中的 GRUB_CMDLINE_LINUX_DEFAULT：仅对默认启动项生效的参数。
3. 用户手动编辑（按 e 键）：在启动菜单临时添加或修改的参数，优先级最高。

2.3.2 内核引导协议：setup_header 与 DTB

对于 x86 架构，内核使用 setup_header 结构体传递 cmdline。该结构体位于内核镜像的实模式头部，其中 cmd_line_ptr 字段指向内存中存放 cmdline 字符串的物理地址。对于 ARM/ARM64 架构，通常使用 设备树 (Device Tree Blob, DTB) 的 bootargs 属性传递。

下表对比了两种主流架构的 cmdline 传递机制：

2.3.3 内核解析：已知参数 vs 未知参数

内核在 start_kernel() → setup_arch() → parse_early_param() 中开始解析 cmdline。解析逻辑遵循以下规则：

• 已知参数：内核内部注册了处理函数（如 root= 对应 root_dev_setup()），解析后立即生效，并从 cmdline 中移除。
• 未知参数：内核不认识的参数（包括所有 systemd. 参数）会被保留，最终完整地导出到 /proc/cmdline 中。

2.4 systemd 如何读取内核命令行

systemd 作为 PID 1 启动后，通过以下方式获取内核命令行：

1. 直接读取 /proc/cmdline：这是最标准的方式。systemd 的 parse_proc_cmdline() 函数逐词扫描该文件。
2. 解析 systemd. 前缀参数：所有以 systemd. 开头的参数被提取到内部配置中。例如 systemd.unit=multi-user.target 会覆盖默认的 default.target。
3. 解析通用参数：systemd 也识别部分无前缀的通用参数，如 quiet（抑制日志）、debug（开启调试）、single（单用户模式）、emergency（紧急模式）。
4. 解析 rd. 前缀参数：这些参数用于 initramfs 阶段，由 systemd 的 systemd-fsck、systemd-cryptsetup 等工具读取。

以下代码片段展示了 systemd 如何从 /proc/cmdline 中提取参数：

/* systemd 源代码片段 (src/basic/parse-util.c) */
int parse_proc_cmdline(int (*cb)(const char *key, const char *value, void *data), void *data) {
    _cleanup_free_ char *cmdline = NULL;
    const char *p;
    int r;

    r = read_full_file("/proc/cmdline", &cmdline, NULL);
    if (r < 0)
        return log_error_errno(r, "Failed to read /proc/cmdline: %m");

    p = cmdline;
    for (;;) {
        _cleanup_free_ char *word = NULL;
        const char *eq;

        r = extract_first_word(&p, &word, NULL, 0);
        if (r < 0)
            return r;
        if (r == 0)
            break;

        eq = strchr(word, '=');
        if (eq) {
            char *key = strndup(word, eq - word);
            char *value = strdup(eq + 1);
            cb(key, value, data);
        } else {
            cb(word, NULL, data);
        }
    }
    return 0;
}

2.5 查看与验证内核命令行

在运行中的系统上，可以通过以下命令查看当前生效的内核命令行：

# 查看完整内核命令行
cat /proc/cmdline

# 仅查看 systemd 相关参数
cat /proc/cmdline | tr ' ' '\n' | grep -E '^(systemd\.|rd\.)'

# 查看内核启动日志中的 cmdline 记录
dmesg | grep "Command line"

# 查看 GRUB 配置中定义的参数
grep -E '^GRUB_CMDLINE_LINUX' /etc/default/grub

下表总结了不同阶段查看 cmdline 的方法及其适用场景：

2.6 常见传递问题与排查

内核命令行传递过程中可能出现以下典型问题：

• 参数被截断：cmdline 总长度超过 bootloader 或内核的限制（x86 通常为 2048 字节）。排查方法：cat /proc/cmdline | wc -c 检查长度。
• 参数被覆盖：同一个参数在 GRUB 配置中出现多次，后出现的覆盖先出现的。排查方法：检查 /etc/default/grub 中 GRUB_CMDLINE_LINUX 和 GRUB_CMDLINE_LINUX_DEFAULT 是否有重复。
• 特殊字符转义：引号、反斜杠、空格等字符在 GRUB 配置中未正确转义。排查方法：运行 grub-mkconfig -o /boot/grub/grub.cfg 后检查生成的配置文件。
• DTB 未正确传递：ARM 平台上 bootloader 未正确设置 bootargs。排查方法：在 U-Boot 中执行 printenv bootargs 查看。