用于编写configure.in的Config语言简介

1. 介绍

Config语言不是bash. Config语言是一种Linux内核配置语言. config.in and Config.in都是使用本语言编制而成. 尽管它看起来,通常工作时,很象一个SH语言的子集,CONFIG语言有更加严格的语法和不同的语义.

CONFIG语言编程的基本指南:仅使用在CONFIG.IN文件中出现的编程语句.

2. 说明

有四各配置程序可以解释和识别Config语言：

l         scripts/Configure        make config、make oldconfig、

l         scripts/Menuconfig      make menuconfig

l         scripts/tkparse          make xconfig

l         mconfig             (in development)

'Configure' 是一个bash脚本语言,它解释了Config.in文件;'Menuconfig'是另外一种bash脚本.

3. 语句

一个Config语言脚本是由一系列的语句构成的。共有21个简单的语句;一个'if'语句;菜单块和一个 'source'语句。

一行结尾处的'/' 表示续行。

'#'用于引入一个注释, 该注释一直保持到该行的结尾. 但是,如果是多行的形如'# ... is not set'的并不是注释,它们具有语义。

    不能用;(分号)来开始一个新行。 'if'语句中的处可以开始一个新行。

3.1基本的语法元素:

    /prompt/——一个位于单引号或双引号内的字符串. 如果字位于双引号内,它不需要任何$。

    /word/——一个未加引号的字, 位于单引号或双引号内的字符串。如果字未加引号或是位于双引号内的需要$号。

    /symbol/——一个没有引号的字. symbol必须以CONFIG_*的形式出现。

    /dep/ ——一个相关字. 运行时/dep/ 必须等于 "y", "m", "n",或 ""。

    /expr/——一类bash的表达式,使用以下运算符:'='、 '!='、 '-a'、 '-o'和'!'。

3.2 所有的语句:

文字语句：

        mainmenu_name          /prompt/

        comment               /prompt/

        text                     /prompt/

    询问语句：

        bool            /prompt/ /symbol/

        hex             /prompt/ /symbol/ /word/

        int               /prompt/ /symbol/ /word/

        string             /prompt/ /symbol/ /word/

        tristate             /prompt/ /symbol/

    字义语句：

        define_bool        /symbol/ /word/

        define_hex        /symbol/ /word/

        define_int          /symbol/ /word/

        define_string        /symbol/ /word/

        define_tristate        /symbol/ /word/

    相关语句：

        dep_bool        /prompt/ /symbol/ /dep/ ...

        dep_mbool       /prompt/ /symbol/ /dep/ ...

        dep_hex         /prompt/ /symbol/ /word/ /dep/ ...

        dep_int           /prompt/ /symbol/ /word/ /dep/ ...

        dep_string         /prompt/ /symbol/ /word/ /dep/ ...

        dep_tristate         /prompt/ /symbol/ /dep/ ...

    未设置语句：

        unset                    /symbol/ ...

    选项语句：

        choice          /prompt/ /word/ /word/

        nchoice         /prompt/ /symbol/ /prompt/ /symbol/ ...

    If语句：

        if [ /expr/ ] ; then /statement/

         ... fi

        if [ /expr/ ] ; then /statement/

         ... else /statement/

         ... fi

    菜单块：

        mainmenu_option next_comment

        comment /prompt/ /statement/ ... endmenu

    Source语句：

        source /word/

l         mainmenu_name /prompt/

用于指定本CONFIG语言文件顶层的名字。

例如：

    # arch/sparc/config.in

    mainmenu_name "Linux/SPARC Kernel Configuration"

l         comment /prompt/

此语句用于在用户配置过程中向用户显示提示信息,同时在输出期间也把它返回给输出文件。注意：此处的prompt,象所有的prompt一样,是一个没有$符号、位于引号内的字符串。

'comment'并不用于对一个CONFIG语言的注释。它用于用户接口显示文字,以及向输出文件中写入输出信息。

例如:

    # drivers/net/Config.in

    comment 'CCP compressors for PPP are only built as modules.'

l         text /prompt/

向用户显示提示信息。不向输出文件中写入提示信息。仅 mconfig 在它的帮助中使用此命令。

