URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [config-tool-building.html] - Blame information for rev 588

Go to most recent revision | Details | Compare with Previous | 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
>Building</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos User Guide"
HREF="ecos-user-guide.html"><LINK
REL="UP"
TITLE="The eCos Configuration Tool"
HREF="the-ecos-configuration-tool.html"><LINK
REL="PREVIOUS"
TITLE="Searching"
HREF="config-tool-searching.html"><LINK
REL="NEXT"
TITLE="Selecting User Tools"
HREF="config-tool-selecting-user-tools.html"></HEAD
><BODY
CLASS="CHAPTER"
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"
>eCos User Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="config-tool-searching.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="config-tool-selecting-user-tools.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="CHAPTER"
><H1
><A
NAME="CONFIG-TOOL-BUILDING">Chapter 21. Building</H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="config-tool-building.html#CONFIG-TOOL-SELECTING-BUILD-TOOLS"
>Selecting Build Tools</A
></DT
><DT
><A
HREF="config-tool-selecting-user-tools.html"
>Selecting User Tools</A
></DT
></DL
></DIV
><P
>When you have configured <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
>, you may build the configuration.</P
><P
>On the <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Build</I
></SPAN
> menu, click:</P
><P
></P
><UL
><LI
><P
>
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Library</I
></SPAN
>
 (or click the Build Library icon on the toolbar) &#8211; this
causes the <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> configuration to be built. The result of a successful
build will be (among other things) a library against which user
code can be linked</P
></LI
><LI
><P
>
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Tests</I
></SPAN
>
 &#8211; this causes the <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> configuration to be built, and
additionally builds the relevant test cases linked against the <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
> library</P
></LI
><LI
><P
>
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Clean</I
></SPAN
>
 &#8211; this removes all intermediate files, thus causing a
subsequent build/library or build/tests operation
to cause recompilation of all relevant files.</P
></LI
><LI
><P
>
<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Stop</I
></SPAN
>
 &#8211; this causes a currently executing build (any of the
