1. 前言

　UBOOT版本：uboot2018.03，开发板myimx8mmek240。

2. 背景

在编译构建目标时(如 make xxx)，顶层 Makefile 的 dot-config 变量值设置为 1 。 如下：

#note： 顶层Makefile
dot-config     := 1

ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
    ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
        dot-config := 0
    endif
endi

在顶层 Makefile 中：

#note： 顶层Makefile
KCONFIG_CONFIG    ?= .config
export KCONFIG_CONFIG

ifeq ($(dot-config),1)
# Read in config
-include include/config/auto.conf                (1)

# Read in dependencies to all Kconfig* files, make sure to run
# oldconfig if changes are detected.
-include include/config/auto.conf.cmd            (2)

# To avoid any implicit rule to kick in, define an empty command
$(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;
# If .config is newer than include/config/auto.conf, someone tinkered
# with it and forgot to run make oldconfig.
# if auto.conf.cmd is missing then we are probably in a cleaned tree so
# we execute the config step to be sure to catch updated Kconfig files
include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
    $(Q)$(MAKE) -f $(srctree)/Makefile silentoldconfig
    @# If the following part fails, include/config/auto.conf should be
    @# deleted so "make silentoldconfig" will be re-run on the next build.
    $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.autoconf || \
        { rm -f include/config/auto.conf; false; }
    @# include/config.h has been updated after "make silentoldconfig".
    @# We need to touch include/config/auto.conf so it gets newer
    @# than include/config.h.
    @# Otherwise, 'make silentoldconfig' would be invoked twice.
    $(Q)touch include/config/auto.conf

#endif

其中(1)(2)两行尝试包含 auto.conf 和 auto.conf.cmd 这两个文件。由于使用 -include 进行声明，所以即使这两个文件不存在也不会报错退出，比如在第 1 次编译uboot，且已经配置好 .config 文件时，这两个文件还未生成。

假如我们已经编译好了xxx_deconfig 这个目标，那么我们会在 include/config 这个目录下看到 auto.conf 和 auto.conf.cmd 这两个文件。

从 include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd 这条规则可以知道，auto.conf 文件依赖于 $(KCONFIG_CONFIG) 和 include/config/auto.conf.cmd 。其中 $(KCONFIG_CONFIG) 变量的值就是 .config 这个配置文件。

3. 分析

# To avoid any implicit rule to kick in, define an empty command
$(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;

现在仍然假设 auto.conf 和 auto.conf.cmd 还没有生成，那么由上面这条语句可以知道，该语句中的目标没有依赖，也没有生成它的规则命令，所以可想 GNU Make 本身无法生成 auto.conf.cmd 的。然后该条语句后面的一个分号表明，这两个目标被强制是最新的。所以下面标注的这几条命令得以执行：

#note： 顶层Makefile
include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
    $(Q)$(MAKE) -f $(srctree)/Makefile silentoldconfig                          （1）
    @# If the following part fails, include/config/auto.conf should be
    @# deleted so "make silentoldconfig" will be re-run on the next build.
    $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.autoconf || \
        { rm -f include/config/auto.conf; false; }                              （2）
    @# include/config.h has been updated after "make silentoldconfig".
    @# We need to touch include/config/auto.conf so it gets newer
    @# than include/config.h.
    @# Otherwise, 'make silentoldconfig' would be invoked twice.
    $(Q)touch include/config/auto.conf                                          （3）

这里我们看到要生成一个目标 silentoldconfig ，这个目标定义在 scripts/kconfig/Makefile 中。因为这里使用 -f 选项重新指定了顶层 Makefile，而目标又是 silentoldconfig ，所以该命令最终会在顶层 Makefile 里执行：

#note： 顶层Makefile
# We need some generic definitions (do not try to remake the file).
scripts/Kbuild.include: ;
include scripts/Kbuild.include            //注意这个引用
......
%config: scripts_basic outputmakefile FORCE
    $(Q)$(MAKE) $(build)=scripts/kconfig $@

在scripts/kconfig/Makefile中(至于为什么会引用scripts/kconfig/Makefile，参见UBOOT编译--- make xxx_deconfig过程详解(一)4.1.4.3 小节)

# note：scripts/kconfig/Makefile
ifdef KBUILD_KCONFIG
Kconfig := $(KBUILD_KCONFIG)
else
Kconfig := Kconfig
endif
......
silentoldconfig: $(obj)/conf
    $(Q)mkdir -p include/config include/generated
    $(Q)test -e include/generated/autoksyms.h || \
        touch   include/generated/autoksyms.h
    $< $(silent) --$@ $(Kconfig)

从上面看到，silentoldconfig 目标需要依赖 conf 这个程序，该程序也在 scripts/kconfig 目录下生成。

$ < $ (silent) --$ @ $ (Kconfig)该条命令相当于 scripts/kconfig/conf -s --myimx8mmek240-8mm-2g_defconfig .config 。

其中scripts/kconfig/conf的生成：参见UBOOT编译--- make xxx_deconfig过程详解(一)4.4小节。

conf 程序的源代码的主函数在同目录的 conf.c 文件中，在 main() 函数中看到：

#note：/scripts/kconfig/conf.c
enum input_mode {
    oldaskconfig,
    silentoldconfig, //1
    oldconfig,
    allnoconfig,
    allyesconfig,
    allmodconfig,
    alldefconfig,
    randconfig,
    defconfig,
    savedefconfig,
    listnewconfig,
    olddefconfig,
} input_mode = oldaskconfig;

......
    while ((opt = getopt_long(ac, av, "s", long_opts, NULL)) != -1) {
        if (opt == 's') {
            conf_set_message_callback(NULL);
            continue;
        }
        input_mode = (enum input_mode)opt;
        switch (opt) {
        case silentoldconfig:
            sync_kconfig = 1;
            break;

所以，

(1) 在使用 s 参数时，message的回调函数被注册为空，即conf_message函数无输出打印；

(2) 同时参数opt被赋值为1，等价于silentoldconfig；sync_kconfig = 1；

(3) input_mode = silentoldconfig；

同样在 main() 函数还看到：

#note：/scripts/kconfig/confdata.c
const char *conf_get_configname(void)
{
    char *name = getenv("KCONFIG_CONFIG");

    return name ? name : ".config";
}

#note：/scripts/kconfig/conf.c
    if (sync_kconfig) {
        name = conf_get_configname();
        if (stat(name, &tmpstat)) {
            fprintf(stderr, _("***\n"
                "*** Configuration file \"%s\" not found!\n"
                "***\n"
                "*** Please run some configurator (e.g. \"make oldconfig\" or\n"
                "*** \"make menuconfig\" or \"make xconfig\").\n"
                "***\n"), name);
            exit(1);
        }
    }

上面代码中，如果我们从未配置过UBOOT，那么就会打印出错误信息，然后退出。这里假设已经配置过UBOOT(参见UBOOT编译--- make xxx_deconfig过程详解(一)），并生成了 .config 文件，那么在 main() 函数中会来到：

#note：/scripts/kconfig/conf.c
    switch (input_mode) {
    case defconfig:
        if (!defconfig_file)
            defconfig_file = conf_get_default_confname();
        if (conf_read(defconfig_file)) {
            printf(_("***\n"
                "*** Can't find default configuration \"%s\"!\n"
                "***\n"), defconfig_file);
            exit(1);
        }
        break;
    case savedefconfig:
    case silentoldconfig:
    case oldaskconfig:
    case oldconfig:
    case listnewconfig:
    case olddefconfig:
        conf_read(NULL);
        break;

前面已经讲过由于使用 -s 选项，则 input_mode 为silentoldconfig，所以这里会执行 conf_read(NULL)函数。

conf_read(NULL) 函数用来读取 .config 文件。读取的各种相关内容主要存放在一个 struct symbol 结构链表里，而各个结构的相关指针则放在一个 symbol_hash[] 的数组中，对于数组中元素的寻找通过 fnv32 哈希算法进行定位。

最后会来到 conf.c 中的底部：

#note：/scripts/kconfig/conf.c
    if (sync_kconfig) {
        /* silentoldconfig is used during the build so we shall update autoconf.
         * All other commands are only used to generate a config.
         */
        if (conf_get_changed() && conf_write(NULL)) {
            fprintf(stderr, _("\n*** Error during writing of the configuration.\n\n"));
            exit(1);
        }
        if (conf_write_autoconf()) {
            fprintf(stderr, _("\n*** Error during update of the configuration.\n\n"));
            return 1;
        }
    } else if (input_mode == savedefconfig) {
        if (conf_write_defconfig(defconfig_file)) {
            fprintf(stderr, _("n*** Error while saving defconfig to: %s\n\n"),
                defconfig_file);
            return 1;
        }
    } else if (input_mode != listnewconfig) {
        if (conf_write(NULL)) {
            fprintf(stderr, _("\n*** Error during writing of the configuration.\n\n"));
            exit(1);
        }
    }

实际上也只有当处理 silentoldconfig 目标时 sync_kconfig 变量才会为 1 。

（1）在 if (conf_get_changed() && conf_write(NULL)) 这个判断里，conf_get_changed() 函数判断 .config 文件是否做过变动，如果是，那么会调用 conf_write(NULL) 来重新写 .config 文件。实际上，对于 defconfig, oldconfig,menuconfig,***xxx_deconfig 等目标来说，conf 程序最终也是调用 conf_write() 函数将配置结果写入 .config 文件中。

（2）确保了 .config 已经最新后，那么调用 conf_write_autoconf() 生成 auto.conf，auto.conf.cmd 以及 autoconf.h 这 3 个文件。

来到 conf_write_autoconf() 函数：

#note：/scripts/kconfig/confdata.c
int conf_write_autoconf(void)
{
    struct symbol *sym;
    const char *name;
    FILE *out, *tristate, *out_h;
    int i;

    sym_clear_all_valid();

    file_write_dep("include/config/auto.conf.cmd");

    if (conf_split_config())
        return 1;
......

在 conf_write_autoconf() 里，调用 file_write_dep("include/config/auto.conf.cmd"); 函数将相关内容写入 auto.conf.cmd 文件。在生成的 auto.conf.cmd 文件中可以看到：

deps_config := \
    test/overlay/Kconfig \
    test/env/Kconfig \
    test/dm/Kconfig \

    ......

    board/abilis/tb100/Kconfig \
    arch/arc/Kconfig \
    arch/Kconfig \
    Kconfig

include/config/auto.conf: \
    $(deps_config)

ifneq "$(UBOOTVERSION)" "2018.03"
include/config/auto.conf: FORCE
endif

$(deps_config): ;

可以看到 auto.conf 文件中的内容依赖于 $(deps_config) 变量里定义的东西，这些东西基本上是各个目录下的 Kconfig 以及其它一些相关文件。

仍然在 conf_write_autoconf() 里，分别建立了 .tmpconfig，.tmpconfig_tristate 和 .tmpconfig.h 这 3 个临时文件,然后将文件头的注释部分分别写入到这几个临时文件中，接着在 for_all_symbols(i, sym) 这个循环里(是一个宏)里将相关内容分别写入到这几个文件中。

#note：/scripts/kconfig/confdata.c
    out = fopen(".tmpconfig", "w");
    if (!out)
        return 1;

    tristate = fopen(".tmpconfig_tristate", "w");
    if (!tristate) {
        fclose(out);
        return 1;
    }

    out_h = fopen(".tmpconfig.h", "w");
    if (!out_h) {
        fclose(out);
        fclose(tristate);
        return 1;
    }

    conf_write_heading(out, &kconfig_printer_cb, NULL);

    conf_write_heading(tristate, &tristate_printer_cb, NULL);

    conf_write_heading(out_h, &header_printer_cb, NULL);

    for_all_symbols(i, sym) {
        sym_calc_value(sym);
        if (!(sym->flags & SYMBOL_WRITE) || !sym->name)
            continue;

        /* write symbol to auto.conf, tristate and header files */
        conf_write_symbol(out, sym, &kconfig_printer_cb, (void *)1);

        conf_write_symbol(tristate, sym, &tristate_printer_cb, (void *)1);

        conf_write_symbol(out_h, sym, &header_printer_cb, NULL);
    }
    fclose(out);
    fclose(tristate);
    fclose(out_h);

在最后一段代码中，将这几个临时文件进行改名：

#note：/scripts/kconfig/confdata.c
const char *conf_get_autoconfig_name(void)
{
    char *name = getenv("KCONFIG_AUTOCONFIG");

    return name ? name : "include/config/auto.conf";
}

......

    name = getenv("KCONFIG_AUTOHEADER");
    if (!name)
        name = "include/generated/autoconf.h";
    if (rename(".tmpconfig.h", name))
        return 1;
    name = getenv("KCONFIG_TRISTATE");
    if (!name)
        name = "include/config/tristate.conf";
    if (rename(".tmpconfig_tristate", name))
        return 1;
    name = conf_get_autoconfig_name();
    /*
     * This must be the last step, kbuild has a dependency on auto.conf
     * and this marks the successful completion of the previous steps.
     */
    if (rename(".tmpconfig", name))
        return 1;

从上面可以看到，分别生成了以下几个文件：

include/generated/autoconf.h
include/config/tristate.conf
include/config/auto.conf

由于篇幅的原因，放在下一讲。

4. 总结

（1）auto.conf 和 .config 的差别是：auto.conf 里去掉了 .config 中的注释项目以及空格行，其它的都一样。

（2） include/generated/autoconf.h 头文件由UBOOT本身使用，主要用来预处理 C 代码，把auto.conf中的定义转换成C语言的宏定义。。

（1）在 .config 或 auto.conf 中后接"=y"的项，如：

　     CONFIG_OF_LIBFDT=y

　     在 autoconfig.h 中会被定义为：

        #define CONFIG_OF_LIBFDT 1

（2）在 .config 或 auto.conf 中后接字符串值的项，如：

　     CONFIG_DEFAULT_FDT_FILE="myimx8mmek240-8mm.dtb"

　     在 autoconfig.h 中会被定义为：

        #define CONFIG_DEFAULT_FDT_FILE "myimx8mmek240-8mm.dtb"

（3）在 .config 或 auto.conf 中后接数值的项，如：

　     CONFIG_SDP_LOADADDR=0x40400000

　     在 autoconfig.h 中会被定义为：

        #define CONFIG_SDP_LOADADDR 0x40400000