The eCos Component Writer's Guide

Bart Veer

John Dallaway

Table of Contents (expand | collapse)

1. Overview
2. Package Organization
3. The CDL Language
4. The Build Process
5. CDL Language Specification
- cdl_option -- Define a single configuration option
- cdl_component -- Define a component, a collection of configuration options
- cdl_package -- Define a package, a component that can be distributed
- cdl_interface -- Define an interface, functionality that can be provided bya number of different implementations.
- active_if -- Allow additional control over the active state of anoption or other CDL entity.
- calculated -- Used if the current option's value is not user-modifiable,but is calculated using a suitable CDL expression.
- compile -- List the source files that should be built if this optionis active and enabled.
- default_value -- Provide a default value for this option using a CDL expression.
- define -- Specify additional #define symbols thatshould go into the owning package's configuration header file.
- define_format -- Control how an option's value will appear in theconfiguration header file.
- define_header -- Specify the configuration header file thatwill be generated for a given package.
- define_proc -- Use a fragment of Tcl code to output additional data toconfiguration header files.
- description -- Provide a textual description for an option.
- display -- Provide a short string describing this option.
- doc -- The location of online-documentation for a configuration option.
- flavor -- Specify the nature of a configuration option.
- hardware -- Specify that a package is tied to specific hardware.
- if_define -- Output a common preprocessor construct to a configurationheader file.
- implements -- Enabling this option provides one instance of a moregeneral interface.
- include_dir -- Specify the desired location of a package's exportedheader files in the install tree.
- include_files -- List the header files that are exported by a package.
- legal_values -- Impose constraints on the possible values for an option.
- library -- Specify which library should contain the object filesgenerated by building this package.
- make -- Define an additional custom build step associated with anoption, resulting in a target that should not go directly into a library.
- make_object -- Define a custom build step, resulting in an object filethat should go into a library.
- no_define -- Suppress the normal generation of a preprocessor#define symbol in a configuration header file.
- parent -- Control the location of an option in the configuration hierarchy.
- requires -- List constraints that the configuration should satisfy ifa given option is active and enabled..
- script -- Include additional configuration information from anotherCDL script.