doc/html/user-guide/config-tool-building.html

   1 <!-- 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) &#8211; 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  &#8211; 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  &#8211; 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  &#8211; 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-&gt;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 &#8220;LDFLAGS&#8221; 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&#8217;s
 206 build options are combined with the global options (these are to
 207 be found in the &#8220;Global build options&#8221; 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 >-&gt;<SPAN
 239 CLASS="emphasis"
 240 ><I
 241 CLASS="EMPHASIS"
 242 >Paths</I
 243 ></SPAN
 244 >-&gt;<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 >