above steps) to be interrupted</P
></LI
></UL
><P
>Build options may be displayed by using the <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Build-&gt;Options</I
></SPAN
> menu
item. This displays a dialog box containing a drop-list control
and two windows. The drop-list control allows you to select the
type of build option to be displayed (for example &#8220;LDFLAGS&#8221; are
the options applied at link-time. The left-hand window is a tree
view of the packages loaded in the current configuration. The right-hand
window is a list of the build options that will be used for the
currently selected package.</P
><P
>Note that this dialog box currently affords only read-only
access to the build options. In order to change build options you
must edit the relevant string configuration item.</P
><P
>A single level of inheritance is supported: each package&#8217;s
build options are combined with the global options (these are to
be found in the &#8220;Global build options&#8221; folder
in the configuration view).</P
><P
><P
><IMG
SRC="pix/buildoptions.png"></P
></P
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="CONFIG-TOOL-SELECTING-BUILD-TOOLS">Selecting Build Tools</H1
><P
>Normally the installation process will supply the information
required for the <SPAN
CLASS="PRODUCTNAME"
>eCos</SPAN
><SPAN
CLASS="APPLICATION"
>Configuration Tool</SPAN
> to
locate the build tools (compiler, linker, etc.) necessary
to perform a build. However if this information is not registered,
or it is necessary to specify the location manually (for example,
when a new toolchain installation has been made), select <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Tools</I
></SPAN
>-&gt;<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Paths</I
></SPAN
>-&gt;<SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Build
Tools</I
></SPAN
>. The following dialog box will be displayed:</P
><DIV
CLASS="FIGURE"
><A
NAME="AEN1521"><P
><B
>Figure 21-1. Build tools</B
></P
><P
><IMG
SRC="pix/build-tools2.png"></P
></DIV
><P
>This dialog box allows you to locate the folder containing
the build tools. </P
></DIV
></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="config-tool-searching.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-user-guide.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="config-tool-selecting-user-tools.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Searching</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="the-ecos-configuration-tool.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Selecting User Tools</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

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			`>Building</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="eCos User Guide"`
20			`HREF="ecos-user-guide.html"><LINK`
21			`REL="UP"`
22			`TITLE="The eCos Configuration Tool"`
23			`HREF="the-ecos-configuration-tool.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="Searching"`
26			`HREF="config-tool-searching.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="Selecting User Tools"`
29			`HREF="config-tool-selecting-user-tools.html"></HEAD`
30			`><BODY`
31			`CLASS="CHAPTER"`
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			`>eCos User Guide</TH`
50			`></TR`
51			`><TR`
52			`><TD`
53			`WIDTH="10%"`
54			`ALIGN="left"`
55			`VALIGN="bottom"`
56			`><A`
57			`HREF="config-tool-searching.html"`
58			`ACCESSKEY="P"`
59			`>Prev</A`
60			`></TD`
61			`><TD`
62			`WIDTH="80%"`
63			`ALIGN="center"`
64			`VALIGN="bottom"`
65			`></TD`
66			`><TD`
67			`WIDTH="10%"`
68			`ALIGN="right"`
69			`VALIGN="bottom"`
70			`><A`
71			`HREF="config-tool-selecting-user-tools.html"`
72			`ACCESSKEY="N"`
73			`>Next</A`
74			`></TD`
75			`></TR`
76			`></TABLE`
77			`><HR`
78			`ALIGN="LEFT"`
79			`WIDTH="100%"></DIV`
80			`><DIV`
81			`CLASS="CHAPTER"`
82			`><H1`
83			`><A`
84			`NAME="CONFIG-TOOL-BUILDING">Chapter 21. Building</H1`
85			`><DIV`
86			`CLASS="TOC"`
87			`><DL`
88			`><DT`
89			`><B`
90			`>Table of Contents</B`
91			`></DT`
92			`><DT`
93			`><A`
94			`HREF="config-tool-building.html#CONFIG-TOOL-SELECTING-BUILD-TOOLS"`
95			`>Selecting Build Tools</A`
96			`></DT`
97			`><DT`
98			`><A`
99			`HREF="config-tool-selecting-user-tools.html"`
100			`>Selecting User Tools</A`
101			`></DT`
102			`></DL`
103			`></DIV`
104			`><P`
105			`>When you have configured <SPAN`
106			`CLASS="PRODUCTNAME"`
107			`>eCos</SPAN`
108			`>, you may build the configuration.</P`
109			`><P`
110			`>On the <SPAN`
111			`CLASS="emphasis"`
112			`><I`
113			`CLASS="EMPHASIS"`
114			`>Build</I`
115			`></SPAN`
116			`> menu, click:</P`
117			`><P`
118			`></P`
119			`><UL`
120			`><LI`
121			`><P`
122			`>`
123			`<SPAN`
124			`CLASS="emphasis"`
125			`><I`
126			`CLASS="EMPHASIS"`
127			`>Library</I`
128			`></SPAN`
129			`>`
130			`(or click the Build Library icon on the toolbar) – this`
131			`causes the <SPAN`
132			`CLASS="PRODUCTNAME"`
133			`>eCos</SPAN`
134			`> configuration to be built. The result of a successful`
135			`build will be (among other things) a library against which user`
136			`code can be linked</P`
137			`></LI`
138			`><LI`
139			`><P`
140			`>`
141			`<SPAN`
142			`CLASS="emphasis"`
143			`><I`
144			`CLASS="EMPHASIS"`
145			`>Tests</I`
146			`></SPAN`
147			`>`
148			`– this causes the <SPAN`
149			`CLASS="PRODUCTNAME"`
150			`>eCos</SPAN`
151			`> configuration to be built, and`
152			`additionally builds the relevant test cases linked against the <SPAN`
153			`CLASS="PRODUCTNAME"`
154			`>eCos</SPAN`
155			`> library</P`
156			`></LI`
157			`><LI`
158			`><P`
159			`>`
160			`<SPAN`
161			`CLASS="emphasis"`
162			`><I`
163			`CLASS="EMPHASIS"`
164			`>Clean</I`
165			`></SPAN`
166			`>`
167			`– this removes all intermediate files, thus causing a`
168			`subsequent build/library or build/tests operation`
169			`to cause recompilation of all relevant files.</P`
170			`></LI`
171			`><LI`
172			`><P`
173			`>`
174			`<SPAN`
175			`CLASS="emphasis"`
176			`><I`
177			`CLASS="EMPHASIS"`
178			`>Stop</I`
179			`></SPAN`
180			`>`
181			`– this causes a currently executing build (any of the`
182			`above steps) to be interrupted</P`
183			`></LI`
184			`></UL`
185			`><P`
186			`>Build options may be displayed by using the <SPAN`
187			`CLASS="emphasis"`
188			`><I`
189			`CLASS="EMPHASIS"`
190			`>Build->Options</I`
191			`></SPAN`
192			`> menu`
193			`item. This displays a dialog box containing a drop-list control`
194			`and two windows. The drop-list control allows you to select the`
195			`type of build option to be displayed (for example “LDFLAGS” are`
196			`the options applied at link-time. The left-hand window is a tree`
197			`view of the packages loaded in the current configuration. The right-hand`
198			`window is a list of the build options that will be used for the`
199			`currently selected package.</P`
200			`><P`
201			`>Note that this dialog box currently affords only read-only`
202			`access to the build options. In order to change build options you`
203			`must edit the relevant string configuration item.</P`
204			`><P`
205			`>A single level of inheritance is supported: each package’s`
206			`build options are combined with the global options (these are to`
207			`be found in the “Global build options” folder`
208			`in the configuration view).</P`
209			`><P`
210			`><P`
211			`><IMG`
212			`SRC="pix/buildoptions.png"></P`
213			`></P`
214			`><DIV`
215			`CLASS="SECT1"`
216			`><H1`
217			`CLASS="SECT1"`
218			`><A`
219			`NAME="CONFIG-TOOL-SELECTING-BUILD-TOOLS">Selecting Build Tools</H1`
220			`><P`
221			`>Normally the installation process will supply the information`
222			`required for the <SPAN`
223			`CLASS="PRODUCTNAME"`
224			`>eCos</SPAN`
225			`><SPAN`
226			`CLASS="APPLICATION"`
227			`>Configuration Tool</SPAN`
228			`> to`
229			`locate the build tools (compiler, linker, etc.) necessary`
230			`to perform a build. However if this information is not registered,`
231			`or it is necessary to specify the location manually (for example,`
232			`when a new toolchain installation has been made), select <SPAN`
233			`CLASS="emphasis"`
234			`><I`
235			`CLASS="EMPHASIS"`
236			`>Tools</I`
237			`></SPAN`
238			`>-><SPAN`
239			`CLASS="emphasis"`
240			`><I`
241			`CLASS="EMPHASIS"`
242			`>Paths</I`
243			`></SPAN`
244			`>-><SPAN`
245			`CLASS="emphasis"`
246			`><I`
247			`CLASS="EMPHASIS"`
248			`>Build`
249			`Tools</I`
250			`></SPAN`
251			`>. The following dialog box will be displayed:</P`
252			`><DIV`
253			`CLASS="FIGURE"`
254			`><A`
255			`NAME="AEN1521"><P`
256			`><B`
257			`>Figure 21-1. Build tools</B`
258			`></P`
259			`><P`
260			`><IMG`
261			`SRC="pix/build-tools2.png"></P`
262			`></DIV`
263			`><P`
264			`>This dialog box allows you to locate the folder containing`
265			`the build tools. </P`
266			`></DIV`
267			`></DIV`
268			`><DIV`
269			`CLASS="NAVFOOTER"`
270			`><HR`
271			`ALIGN="LEFT"`
272			`WIDTH="100%"><TABLE`
273			`SUMMARY="Footer navigation table"`
274			`WIDTH="100%"`
275			`BORDER="0"`
276			`CELLPADDING="0"`
277			`CELLSPACING="0"`
278			`><TR`
279			`><TD`
280			`WIDTH="33%"`
281			`ALIGN="left"`
282			`VALIGN="top"`
283			`><A`
284			`HREF="config-tool-searching.html"`
285			`ACCESSKEY="P"`
286			`>Prev</A`
287			`></TD`
288			`><TD`
289			`WIDTH="34%"`
290			`ALIGN="center"`
291			`VALIGN="top"`
292			`><A`
293			`HREF="ecos-user-guide.html"`
294			`ACCESSKEY="H"`
295			`>Home</A`
296			`></TD`
297			`><TD`
298			`WIDTH="33%"`
299			`ALIGN="right"`
300			`VALIGN="top"`
301			`><A`
302			`HREF="config-tool-selecting-user-tools.html"`
303			`ACCESSKEY="N"`
304			`>Next</A`
305			`></TD`
306			`></TR`
307			`><TR`
308			`><TD`
309			`WIDTH="33%"`
310			`ALIGN="left"`
311			`VALIGN="top"`
312			`>Searching</TD`
313			`><TD`
314			`WIDTH="34%"`
315			`ALIGN="center"`
316			`VALIGN="top"`
317			`><A`
318			`HREF="the-ecos-configuration-tool.html"`
319			`ACCESSKEY="U"`
320			`>Up</A`
321			`></TD`
322			`><TD`
323			`WIDTH="33%"`
324			`ALIGN="right"`
325			`VALIGN="top"`
326			`>Selecting User Tools</TD`
327			`></TR`
328			`></TABLE`
329			`></DIV`
330			`></BODY`
331			`></HTML`
332			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [user-guide/] [config-tool-building.html] - Blame information for rev 588