linux kernel的cmdline參數解析原理分析【轉】

来源:https://www.cnblogs.com/linhaostudy/archive/2019/10/21/11716931.html
-Advertisement-
Play Games

Kernel啟動時會解析cmdline,然後根據這些參數如console root來進行配置運行。 Cmdline是由bootloader傳給kernel,如uboot,將需要傳給kernel的參數做成一個tags鏈表放在ram中,將首地址傳給kernel,kernel解析tags來獲取cmdlin ...


Kernel啟動時會解析cmdline,然後根據這些參數如console root來進行配置運行。

Cmdline是由bootloader傳給kernel,如uboot,將需要傳給kernel的參數做成一個tags鏈表放在ram中,將首地址傳給kernel,kernel解析tags來獲取cmdline等信息。

Uboot傳參給kernel以及kernel如何解析tags可以看我的另一篇博文,鏈接如下:

今天要分析的是kernel在獲取到cmdline之後如何對cmdline進行解析。

依據我的思路(時間順序,如何開始,如何結束),首先看kernel下2種參數的註冊。
第一種是kernel通用參數,如console=ttyS0,115200  root=/rdinit/init等。這裡以console為例。
第二種是kernel下各個driver中需要的參數,在寫driver中,如果需要一些啟動時可變參數。可以在driver最後加入module_param()來註冊一個參數,kernel啟動時由cmdline指定該參數的值。

這裡以drivers/usb/gadget/serial.c中的use_acm參數為例(這個例子有點偏。。因為最近在調試usb虛擬串口)

一 kernel通用參數

對於這類通用參數,kernel留出單獨一塊data段,叫.ini.setup段。在arch/arm/kernel/vmlinux.lds中:

.init.data : {
  *(.init.data) *(.cpuinit.data) *(.meminit.data) *(.init.rodata) *(.cpuinit.rodata) *(.meminit.rodata) . = ALIGN(32); __dtb_star
 . = ALIGN(16); __setup_start = .; *(.init.setup) __setup_end = .;
  __initcall_start = .; *(.initcallearly.init) __initcall0_start = .; *(.initcall0.init) *(.initcall0s.init) __initcall1_start =
  __con_initcall_start = .; *(.con_initcall.init) __con_initcall_end = .;
  __security_initcall_start = .; *(.security_initcall.init) __security_initcall_end = .;
  . = ALIGN(4); __initramfs_start = .; *(.init.ramfs) . = ALIGN(8); *(.init.ramfs.info)
 }

可以看到init.setup段起始__setup_start和結束__setup_end。

.init.setup段中存放的就是kernel通用參數和對應處理函數的映射表。在include/linux/init.h中

可以看出巨集定義__setup以及early_param定義了obs_kernel_param結構體,該結構體存放參數和對應處理函數,存放在.init.setup段中。

可以想象,如果多個文件中調用該巨集定義,在鏈接時就會根據鏈接順序將定義的obs_kernel_param放到.init.setup段中。

以console為例,在/kernel/printk.c中,如下:

static int __init console_setup(char *str)
{
.......
}
__setup("console=", console_setup);
__setup巨集定義展開,如下:

