OpenCores
URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [cdl-guide/] [ref.make-object.html] - Blame information for rev 417

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 28 unneback 
<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
2 
<!-- This material may be distributed only subject to the terms      -->
3 
<!-- and conditions set forth in the Open Publication License, v1.0  -->
4 
<!-- or later (the latest version is presently available at          -->
5 
<!-- http://www.opencontent.org/openpub/).                           -->
6 
<!-- Distribution of the work or derivative of the work in any       -->
7 
<!-- standard (paper) book form is prohibited unless prior           -->
8 
<!-- permission is obtained from the copyright holder.               -->
9 
<HTML
10 
><HEAD
11 
><TITLE
12 
>make_object</TITLE
13 
><meta name="MSSmartTagsPreventParsing" content="TRUE">
14 
<META
15 
NAME="GENERATOR"
16 
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
17 
"><LINK
18 
REL="HOME"
19 
TITLE="The eCos Component Writer's Guide"
20 
HREF="cdl-guide.html"><LINK
21 
REL="UP"
22 
TITLE="CDL Language Specification"
23 
HREF="reference.html"><LINK
24 
REL="PREVIOUS"
25 
TITLE="make"
26 
HREF="ref.make.html"><LINK
27 
REL="NEXT"
28 
TITLE="no_define"
29 
HREF="ref.no-define.html"></HEAD
30 
><BODY
31 
CLASS="REFENTRY"
32 
BGCOLOR="#FFFFFF"
33 
TEXT="#000000"
34 
LINK="#0000FF"
35 
VLINK="#840084"
36 
ALINK="#0000FF"
37 
><DIV
38 
CLASS="NAVHEADER"
39 
><TABLE
40 
SUMMARY="Header navigation table"
41 
WIDTH="100%"
42 
BORDER="0"
43 
CELLPADDING="0"
44 
CELLSPACING="0"
45 
><TR
46 
><TH
47 
COLSPAN="3"
48 
ALIGN="center"
49 
>The <SPAN
50 
CLASS="APPLICATION"
51 
>eCos</SPAN
52 
> Component Writer's Guide</TH
53 
></TR
54 
><TR
55 
><TD
56 
WIDTH="10%"
57 
ALIGN="left"
58 
VALIGN="bottom"
59 
><A
60 
HREF="ref.make.html"
61 
ACCESSKEY="P"
62 
>Prev</A
63 
></TD
64 
><TD
65 
WIDTH="80%"
66 
ALIGN="center"
67 
VALIGN="bottom"
68 
></TD
69 
><TD
70 
WIDTH="10%"
71 
ALIGN="right"
72 
VALIGN="bottom"
73 
><A
74 
HREF="ref.no-define.html"
75 
ACCESSKEY="N"
76 
>Next</A
77 
></TD
78 
></TR
79 
></TABLE
80 
><HR
81 
ALIGN="LEFT"
82 
WIDTH="100%"></DIV
83 
><H1
84 
><A
85 
NAME="REF.MAKE-OBJECT"><SPAN
86 
CLASS="PROPERTY"
87 
>make_object</SPAN
88 
></H1
89 
><DIV
90 
CLASS="REFNAMEDIV"
91 
><A
92 
NAME="AEN4770"
93 
></A
94 
><H2
95 
>Name</H2
96 
>Property <SPAN
97 
CLASS="PROPERTY"
98 
>make_object</SPAN
99 
>&nbsp;--&nbsp;Define a custom build step, resulting in an object file
100 
that should go into a library.</DIV
101 
><DIV
102 
CLASS="REFSYNOPSISDIV"
103 
><A
104 
NAME="AEN4774"><H2
105 
>Synopsis</H2
106 
><TABLE
107 
BORDER="5"
108 
BGCOLOR="#E0E0F0"
109 
WIDTH="70%"
110 
><TR
111 
><TD
112 
><PRE
113 
CLASS="SYNOPSIS"
114 
>cdl_option &lt;name&gt; {
115 
    make_object [-library=&lt;library&gt;] [-priority=&lt;pri&gt;]  {
116 
        &lt;custom build step&gt;
117 
    }
118 
    &#8230;
119 
}</PRE
120 
></TD
121 
></TR
122 
></TABLE
123 
></DIV
124 
><DIV
125 
CLASS="REFSECT1"
126 
><A
127 
NAME="AEN4776"
128 
></A
129 
><H2
130 
>Description</H2
131 
><P
132 
>When building an <SPAN
133 
CLASS="APPLICATION"
134 
>eCos</SPAN
135 
> configuration the primary target is a single
136 
library, <TT
137 
CLASS="FILENAME"
138 
>libtarget.a</TT
139 
>. Most of the object files
140 
which go into this library will be generated as a result of <SPAN
141 
CLASS="PROPERTY"
142 
>compile</SPAN
143 
>
144 
properties. Occasionally it may be necessary to have special build
145 
steps for a given object file, and this can be achieved with a
146 
<SPAN
147 
CLASS="PROPERTY"
148 
>make_object</SPAN
149 
> property. The use of this property should be avoided
150 
whenever possible because it greatly increases the risk of portability
151 
problems, both on the host side because of possible problems with the
152 
tools, and on the target side because a custom build step may not
153 
allow adequately for the wide variety of architectures supported by
154 
<SPAN
155 
CLASS="APPLICATION"
156 
>eCos</SPAN
157 
>.</P
158 
><P
159 
>The <SPAN
160 
CLASS="PROPERTY"
161 
>make_object</SPAN
162 
> property takes a single argument, which resembles a
163 
makefile rule: it consists of a target, a list of dependencies, and
164 
one or more commands that should be executed. The target should be an
165 
object file. However the <SPAN
166 
CLASS="PROPERTY"
167 
>make_object</SPAN
168 
> argument is not a makefile
169 
fragment, and custom build steps may get executed in build
170 
environments that do not involve make. For full details of custom
171 
build steps see <A
172 
HREF="build.make.html#BUILD.CUSTOM"
173 
>the Section called <I
174 
>Custom Build Steps</I
175 
> in Chapter 4</A
176 
>.</P
177 
><DIV
178 
CLASS="WARNING"
179 
><P
180 
></P
181 
><TABLE
182 
CLASS="WARNING"
183 
BORDER="1"
184 
WIDTH="100%"
185 
><TR
186 
><TD
187 
ALIGN="CENTER"
188 
><B
189 
>Warning</B
190 
></TD
191 
></TR
192 
><TR
193 
><TD
194 
ALIGN="LEFT"
195 
><P
196 
>The exact syntax and limitations of custom build steps have not yet
197 
been finalized, and may change in future versions of the
198 
configuration tools.</P
199 
></TD
200 
></TR
201 
></TABLE
202 
></DIV
203 
><P
204 
>The <SPAN
205 
CLASS="PROPERTY"
206 
>make_object</SPAN
207 
> property takes an optional library argument. If no
208 
library is specified then the default library for the current package
209 
will be used, which will be <TT
210 
CLASS="FILENAME"
211 
>libtarget.a</TT
212 
> unless
213 
the <TT
214 
CLASS="LITERAL"
215 
>cdl_package</TT
216 
> command contains a <SPAN
217 
CLASS="PROPERTY"
218 
>library</SPAN
219 
> property.</P
220 
><P
221 
>The <SPAN
222 
CLASS="PROPERTY"
223 
>make_object</SPAN
224 
> property also takes an optional priority argument
225 
indicating the order in which build steps take place. This priority
226 
complements the dependency list, and avoids problems with packages
227 
needing to know details of custom build steps in other packages (which
228 
may change between releases). The defined order is:</P
229 
><P
230 
></P
231 
><DIV
232 
CLASS="VARIABLELIST"
233 
><DL
234 
><DT
235 
>Priority 0</DT
236 
><DD
237 
><P
238 
>The header files exported by the current set of packages are copied
239 
to the appropriate places in the
240 
<TT
241 
CLASS="FILENAME"
242 
>include</TT
243 
> subdirectory of the
244 
install tree. Any unnecessary copies are avoided, to prevent rebuilds
245 
of package and application source modules caused by header file dependencies.</P
246 
><DIV
247 
CLASS="NOTE"
248 
><BLOCKQUOTE
249 
CLASS="NOTE"
250 
><P
251 
><B
252 
>Note: </B
253 
>A possible future enhancement of the build system may result in the
254 
build and install trees being updated automatically if there has been
255 
a change to the <TT
256 
CLASS="FILENAME"
257 
>ecos.ecc</TT
258 
> configuration savefile.</P
259 
></BLOCKQUOTE
260 
></DIV
261 
></DD
262 
><DT
263 
>Priority 100</DT
264 
><DD
265 
><P
266 
>All files specified in <SPAN
267 
CLASS="PROPERTY"
268 
>compile</SPAN
269 
> properties will get built, producing
270 
the corresponding object files. In addition any custom build steps
271 
defined by <SPAN
272 
CLASS="PROPERTY"
273 
>make_object</SPAN
274 
> properties get executed, unless there is a
275 
<TT
276 
CLASS="LITERAL"
277 
>-priority=</TT
278 
> option.</P
279 
></DD
280 
><DT
281 
>Priority 200</DT
282 
><DD
283 
><P
284 
>The libraries now get built using the appropriate object files.</P
285 
></DD
286 
><DT
287 
>Priority 300</DT
288 
><DD
289 
><P
290 
>Any custom build steps specified by <SPAN
291 
CLASS="PROPERTY"
292 
>make</SPAN
293 
> properties now get
294 
executed, unless the priority for a particular build step is changed
295 
from its default.</P
296 
></DD
297 
></DL
298 
></DIV
299 
><P
300 
>For example, if a custom build step needs to take place before any of
301 
the normal source files get compiled then it should be given a
302 
priority somewhere between 0 and 100. If a custom build step involves
303 
post-processing an object file prior to its incorporation into a
304 
library then a priority between 100 and 200 should be used. It is not
305 
sensible to have a priority above 200, since that would imply building
306 
an additional object file for a library that has already been created.</P
307 
></DIV
308 
><DIV
309 
CLASS="REFSECT1"
310 
><A
311 
NAME="AEN4823"
312 
></A
313 
><H2
314 
>Example</H2
315 
><TABLE
316 
BORDER="5"
317 
BGCOLOR="#E0E0F0"
318 
WIDTH="70%"
319 
><TR
320 
><TD
321 
><PRE
322 
CLASS="PROGRAMLISTING"
323 
>cdl_option XXX {
324 
    &#8230;
325 
    make_object {
326 
        parser.o: parser.y
327 
                yacc $&lt;
328 
                $(CC) $(CFLAGS) -o $@ y.tab.c
329 
    }
330 
}</PRE
331 
></TD
332 
></TR
333 
></TABLE
334 
></DIV
335 
><DIV
336 
CLASS="REFSECT1"
337 
><A
338 
NAME="AEN4826"
339 
></A
340 
><H2
341 
>See Also</H2
342 
><P
343 
>Properties <A
344 
HREF="ref.compile.html"
345 
>compile</A
346 
>,
347 
<A
348 
HREF="ref.make.html"
349 
>make</A
350 
> and
351 
<A
352 
HREF="ref.library.html"
353 
>library</A
354 
>.</P
355 
></DIV
356 
><DIV
357 
CLASS="NAVFOOTER"
358 
><HR
359 
ALIGN="LEFT"
360 
WIDTH="100%"><TABLE
361 
SUMMARY="Footer navigation table"
362 
WIDTH="100%"
363 
BORDER="0"
364 
CELLPADDING="0"
365 
CELLSPACING="0"
366 
><TR
367 
><TD
368 
WIDTH="33%"
369 
ALIGN="left"
370 
VALIGN="top"
371 
><A
372 
HREF="ref.make.html"
373 
ACCESSKEY="P"
374 
>Prev</A
375 
></TD
376 
><TD
377 
WIDTH="34%"
378 
ALIGN="center"
379 
VALIGN="top"
380 
><A
381 
HREF="cdl-guide.html"
382 
ACCESSKEY="H"
383 
>Home</A
384 
></TD
385 
><TD
386 
WIDTH="33%"
387 
ALIGN="right"
388 
VALIGN="top"
389 
><A
390 
HREF="ref.no-define.html"
391 
ACCESSKEY="N"
392 
>Next</A
393 
></TD
394 
></TR
395 
><TR
396 
><TD
397 
WIDTH="33%"
398 
ALIGN="left"
399 
VALIGN="top"
400 
><SPAN
401 
CLASS="PROPERTY"
402 
>make</SPAN
403 
></TD
404 
><TD
405 
WIDTH="34%"
406 
ALIGN="center"
407 
VALIGN="top"
408 
><A
409 
HREF="reference.html"
410 
ACCESSKEY="U"
411 
>Up</A
412 
></TD
413 
><TD
414 
WIDTH="33%"
415 
ALIGN="right"
416 
VALIGN="top"
417 
><SPAN
418 
CLASS="PROPERTY"
419 
>no_define</SPAN
420 
></TD
421 
></TR
422 
></TABLE
423 
></DIV
424 
></BODY
425 
></HTML
426 
>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.