URL
https://opencores.org/ocsvn/openrisc/openrisc/trunk
Subversion Repositories openrisc
[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [cdl-guide/] [ref.make.html] - Rev 598
Go to most recent revision | Compare with Previous | Blame | View Log
<!-- 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 >make</TITLE ><meta name="MSSmartTagsPreventParsing" content="TRUE"> <META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="HOME" TITLE="The eCos Component Writer's Guide" HREF="cdl-guide.html"><LINK REL="UP" TITLE="CDL Language Specification" HREF="reference.html"><LINK REL="PREVIOUS" TITLE="library" HREF="ref.library.html"><LINK REL="NEXT" TITLE="make_object" HREF="ref.make-object.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >The <SPAN CLASS="APPLICATION" >eCos</SPAN > Component Writer's Guide</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="ref.library.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="ref.make-object.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="REF.MAKE"><SPAN CLASS="PROPERTY" >make</SPAN ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN4710" ></A ><H2 >Name</H2 >Property <SPAN CLASS="PROPERTY" >make</SPAN > -- Define an additional custom build step associated with an option, resulting in a target that should not go directly into a library.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN4714"><H2 >Synopsis</H2 ><TABLE BORDER="5" BGCOLOR="#E0E0F0" WIDTH="70%" ><TR ><TD ><PRE CLASS="SYNOPSIS" >cdl_option <name> { make [-priority=<pri>] { <custom build step> } … }</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4716" ></A ><H2 >Description</H2 ><P >When building an <SPAN CLASS="APPLICATION" >eCos</SPAN > configuration the primary target is a single library, <TT CLASS="FILENAME" >libtarget.a</TT >. In some cases it is necessary to build some additional targets. For example architectural HAL packages typically build a linker script and some start-up code. Such additional targets can be specified by a <SPAN CLASS="PROPERTY" >make</SPAN > property. Any option can have one or more <SPAN CLASS="PROPERTY" >make</SPAN > properties, although typically such properties only occur in the body of a <TT CLASS="LITERAL" >cdl_package</TT > command.</P ><P >The <SPAN CLASS="PROPERTY" >make</SPAN > property takes a single argument, which resembles a makefile rule: it consists of a target, a list of dependencies, and one or more commands that should be executed. However the argument is not a makefile fragment, and custom build steps may get executed in build environments that do not involve make. For full details of custom build steps see <A HREF="build.make.html#BUILD.CUSTOM" >the Section called <I >Custom Build Steps</I > in Chapter 4</A >.</P ><DIV CLASS="WARNING" ><P ></P ><TABLE CLASS="WARNING" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Warning</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P >The exact syntax and limitations of custom build steps have not yet been finalized, and are subject to change in future versions of the configuration tools.</P ></TD ></TR ></TABLE ></DIV ><P >The <SPAN CLASS="PROPERTY" >make</SPAN > property takes an optional priority argument indicating the order in which build steps take place. This priority complements the dependency list, and avoids problems with packages needing to know details of custom build steps in other packages (which may change between releases). The defined order is:</P ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT >Priority 0</DT ><DD ><P >The header files exported by the current set of packages are copied to the appropriate places in the <TT CLASS="FILENAME" >include</TT > subdirectory of the install tree. Any unnecessary copies are avoided, to prevent rebuilds of package and application source modules caused by header file dependencies.</P ><DIV CLASS="NOTE" ><BLOCKQUOTE CLASS="NOTE" ><P ><B >Note: </B >A possible future enhancement of the build system may result in the build and install trees being updated automatically if there has been a change to the <TT CLASS="FILENAME" >ecos.ecc</TT > configuration savefile.</P ></BLOCKQUOTE ></DIV ></DD ><DT >Priority 100</DT ><DD ><P >All files specified in <SPAN CLASS="PROPERTY" >compile</SPAN > properties will get built, producing the corresponding object files. In addition any custom build steps defined by <SPAN CLASS="PROPERTY" >make_object</SPAN > properties get executed, unless there is a <TT CLASS="LITERAL" >-priority=</TT > option.</P ></DD ><DT >Priority 200</DT ><DD ><P >The libraries now get built using the appropriate object files.</P ></DD ><DT >Priority 300</DT ><DD ><P >Any custom build steps specified by <SPAN CLASS="PROPERTY" >make</SPAN > properties now get executed, unless the priority for a particular build step is changed from its default.</P ></DD ></DL ></DIV ><P >For example, if a custom build step needs to take place before any of the normal source files get compiled then it should be given a priority somewhere between 0 and 100. If a custom build step involves post-processing an object file prior to its incorporation into a library then a priority between 100 and 200 should be used.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4757" ></A ><H2 >Example</H2 ><TABLE BORDER="5" BGCOLOR="#E0E0F0" WIDTH="70%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >cdl_package CYGPKG_HAL_MN10300_AM33 { display "MN10300 AM33 variant" parent CYGPKG_HAL_MN10300 implements CYGINT_HAL_MN10300_VARIANT hardware include_dir cyg/hal define_header hal_mn10300_am33.h description " The MN10300 AM33 variant HAL package provides generic support for this processor architecture. It is also necessary to select a specific target platform HAL package." make { <PREFIX>/lib/target.ld: <PACKAGE>/src/mn10300_am33.ld $(CC) -E -P -Wp,-MD,target.tmp -DEXTRAS=1 -xc $(INCLUDE_PATH) $(CFLAGS) -o $@ $< @echo $@ ": \\" > $(notdir $@).deps @tail +2 target.tmp >> $(notdir $@).deps @echo >> $(notdir $@).deps @rm target.tmp } }</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4760" ></A ><H2 >See Also</H2 ><P >Properties <A HREF="ref.compile.html" >compile</A >, <A HREF="ref.make-object.html" >make_object</A > and <A HREF="ref.library.html" >library</A >.</P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="ref.library.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="cdl-guide.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="ref.make-object.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><SPAN CLASS="PROPERTY" >library</SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="reference.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><SPAN CLASS="PROPERTY" >make_object</SPAN ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >
Go to most recent revision | Compare with Previous | Blame | View Log