Static struct obs_kernel_param __setup_console_setup 
__used_section(.init.setup) __attribute__((aligned((sizeof(long)))) = {
.name = “console=”,
.setup_func = console_setup,
.early = 0
}

__setup_console_setup編譯時就會鏈接到.init.setup段中,kernel運行時就會根據cmdline中的參數名與.init.setup段中obs_kernel_param的name對比。

匹配則調用console-setup來解析該參數,console_setup的參數就是cmdline中console的值,這是後面參數解析的大體過程了。

二 driver自定義參數

對於driver自定義參數,kernel留出rodata段一部分,叫__param段,在arch/arm/kernel/vmlinux.lds中,如下:

__param : AT(ADDR(__param) - 0) { __start___param = .; *(__param) __stop___param = .; }

該段放在.rodata段中。

那該段中存放的是什麼樣的數據呢?

Driver中使用module_param來註冊參數,跟蹤這個巨集定義,最終就會找到對__param段的操作函數如下:

/* This is the fundamental function for registering boot/module
   parameters. */
#define __module_param_call(prefix, name, ops, arg, perm, level)    \
    /* Default value instead of permissions? */         \
    static int __param_perm_check_##name __attribute__((unused)) =  \
    BUILD_BUG_ON_ZERO((perm) < 0 || (perm) > 0777 || ((perm) & 2))  \
    + BUILD_BUG_ON_ZERO(sizeof(""prefix) > MAX_PARAM_PREFIX_LEN);   \
    static const char __param_str_##name[] = prefix #name;      \
    static struct kernel_param __moduleparam_const __param_##name   \
    __used                              \
    __attribute__ ((unused,__section__ ("__param"),aligned(sizeof(void *)))) \
    = { __param_str_##name, ops, perm, level, { arg } }
........
#define module_param(name, type, perm)              \
    module_param_named(name, name, type, perm)
 
#define module_param_named(name, value, type, perm)            \
    param_check_##type(name, &(value));                \
    module_param_cb(name, ¶m_ops_##type, &value, perm);        \
    __MODULE_PARM_TYPE(name, #type)
 
#define module_param_cb(name, ops, arg, perm)                     \
    __module_param_call(MODULE_PARAM_PREFIX, name, ops, arg, perm, -1)

以driver/usb/gadget/serial.c中的use_acm為例,如下:

static bool use_acm = true;
module_param(use_acm, bool, 0);
Module_param展開到__module_param_call,如下:

Static bool use_acm = true;
Param_check_bool(use_acm, &(use_acm));
__module_param_call(MODULE_PARAM_PREFIX, use_acm, ¶m_ops_bool, &(use_acm, 0, -1));
__MODULE_PARAM_TYPE(use_acm, bool);

將__module_param_call展開,可以看到是定義了結構體kernel_param,如下:

Static struct kernel_param __moduleparam_const __param_use_acm 
 __used   __attribute__ ((unused,__section__ ("__param"),aligned(sizeof(void *)))) = {
.name = MODULE_PARAM_PREFIX#use_acm,
.ops = ¶m_ops_bool,
.Perm=0,
.level = -1.
.arg = &use_acm
}

很清楚,跟.init.setup段一樣,kernel鏈接時會根據鏈接順序將定義的kernel_param放在__param段中。

Kernel_param有3個成員變數需要註意:

(1)

ops=param_ops_bool,是kernel_param_ops結構體,定義如下:

struct kernel_param_ops param_ops_bool = {
    .set = param_set_bool,
    .get = param_get_bool,
};

這2個成員函數分別去設置和獲取參數值

在kernel/param.c中可以看到kernel預設支持的driver參數類型有bool byte short ushort int uint long ulong string(字元串) charp(字元串指針)array等。

對於預設支持的參數類型,param.c中提供了kernel_param_ops來處理相應類型的參數。

(2)

Arg = &use_acm,巨集定義展開,可以看到arg中存放use_acm的地址。參數設置函數param_set_bool(const char val, const struct kernel_param kp)

將val值設置到kp->arg地址上,也就是改變了use_acm的值,從而到達傳遞參數的目的。

(3)

.name=MODULE_PARAM_PREFIX#use_acm,定義了該kernel_param的name。

MODULE_PARAM_PREFIX非常重要,定義在include/linux/moduleparam.h中:

* You can override this manually, but generally this should match the
   module name. */
#ifdef MODULE
#define MODULE_PARAM_PREFIX /* empty */
#else
#define MODULE_PARAM_PREFIX KBUILD_MODNAME "."
#endif

如果我們是模塊編譯(make modules),則MODULE_PARAM_PREFIX為empty。

在模塊傳參時,參數名為use_acm,如insmod g_serial.ko use_acm=0

正常編譯kernel,MODULE_PARAM_PREFIX為模塊名+”.”

如果我們在傳參時不知道自己的模塊名是什麼,可以在自己的驅動中加列印,將MODULE_PARAM_PREFIX列印出來,來確定自己驅動的模塊名。

所以這裡將serial.c編入kernel,根據driver/usb/gadget/Makefile,如下:

g_serial-y          := serial.o
....
obj-$(CONFIG_USB_G_SERIAL)  += g_serial.o

最終是生成g_serial.o,模塊名為g_serial.ko。.name = g_serial.use_acm。

kernel傳參時,該參數名為g_serial.use_acm

這樣處理防止kernel下眾多driver中出現重名的參數。

可以看出,對於module_param註冊的參數,如果是kernel預設支持類型,kernel會提供參數處理函數。

如果不是kernel支持參數類型,則需要自己去實現param_ops##type了。

這個可以看drivers/video/uvesafb.c中的scroll參數的註冊(又有點偏。。。無意間找到的)。

 

參數註冊是在kernel編譯鏈接時完成的(鏈接器將定義結構體放到.init.setup或__param中)

接下來需要分析kernel啟動時如何對傳入的cmdline進行分析。

三 kernel對cmdline的解析

根據我之前寫的博文可知,start_kernel中setup_arch中解析tags獲取cmdline,拷貝到boot_command_line中。我們接著往下看start_kernel。

調用setup_command_line,將cmdline拷貝2份,放在saved_command_line static_command_line。

下麵調用parse_early_param(),如下:

void __init parse_early_options(char *cmdline)
{
    parse_args("early options", cmdline, NULL, 0, 0, 0, do_early_param);
}
 
/* Arch code calls this early on, or if not, just before other parsing. */
void __init parse_early_param(void)
{
    static __initdata int done = 0;
    static __initdata char tmp_cmdline[COMMAND_LINE_SIZE];
 
    if (done)
        return;
 
    /* All fall through to do_early_param. */
    strlcpy(tmp_cmdline, boot_command_line, COMMAND_LINE_SIZE);
    parse_early_options(tmp_cmdline);
    done = 1;
}

Parse_early_param拷貝cmdline到tmp_cmdline中一份,最終調用parse_args,如下:

/* Args looks like "foo=bar,bar2 baz=fuz wiz". */
int parse_args(const char *name,
           char *args,
           const struct kernel_param *params,
           unsigned num,
           s16 min_level,
           s16 max_level,
           int (*unknown)(char *param, char *val))
{
    char *param, *val;
 
    pr_debug("Parsing ARGS: %s\n", args);
 
    /* Chew leading spaces */
    args = skip_spaces(args);
 
    while (*args) {
        int ret;
        int irq_was_disabled;
 
        args = next_arg(args, ¶m, &val);
        irq_was_disabled = irqs_disabled();
        ret = parse_one(param, val, params, num,
                min_level, max_level, unknown);
        if (irq_was_disabled && !irqs_disabled()) {
            printk(KERN_WARNING "parse_args(): option '%s' enabled "
                    "irq's!\n", param);
        }
        switch (ret) {
        case -ENOENT:
            printk(KERN_ERR "%s: Unknown parameter `%s'\n",
                   name, param);
            return ret;
        case -ENOSPC:
            printk(KERN_ERR
                   "%s: `%s' too large for parameter `%s'\n",
                   name, val ?: "", param);
            return ret;
        case 0:
            break;
        default:
            printk(KERN_ERR
                   "%s: `%s' invalid for parameter `%s'\n",
                   name, val ?: "", param);
            return ret;
        }
    }
 
    /* All parsed OK. */
    return 0;
}
.....
void __init parse_early_options(char *cmdline)
{
    parse_args("early options", cmdline, NULL, 0, 0, 0, do_early_param);
}

Parse_args遍歷cmdline,按照空格切割獲取參數,對所有參數調用next_arg獲取參數名param和參數值val。如console=ttyS0,115200,則param=console,val=ttyS0,115200。調用parse_one。如下:

static int parse_one(char *param,
             char *val,
             const struct kernel_param *params,
             unsigned num_params,
             s16 min_level,
             s16 max_level,
             int (*handle_unknown)(char *param, char *val))
{
    unsigned int i;
    int err;
 
    /* Find parameter */
    for (i = 0; i < num_params; i++) {
        if (parameq(param, params[i].name)) {
            if (params[i].level < min_level
                || params[i].level > max_level)
                return 0;
            /* No one handled NULL, so do it here. */
            if (!val && params[i].ops->set != param_set_bool
                && params[i].ops->set != param_set_bint)
                return -EINVAL;
            pr_debug("They are equal!  Calling %p\n",
                   params[i].ops->set);
            mutex_lock(¶m_lock);
            err = params[i].ops->set(val, ¶ms[i]);
            mutex_unlock(¶m_lock);
            return err;
        }
    }
 
    if (handle_unknown) {
        pr_debug("Unknown argument: calling %p\n", handle_unknown);
        return handle_unknown(param, val);
    }
 
    pr_debug("Unknown argument `%s'\n", param);
    return -ENOENT;
}

由於從parse_early_options傳入的num_params=0,所以parse_one是直接走的最後handle_unknown函數。該函數是由parse-early_options傳入的do_early_param。如下:

static int __init do_early_param(char *param, char *val)
{
    const struct obs_kernel_param *p;
 
    for (p = __setup_start; p < __setup_end; p++) {
        if ((p->early && parameq(param, p->str)) ||
            (strcmp(param, "console") == 0 &&
             strcmp(p->str, "earlycon") == 0)
        ) {
            if (p->setup_func(val) != 0)
                printk(KERN_WARNING
                       "Malformed early option '%s'\n", param);
        }
    }
    /* We accept everything at this stage. */
    return 0;
}

Do_early_param遍歷.init.setup段,如果有obs_kernel_param的early為1,或cmdline中有console參數並且obs_kernel_param有earlycon參數,則會調用該obs_kernel_param的setup函數來解析參數。

Do_early_param會對cmdline中優先順序較高的參數進行解析。我翻了下kernel源碼找到一個例子,就是arch/arm/kernel/early_printk.c,利用cmdline參數earlyprintk來註冊最早的一個console,有興趣大家可以參考下。

如果想kernel啟動中儘早列印輸出,方便調試,可以註冊str為earlycon的obs_kernel_param。

在其setup參數處理函數中register_console,註冊一個早期的console,從而是printk信息正常列印,這個在後面我還會總結一篇kernel印表機制來說這個問題。

do_early_param是為kernel中需要儘早配置的功能(如earlyprintk  earlycon)做cmdline的解析。

Do_early_param就說道這裡,該函數並沒有處理我們經常使用的kernel通用參數和driver自定義參數。接著往下看。代碼如下:

setup_arch(&command_line);
    mm_init_owner(&init_mm, &init_task);
    mm_init_cpumask(&init_mm);
    setup_command_line(command_line);
    setup_nr_cpu_ids();
    setup_per_cpu_areas();
    smp_prepare_boot_cpu(); /* arch-specific boot-cpu hooks */
 
    build_all_zonelists(NULL);
    page_alloc_init();
 
    printk(KERN_NOTICE "Kernel command line: %s\n", boot_command_line);
    parse_early_param();
    parse_args("Booting kernel", static_command_line, __start___param,
           __stop___param - __start___param,
           -1, -1, &unknown_bootoption);

Parse_early_param結束後,start_kernel調用了parse_args。這次調用,不像parse_early_param中調用parse_args那樣kernel_param指針都為NULL,而是指定了.__param段。

回到上面看parse_args函數,params參數為.__param段起始地址,num為kernel_param個數。

Min_level,max_level都為-1.unknown=unknown_bootoption

Parse_args還是像之前那樣,遍歷cmdline,分割獲取每個參數的param和val,對每個參數調用parse_one。

回看Parse_one函數源碼:

(1)parse_one首先會遍歷.__param段中所有kernel_param,將其name與參數的param對比,同名則調用該kernel_param成員變數kernel_param_ops的set方法來設置參數值。

聯想前面講driver自定義參數例子use_acm,cmdline中有參數g_serial.use_acm=0,則在parse_one中遍歷匹配在serial.c中註冊的__param_use_acm,調用param_ops_bool的set函數,從而設置use_acm=0.

(2)如果parse_args傳給parse_one是kernel通用參數,如console=ttyS0,115200。則parse_one前面遍歷.__param段不會找到匹配的kernel_param。就走到後面調用handle_unknown。就是parse_args傳來的unknown_bootoption,代碼如下: 

/*
 * Unknown boot options get handed to init, unless they look like
 * unused parameters (modprobe will find them in /proc/cmdline).
 */
static int __init unknown_bootoption(char *param, char *val)
{
    repair_env_string(param, val);
 
    /* Handle obsolete-style parameters */
    if (obsolete_checksetup(param))
        return 0;
 
    /* Unused module parameter. */
    if (strchr(param, '.') && (!val || strchr(param, '.') < val))
        return 0;
 
    if (panic_later)
        return 0;
 
    if (val) {
        /* Environment option */
        unsigned int i;
        for (i = 0; envp_init[i]; i++) {
            if (i == MAX_INIT_ENVS) {
                panic_later = "Too many boot env vars at `%s'";
                panic_param = param;
            }
            if (!strncmp(param, envp_init[i], val - param))
                break;
        }
        envp_init[i] = param;
    } else {</span>
<span style="font-size:14px;">        /* Command line option */
        unsigned int i;
        for (i = 0; argv_init[i]; i++) {
            if (i == MAX_INIT_ARGS) {
                panic_later = "Too many boot init vars at `%s'";
                panic_param = param;
            }
        }
        argv_init[i] = param;
    }
    return 0;
}

首先repair_env_string會將param val重新組合為param=val形式。

Obsolete_checksetup則遍歷-init_setup段所有obs_kernel_param,如有param->str與param匹配,則調用param_>setup進行參數值配置。

這裡需要註意的一點是repair_env_string將param重新拼成了param=val形式。後面遍歷匹配都是匹配的”param=”而不是“param”。

如之前分析kernel通用參數所舉例子,__setup(“console=”, console_setup)。

Console=ttyS0,115200,obsolete_checksetup是匹配前面console=,如果匹配,則跳過console=,獲取到其值ttyS0,115200,調用其具體的setup函數來解析設置參數值。

可以想象,parse_one對於parse_args傳來的每一個cmdline參數都會將.__param以及-init.setup段遍歷匹配,匹配到str或name一致,則調用其相應的set或setup函數進行參數值解析或設置。

Start_kernel中Parse_args結束,kernel的cmdline就解析完成!

 

總結下kernel的參數解析:

(1)kernel編譯鏈接,利用.__param .init.setup段將kernel所需參數(driver及通用)和對應處理函數的映射表(obs_kernel_param  kernel_param結構體)存放起來。

(2)Kernel啟動,do_early_param處理kernel早期使用的參數(如earlyprintk earlycon)

(3)parse_args對cmdline每個參數都遍歷__param .init.setup進行匹配,匹配成功,則調用對應處理函數進行參數值的解析和設置。

還有一點很值得思考,kernel下對於這種映射處理函數表方式還有很多使用。比如之前博文中uboot傳參給kernel,kernel對於不同tags的處理函數也是以該種方式來映射的。

kernel下driver私有結構體的回調處理函數也有這個思想哇!


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/first-web-api?view=aspnetcore-3.0 ...
  • 使用MailKit發送帶有內嵌圖片的郵件且圖片不顯示成附件 參考文章:MailKit 發送郵件 註意 在郵件客戶端中是否顯示內嵌圖片為附件依據不同郵件有所不同,暫經測試Outlook和qq不顯示為附件,新浪郵箱會顯示附件。 概述 要發送一封帶有複雜格式的郵件,且正文內容中帶有複雜的圖片,以一封阿裡雲 ...
  • 一、使用Nuget安裝 二、配置節點 預設NLog.config修改 三、程式調用 日誌輸出 ...
  • asp.net core 使用 AccessControlHelper 控制訪問許可權 Intro 由於項目需要,需要在基於 asp.net mvc 的 Web 項目框架中做許可權的控制,於是才有了這個許可權控制組件,最初只是支持 netframework,後來 dotnetcore 2.0 發佈了之後添 ...
  • 本文摘自LTP.NET知識庫。 regexp規則類包含在System.Text.RegularExpressions.dll文件中,在對應用軟體進行編譯時你必須引用這個文件: System.Text.RegularExpressions.dll 名字空間簡介 在名字空間中僅僅包含著6個類和一個定義, ...
  • 上一篇文章寫了委托的最基本的一些東西,本篇咱們扯扯委托其他的東西。 示例1插件編程 根據對委托的理解,委托可以把一個方法當作參數進行傳遞,利用這個特性我們可以使用委托,實現插件編程。 這裡的Transform方法就是插件方法,它接受一個委托參數。 示例2多播委托 所有的委托都有多播的能力。這就意味著 ...
  • 微軟在2019年9月24日發佈了dotNet Core 3.0和C# 8.0,添加了許多新Features,詳情點我。無疑dotNet Core 3.0和一個月之後即將發佈的dotNet Core 3.1對於dotNet來說是一個重要的里程碑。 對於MySQL而言,現在越來越多的商業公司使用MySQ... ...
  • 一、樹莓派簡單介紹 二、軟&件準備 硬體:樹莓派4B主機、電源線、TF卡&TF讀卡器、PC 軟體:win32diskimager(用於燒系統到TF卡)、Xshell或Windows Termainal(用於ssh鏈接命令操作)、 Xftp(用於上傳文件)、VNC(遠程桌面操作) 以上軟體下載地址(除 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...