例如:

    # mconfig internal help text

    text 'Here are all the mconfig command line options.'

l         bool /prompt/ /symbol/

此命令用于向用户显示/prompt/提示信息,并从用户接收数据,并把该数据赋给/symbol/。合法的输入值为 "n" 和"y"。

 

l         dep_hex /prompt/ /symbol/ /word/ /dep/ ...

l         dep_int /prompt/ /symbol/ /word/ /dep/ ...

l         dep_string /prompt/ /symbol/ /word/ /dep/ ...

l         dep_tristate /prompt/ /symbol/ /dep/ ...

此命令对所有在dependency list中的dependencies进行评估,任何一个值为"y"的dependency没有限制输入范围。任何一个值为"m"的dependency 限制输入为"m"或"n",任何一个值为空的dependency 被忽略,任何一个值为"n"或其他值(比如 "m")的dependency 限制输入为"n"。不允许对dependencies加引号。

如果输入范围被限制为单选"n",dep_bool把"n"赋给/symbol/。如果是多选,dep_bool向用户显示/prompt/提示信息,从用户接收数据,并赋值给/symbol/。

例如：

    # drivers/char/Config.in

    dep_tristate ''''Parallel printer support'''' CONFIG_PRINTER $CONFIG_PARPORT

l         unset /symbol/ ...

此命令向/symbol/赋值"",,但是不把/symbol/输出到输出文件中。

例如：

    # arch/mips/config.in

    unset CONFIG_PCI

    unset CONFIG_MIPS_JAZZ

    unset CONFIG_VIDEO_G364

l         choice /prompt/ /word/ /word/

此命令实现一个选项列表或"radio button list"选项。向用户显示/prompt/和一组有着对应符号的子提示信息。

当用户选择了一个值时,choice命令设置相应的symbol值为"y",并把其他所有在此choice list中的项的值设置为 "n"。

第二个参数是用单引号或双引号内的字,用于描述一些子提示符或符号名。解释器根据空格把字分成一个子字列表。第一个子字就是第一个提示信息。第二个子字就是第一个符号。第三个子字是第二个提示信息。第四个子字是第二个符号....

第三个参数是一个缩写,它的值必须是这些提示信息之一的唯一缩写。对应于这个提示信息的符号就是默认的使能符号。

例如：

    # arch/i386/config.in

    choice          ''''PCI access mode'''' /

"BIOS    CONFIG_PCI_GOBIOS  /

   Direct  CONFIG_PCI_GODIRECT    /

   Any   CONFIG_PCI_GOANY"       Any

l         nchoice /prompt/ /symbol/ /prompt/ /symbol/ ...

此命令与choice命令有着相同的语义,但是有着更为敏感的语法。第一个/prompt/是整个choice list的主提示信息。

第一个/symbol/ 是使能的默认符号(注意：这仅是一个符号,并不是唯一的提示信息缩写)。接下来的/prompt/ 和/symbol/ 对是choice list的提示信息和符号。

l         bool /prompt/ /symbol/

此命令用于向用户显示/prompt/提示信息,并从用户接收数据,并把该数据赋给/symbol/。合法的输入值为 "n" 和"y"。

注意：此命令没有默认值。

例如:

    # arch/i386/config.in

    bool ''Symmetric multi-processing support'' CONFIG_SMP

l         hex /prompt/ /symbol/ /word/

此命令显示/prompt/提示信息给用户,并从用户接收数据值,并赋给 /symbol/。合法输入值为十六进制数。  /word/ 是默认值。

例如:

    # drivers/sound/Config.in

    hex ''I/O base for SB Check from manual of the card'' CONFIG_SB_BASE 220

l         int /prompt/ /symbol/ /word/

此命令向用户显示/prompt/提示信息,接收用户输入值,并赋给/symbol/。 /word/是默认值。

合法输入值：十进制数。

例如:

    # drivers/char/Config.in

    int ''Maximum number of Unix98 PTYs in use (0-2048)'' / CONFIG_UNIX98_PTY_COUNT 256

l         string /prompt/ /symbol/ /word/

