📄 cdl-guide.html
字号:
<!-- Copyright (C) 2003 Red Hat, Inc. --><!-- This material may be distributed only subject to the terms --><!-- and conditions set forth in the Open Publication License, v1.0 --><!-- or later (the latest version is presently available at --><!-- http://www.opencontent.org/openpub/). --><!-- Distribution of the work or derivative of the work in any --><!-- standard (paper) book form is prohibited unless prior --><!-- permission is obtained from the copyright holder. --><HTML><HEAD><TITLE>The eCos Component Writer's Guide</TITLE><meta name="MSSmartTagsPreventParsing" content="TRUE"><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="NEXT"TITLE="Overview"HREF="overview.html"></HEAD><BODYCLASS="BOOK"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="BOOK"><ANAME="CDL-GUIDE"><DIVCLASS="TITLEPAGE"><H1CLASS="TITLE"><ANAME="AEN4">The <SPANCLASS="APPLICATION">eCos</SPAN> Component Writer's Guide</H1><H3CLASS="AUTHOR"><ANAME="AEN8">Bart Veer</H3><H3CLASS="AUTHOR"><ANAME="AEN11">John Dallaway</H3><PCLASS="COPYRIGHT">Copyright © 2000, 2001 by Red Hat Inc.</P><HR></DIV><DIVCLASS="TOC"><DL><DT><B>Table of Contents</B></DT><DT>1. <AHREF="overview.html">Overview</A></DT><DD><DL><DT><AHREF="overview.html#OVERVIEW.TERMINOLOGY">Terminology</A></DT><DD><DL><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.FRAMEWORK">Component Framework</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.OPTION">Configuration Option</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.COMPONENT">Component</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.PACKAGE">Package</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.CONFIGURATION">Configuration</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.TARGET">Target</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.TEMPLATE">Template</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.PROPERTIES">Properties</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.CONSEQUENCES">Consequences</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.CONSTRAINTS">Constraints</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.CONFLICTS">Conflicts</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.CDL">CDL</A></DT><DT><AHREF="overview.html#CONCEPTS.TERMINOLOGY.REPO">Component Repository</A></DT></DL></DD><DT><AHREF="overview.configurability.html">Why Configurability?</A></DT><DT><AHREF="overview.approaches.html">Approaches to Configurability</A></DT><DT><AHREF="overview.degress.html">Degrees of Configurability</A></DT><DT><AHREF="overview.warning.html">Warnings</A></DT></DL></DD><DT>2. <AHREF="package.html">Package Organization</A></DT><DD><DL><DT><AHREF="package.html#PACKAGE.HIERARCHY">Packages and the Component Repository</A></DT><DT><AHREF="package.versions.html">Package Versioning</A></DT><DT><AHREF="package.contents.html">Package Contents and Layout</A></DT><DD><DL><DT><AHREF="package.contents.html#PACKAGE.BUILD">Outline of the Build Process</A></DT><DT><AHREF="package.contents.html#PACKAGE.SOURCE">Configurable Source Code</A></DT><DT><AHREF="package.contents.html#PACKAGE.HEADERS">Exported Header Files</A></DT><DT><AHREF="package.contents.html#PACKAGE.DOCUMENTATION">Package Documentation</A></DT><DT><AHREF="package.contents.html#PACKAGE.TESTS">Test Cases</A></DT><DT><AHREF="package.contents.html#PACKAGE.HOST">Host-side Support</A></DT></DL></DD><DT><AHREF="package.distrib.html">Making a Package Distribution</A></DT><DD><DL><DT><AHREF="package.distrib.html#PACKAGE.DISTRIB.FORMAT">The <SPANCLASS="APPLICATION">eCos</SPAN> package distribution file format</A></DT><DT><AHREF="package.distrib.html#PACKAGE.DISTRIB.PREPARE">Preparing eCos packages for distribution</A></DT></DL></DD></DL></DD><DT>3. <AHREF="language.html">The CDL Language</A></DT><DD><DL><DT><AHREF="language.html#LANGUAGE.OVERVIEW">Language Overview</A></DT><DT><AHREF="language.commands.html">CDL Commands</A></DT><DT><AHREF="language.properties.html">CDL Properties</A></DT><DD><DL><DT><AHREF="language.properties.html#LANGUAGE.PROPERTIES.USER">Information-providing Properties</A></DT><DT><AHREF="language.properties.html#LANGUAGE.PROPERTIES.HIERARCHY">The Configuration Hierarchy</A></DT><DT><AHREF="language.properties.html#LANGUAGE.PROPERTIES.VALUE">Value-related Properties</A></DT><DT><AHREF="language.properties.html#LANGUAGE.PROPERTIES.DEFINE">Generating the Configuration Header Files</A></DT><DT><AHREF="language.properties.html#LANGUAGE.PROPERTIES.BUILD">Controlling what gets Built</A></DT><DT><AHREF="language.properties.html#LANGUAGE.PROPERTIES.MISCELLANEOUS">Miscellaneous Properties</A></DT></DL></DD><DT><AHREF="language.naming.html">Option Naming Convention</A></DT><DT><AHREF="language.tcl.html">An Introduction to Tcl</A></DT><DT><AHREF="language.values.html">Values and Expressions</A></DT><DD><DL><DT><AHREF="language.values.html#LANGUAGE.VALUES.VALUE">Option Values</A></DT><DT><AHREF="language.values.html#LANGUAGE.EXPRESSION">Ordinary Expressions</A></DT><DT><AHREF="language.values.html#LANGUAGE.FUNCTIONS">Functions</A></DT><DT><AHREF="language.values.html#LANGUAGE.GOAL-EXPRESSION">Goal Expressions</A></DT><DT><AHREF="language.values.html#LANGUAGE.LIST-EXPRESSION">List Expressions</A></DT></DL></DD><DT><AHREF="language.interface.html">Interfaces</A></DT><DT><AHREF="language.database.html">Updating the <SPANCLASS="DATABASE">ecos.db</SPAN> database</A></DT></DL></DD><DT>4. <AHREF="build.html">The Build Process</A></DT><DD><DL><DT><AHREF="build.html#BUILD.OUTLINE">Build Tree Generation</A></DT><DT><AHREF="build.headers.html">Configuration Header File Generation</A></DT><DD><DL><DT><AHREF="build.headers.html#BUILD.HEADERS.SYSTEM.H">The <TTCLASS="FILENAME">system.h</TT> Header</A></DT></DL></DD><DT><AHREF="build.make.html">Building eCos</A></DT><DD><DL><DT><AHREF="build.make.html#BUILD.MAKE.UPDATE">Updating the Build Tree</A></DT><DT><AHREF="build.make.html#BUILD.MAKE.EXPORT">Exporting Public Header Files</A></DT><DT><AHREF="build.make.html#BUILD.MAKE.COMPILES">Compiling</A></DT><DT><AHREF="build.make.html#BUILD.MAKE.LIBRARIES">Generating the Libraries</A></DT><DT><AHREF="build.make.html#BUILD.EXTRAS">The <TTCLASS="FILENAME">extras.o</TT> file</A></DT><DT><AHREF="build.make.html#BUILD.FLAGS">Compilers and Flags</A></DT><DT><AHREF="build.make.html#BUILD.CUSTOM">Custom Build Steps</A></DT><DT><AHREF="build.make.html#BUILD.STARTUP">Startup Code</A></DT><DT><AHREF="build.make.html#BUILD.LINKERSCRIPT">The Linker Script</A></DT></DL></DD><DT><AHREF="build.tests.html">Building Test Cases</A></DT></DL></DD><DT>5. <AHREF="reference.html">CDL Language Specification</A></DT><DD><DL><DT><AHREF="ref.cdl-option.html"><TTCLASS="LITERAL">cdl_option</TT></A> -- Define a single configuration option</DT><DT><AHREF="ref.cdl-component.html"><TTCLASS="LITERAL">cdl_component</TT></A> -- Define a component, a collection of configuration options</DT><DT><AHREF="ref.cdl-package.html"><TTCLASS="LITERAL">cdl_package</TT></A> -- Define a package, a component that can be distributed</DT><DT><AHREF="ref.cdl-interface.html"><TTCLASS="LITERAL">cdl_interface</TT></A> -- Define an interface, functionality that can be provided bya number of different implementations.</DT><DT><AHREF="ref.active-if.html"><SPANCLASS="PROPERTY">active_if</SPAN></A> -- Allow additional control over the active state of anoption or other CDL entity.</DT><DT><AHREF="ref.calculated.html"><SPANCLASS="PROPERTY">calculated</SPAN></A> -- Used if the current option's value is not user-modifiable,but is calculated using a suitable CDL expression.</DT><DT><AHREF="ref.compile.html"><SPANCLASS="PROPERTY">compile</SPAN></A> -- List the source files that should be built if this optionis active and enabled.</DT><DT><AHREF="ref.default-value.html"><SPANCLASS="PROPERTY">default_value</SPAN></A> -- Provide a default value for this option using a CDL expression.</DT><DT><AHREF="ref.define.html"><SPANCLASS="PROPERTY">define</SPAN></A> -- Specify additional <TTCLASS="LITERAL">#define</TT> symbols thatshould go into the owning package's configuration header file.</DT><DT><AHREF="ref.define-format.html"><SPANCLASS="PROPERTY">define_format</SPAN></A> -- Control how an option's value will appear in theconfiguration header file.</DT><DT><AHREF="ref.define-header.html"><SPANCLASS="PROPERTY">define_header</SPAN></A> -- Specify the configuration header file thatwill be generated for a given package.</DT><DT><AHREF="ref.define-proc.html"><SPANCLASS="PROPERTY">define_proc</SPAN></A> -- Use a fragment of Tcl code to output additional data toconfiguration header files.</DT><DT><AHREF="ref.description.html"><SPANCLASS="PROPERTY">description</SPAN></A> -- Provide a textual description for an option.</DT><DT><AHREF="ref.display.html"><SPANCLASS="PROPERTY">display</SPAN></A> -- Provide a short string describing this option.</DT><DT><AHREF="ref.doc.html"><SPANCLASS="PROPERTY">doc</SPAN></A> -- The location of online-documentation for a configuration option.</DT><DT><AHREF="ref.flavor.html"><SPANCLASS="PROPERTY">flavor</SPAN></A> -- Specify the nature of a configuration option.</DT><DT><AHREF="ref.hardware.html"><SPANCLASS="PROPERTY">hardware</SPAN></A> -- Specify that a package is tied to specific hardware.</DT><DT><AHREF="ref.if-define.html"><SPANCLASS="PROPERTY">if_define</SPAN></A> -- Output a common preprocessor construct to a configurationheader file.</DT><DT><AHREF="ref.implements.html"><SPANCLASS="PROPERTY">implements</SPAN></A> -- Enabling this option provides one instance of a moregeneral interface.</DT><DT><AHREF="ref.include-dir.html"><SPANCLASS="PROPERTY">include_dir</SPAN></A> -- Specify the desired location of a package's exportedheader files in the install tree.</DT><DT><AHREF="ref.include-files.html"><SPANCLASS="PROPERTY">include_files</SPAN></A> -- List the header files that are exported by a package.</DT><DT><AHREF="ref.legal-values.html"><SPANCLASS="PROPERTY">legal_values</SPAN></A> -- Impose constraints on the possible values for an option.</DT><DT><AHREF="ref.library.html"><SPANCLASS="PROPERTY">library</SPAN></A> -- Specify which library should contain the object filesgenerated by building this package.</DT><DT><AHREF="ref.make.html"><SPANCLASS="PROPERTY">make</SPAN></A> -- Define an additional custom build step associated with anoption, resulting in a target that should not go directly into a library.</DT><DT><AHREF="ref.make-object.html"><SPANCLASS="PROPERTY">make_object</SPAN></A> -- Define a custom build step, resulting in an object filethat should go into a library.</DT><DT><AHREF="ref.no-define.html"><SPANCLASS="PROPERTY">no_define</SPAN></A> -- Suppress the normal generation of a preprocessor<TTCLASS="LITERAL">#define</TT> symbol in a configuration header file.</DT><DT><AHREF="ref.parent.html"><SPANCLASS="PROPERTY">parent</SPAN></A> -- Control the location of an option in the configuration hierarchy.</DT><DT><AHREF="ref.requires.html"><SPANCLASS="PROPERTY">requires</SPAN></A> -- List constraints that the configuration should satisfy ifa given option is active and enabled..</DT><DT><AHREF="ref.script.html"><SPANCLASS="PROPERTY">script</SPAN></A> -- Include additional configuration information from anotherCDL script.</DT></DL></DD><DT>6. <AHREF="advanced.html">Templates, Targets and Other Topics</A></DT><DD><DL><DT><AHREF="advanced.html#ADVANCED.TEMPLATES">Templates</A></DT><DT><AHREF="advanced.targets.html">Targets</A></DT></DL></DD></DL></DIV></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"> </TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"> </TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="overview.html"ACCESSKEY="N">Next</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"> </TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"> </TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">Overview</TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -