eCos用户指南之手动配置_翻译

这段允许配置工具重载各种包形成配置。大多数信息不应该被编辑。如果需
要增加一个新包或者删除一个已存在的包应该用合适的工具，例如：
$ ecosconfig remove CYGPKG_LIBM
有 两 个 地 方 可 以 编 辑 。 配 置 有 个 名 字 ， 这 里 是 eCos ； 有 一 个 描 述
跟着头段的段定义配置的整体。一个典型的例子是：
# ---- toplevel -------------------------------------------------------# This section defines the toplevel configuration object. The only # values that can be changed are the name of the configuration and # the description field. It is not possible to modify the target, # the template or the set of packages simply by editing the lines # below because these changes have wide-ranging effects. Instead # the appropriate tools should be used to make such modifications.
eCos User Guide(Chapter 28.manual Configuration)
eCos 用户指南之手动配置_翻译
翻译：JARI TOOL
1. 编辑一个 eCos 存档文件
eCos 配置信息存放在一个存档文件（savefile）中，典型的是 ecos.ecc， 这个文件既可以通过 GUI 界面配置工具产生，也可以通过命令行 ecosconfig 配 置工具产生。这个文件通常存在于编译树（build tree）的顶层。它是一个文本 文件，允许通过文本编辑器、其它程序或脚本来编辑各种配置选项，也可以在 GUI 配置工具里编辑。
cdl_savefile_command cdl_interface { value_source user_value wizard_value inferred_value };
存档文件的这一段供配置系统用，不应该编辑它。如果这段被编辑了，各种
配置工具可能读不进这个修改了的存档文件。
3. 顶层段
eCos 存档文件是 Tcl 编程语言的一个脚本，所以任何对文件的修改需要保 存 Tcl 语法。对于大多数配置选项的改动都很小，不必担心 Tcl 语法。例如，把 1 变成 0 来禁止一个选项。对于更复杂的选项，如 CYGDAT_UITRON_TASK_EXTERNS， 包括几行 C 语言代码，需要多加注意。如果一个编辑过的存档文件不再是一个有 效的 Tcl 脚本，那么配置工具将不能读回数据作进一步处理，如产生编译树。下 面给出 Tcl 语法主要原则。这里值得注意的一点是以“#”开始的一行通常是注 释，eCos 存档文件块里包含这样的注释，来使它易于编辑。
cdl_package CYGPKG_KERNEL ... #> cdl_component CYGPKG_KERNEL_EXCEPTIONS ... #> cdl_option CYGSEM_KERNEL_EXCEPTIONS_DECODE ... cdl_option CYGSEM_KERNEL_EXCEPTIONS_GLOBAL ... #< cdl_component CYGPKG_KERNEL_SCHED ... #> cdl_option CYGSEM_KERNEL_SCHED_MLQUEUE ... cdl_option CYGSEM_KERNEL_SCHED_BITMAP ... #< #<
当你编辑一个配置，可能最终产生无效的东西。配置中的任何问题将在冲突 段报告出来。这个例子有两个冲突。选项 CYGNUM_LIBC_TIME_DST_DEFAULT_OFFSET 被给了一个非法值：可以通过在后边的 存档文件中查找该选项定义并修改这个值而修复这个冲突。第二个冲突更有意思， 不满足所需约束。配置选项是非独立的：禁止一些在内核中的功能，在其它地方 产生影响，这里是 C 库。选项间的各种依赖依组件开发者而定，并由 配置系统 来检验。这个例子有两种显见的方法解决冲突：重新允许 CYGFUN_KERNEL_THREADS_TIMER，或者禁止 CYGSEM_LIBC_TIME_CLOCK_WORKING。 这两个选项将在之后的文件中列出来。
2. 头段
eCos 存档文件以一个文件头开始，典型的像这样：
# eCos saved configuration # ---- commands -------------------------------------------------------# This section contains information about the savefile format. # It should not be edited. Any modifications made to this section # may make it impossible for the configuration tools to read # the savefile.
cdl_savefile_version 1; cdl_savefile_command cdl_savefile_version {}; cdl_savefile_command cdl_savefile_command {}; cdl_savefile_command cdl_configuration { description hardware template package }; cdl_savefile_command cdl_package { value_source user_value wizard_value inferred_value }; cdl_savefile_command cdl_component { value_source user_value wizard_value inferred_value }; cdl_savefile_command cdl_option { value_source user_value wizard_value inferred_value };
（description）是一些主观的文本。配置工具不用这些区域，它们存在是为了
用户为一个配置存储附加信息。
4. 冲突段
顶层段后面是在配置中的所有冲突细节，如：
# ---- conflicts ------------------------------------------------------# There are 2 conflicts. # # option CYGNUM_LIBC_TIME_DST_DEFAULT_OFFSET # Property LegalValues # Illegal current value 100000 # Legal values are: -90000 to 90000 # # option CYGSEM_LIBC_TIME_CLOCK_WORKING # Property Requires # Requires constraint not satisfied: CYGFUN_KERNEL_THREADS_TIMER
5. 数据段
存档文件列出各种包、组件和选项，包括它们的值和各种依赖。大量全局选 项先列出，特别是与编译过程相关的，像编译器标记。包里按顺序跟着包、组件
和选项。
包、组件和选项按层组织起来。如果一个特别的组件被禁用了，那么它的所
有选项和子组件都将被禁用：任何改动都不起作用。存档文件以注释的方式包含
分层信息，例如：
CYGPKG_KERNEL_EXCEPTIONS CYGSEM_KERNEL_EXCEPTIONS_DECODE CYGSEM_KERNEL_EXCEPTIONS_GLOBAL CYGPKG_KERNEL_SCHED CYGSEM_KERNEL_SCHED_MLQUEUE CYGSEM_KERNEL_SCHED_BITMAP
这种方法提供的层次信息允许程序或脚本分析存档文件并确定层次。也可用
于强力编辑器支持 eCos 存档文件进行结构编辑。配置工具本身不用这些信息，
因为它们从原始的 CDL 脚本获得分层信息。
每个可配置实体之前有一段注释，类似下面的形式：
# Kernel schedulers # doc: ref/ecos-ref/ecos-kernel-overview.html#THE-SCHEDULER # The eCos kernel provides a choice of schedulers. In addition # there are a number of configuration options to control the # detailed behaviour of these schedulers. cdl_component CYGPKG_KERNEL_SCHED { ... };
当修改配置选项的时候需要注意，避免引入新的冲突。例如，可能在系统里 有其它选项依赖 CYGSEM_LIBC_TIME_CLOCK_WORKING，所以禁止该选项可能不是 解决冲突的最好方式。存储文件的适当地方提供了所有这些依赖的细节。
在产生编译树和编译 eCos 之前并不绝对要求一个配置是无冲突的。如果在 仍然有冲突的情况下试图编译 eCos，每个组件的开发者决定将发生什么。严重 的情况将可能是编译时失败，或者可能连接时失败。不太严重的情况系统可能编 译通过并且应用程序能连接结果库，但是组件可能没有达到预想的功能——尽管 对于应用的特殊需要已经足够好。也可能编译链接通过，但偶尔系统会莫名其妙 的崩溃。用存在冲突的配置将置用户于危险之中。