此命令向用户显示/prompt/提示信息,接收用户输入值,并赋给/symbol/。 /word/是默认值。

合法输入值: ASCII字符串(''"'' and ''//''除外).

例如：

    # drivers/sound/Config.in

    string ''  Full pathname of DSPxxx.LD firmware file'' / CONFIG_PSS_BOOT_FILE /etc/sound/dsp001.ld

l         tristate /prompt/ /symbol/

此命令向用户显示/prompt/提示信息,接收用户输入值,并赋给/symbol/。

合法输入值："n", "m", or "y"。

"m"代表"module",它表示/symbol/应该被编译为内核module,仅当CONFIG_MODULES的当前值为Y时,m值合法。

无默认值。

例如:

    # fs/Config.in

    tristate ''NFS filesystem support'' CONFIG_NFS_FS

l         define_bool /symbol/ /word/

此命令把/word/的值赋给/symbol/。合法值为"n" 或"y"。

例如:

    # arch/alpha/config.in

    if [ "$CONFIG_ALPHA_GENERIC" = "y" ]

    then define_bool CONFIG_PCI y

            define_bool CONFIG_ALPHA_NEED_ROUNDING_EMULATION y fi

l         define_hex /symbol/ /word/

此命令把/word/的值赋给/symbol/。合法值：十六进制数。

例如：

    # Not from the corpus

    bool ''Specify custom serial port'' CONFIG_SERIAL_PORT_CUSTOM

    if [ "$CONFIG_SERIAL_PORT_CUSTOM" = "y" ]; then hex ''Serial port number'' CONFIG_SERIAL_PORT else define_hex CONFIG_SERIAL_PORT 0x3F8 fi

l         define_int /symbol/ /word/

此命令把/word/的值赋给/symbol/。合法值：十进制数。

例如：

    # drivers/char/ftape/Config.in

    define_int CONFIG_FT_ALPHA_CLOCK 0

l         define_string /symbol/ /word/

此命令把/word/的值赋给/symbol/。合法输入值： ASCII字符串(''"'' and ''//''除外).

例如：

    # Not from the corpus

    define_string CONFIG_VERSION "2.2.0"

l         define_tristate /symbol/ /word/

此命令把/word/的值赋给/symbol/。合法输入值"n"、"m"、和"y"。

例如：

    # drivers/video/Config.in

    if [ "$CONFIG_FB_AMIGA" = "y" ]; then define_tristate CONFIG_FBCON_AFB y

       define_tristate CONFIG_FBCON_ILBM y else if [ "$CONFIG_FB_AMIGA" = "m" ]; then define_tristate CONFIG_FBCON_AFB m

          define_tristate CONFIG_FBCON_ILBM m fi fi

l         dep_bool /prompt/ /symbol/ /dep/ ...

此命令对所有在dependency list中的dependencies进行评估,任何一个值为"y"的dependency没有限制输入范围。任何一个值为空的dependency 被忽略,任何一个值为"n"或其他值(比如 "m")的dependency 限制输入为"n"。不允许对dependencies加引号。

如果输入范围被限制为单选"n",dep_bool把"n"赋给/symbol/。如果是多选,dep_bool向用户显示/prompt/提示信息,从用户接收数据,并赋值给/symbol/。

例如：

    # drivers/net/Config.in

    dep_bool  ''Aironet 4500/4800 PCI support ''  CONFIG_AIRONET4500_PCI  $CONFIG_PCI

l         dep_mbool /prompt/ /symbol/ /dep/ ...

此命令对所有在dependency list中的dependencies进行评估,任何一个值为"y"或"m"的dependency没有限制输入范围。任何一个值为空的dependency 被忽略,任何一个值为"n"或其他值(比如 "m")的dependency 限制输入为"n"。不允许对dependencies加引号。

如果输入范围被限制为单选"n",dep_bool把"n"赋给/symbol/。如果是多选,dep_bool向用户显示/prompt/提示信息,从用户接收数据,并赋值给/symbol/。

例如：

    # Not from the corpus

    dep_mbool ''Packet socket: mmapped IO'' CONFIG_PACKET_MMAP $CONFIG_PACKET