doc/html/user-guide/manual-configuration.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 >Manual Configuration</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="Configuration and the Package Repository"
  23 HREF="configuration-and-the-package-repository.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Configuration and the Package Repository"
  26 HREF="configuration-and-the-package-repository.html"><LINK
  27 REL="NEXT"
  28 TITLE="Creating the Build Tree"
  29 HREF="creating-build-tree.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="configuration-and-the-package-repository.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="creating-build-tree.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="MANUAL-CONFIGURATION">Chapter 28. Manual Configuration</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="manual-configuration.html#DIRECTORY-TREE-STRUCTURE"
  95 >Directory Tree Structure</A
  96 ></DT
  97 ><DT
  98 ><A
  99 HREF="creating-build-tree.html"
 100 >Creating the Build Tree</A
 101 ></DT
 102 ><DT
 103 ><A
 104 HREF="conflicts-and-constraints.html"
 105 >Conflicts and constraints</A
 106 ></DT
 107 ><DT
 108 ><A
 109 HREF="building-the-system.html"
 110 >Building the System</A
 111 ></DT
 112 ><DT
 113 ><A
 114 HREF="ecos-packages.html"
 115 >Packages</A
 116 ></DT
 117 ><DT
 118 ><A
 119 HREF="coarse-grained-configuration.html"
 120 >Coarse-grained Configuration</A
 121 ></DT
 122 ><DT
 123 ><A
 124 HREF="fine-grained-configuration.html"
 125 >Fine-grained Configuration</A
 126 ></DT
 127 ><DT
 128 ><A
 129 HREF="editing-an-ecos-savefile.html"
 130 >Editing an <SPAN
 131 CLASS="PRODUCTNAME"
 132 >eCos</SPAN
 133 > Savefile</A
 134 ></DT
 135 ><DT
 136 ><A
 137 HREF="editing-the-sources.html"
 138 >Editing the Sources</A
 139 ></DT
 140 ><DT
 141 ><A
 142 HREF="modifying-the-memory-layout.html"
 143 >Modifying the Memory Layout</A
 144 ></DT
 145 ></DL
 146 ></DIV
 147 ><P
 148 ><SPAN
 149 CLASS="PRODUCTNAME"
 150 >eCos</SPAN
 151 > developers will generally use the graphical
 152       Configuration Tool for configuring an <SPAN
 153 CLASS="PRODUCTNAME"
 154 >eCos</SPAN
 155 > system and building
 156       the target library. However, some user prefer to use command
 157       line tools. These command line tools can also be used for batch
 158       operations on all platforms, for example as part of a nightly
 159       rebuild and testing procedure.
 160     </P
 161 ><P
 162 >In the current release of the system the command line tools
 163       do not provide exactly the same functionality as the graphical
 164       tool. Most importantly, there is no facility to resolve
 165       configuration conflicts interactively.</P
 166 ><P
 167 >The <SPAN
 168 CLASS="PRODUCTNAME"
 169 >eCos</SPAN
 170 > configuration system, both graphical and command
 171       line tools, are under constant development and enhancement.
 172       Developers should note that the procedures described may change
 173       considerably in future releases. </P
 174 ><DIV
 175 CLASS="SECT1"
 176 ><H1
 177 CLASS="SECT1"
 178 ><A
 179 NAME="DIRECTORY-TREE-STRUCTURE">Directory Tree Structure</H1
 180 ><P
 181 >When building <SPAN
 182 CLASS="PRODUCTNAME"
 183 >eCos</SPAN
 184 > there are three main directory trees to
 185         consider: the source tree, the build tree, and the install
 186         tree.</P
 187 ><P
 188 >The source tree, also known as the component repository,
 189           is read-only. It is possible to use a single component
 190           repository for any number of different configurations, and
 191           it is also possible to share a component repository between
 192           multiple users by putting it on a network drive.</P
 193 ><P
 194 >The build tree contains everything that is specific to a
 195           particular configuration, including header and other files
 196           that contain configuration data, and the object files that
 197           result from compiling the system sources for this
 198           configuration. </P
 199 ><P
 200 >The install tree is usually located in the <TT
 201 CLASS="FILENAME"
 202 >install</TT
 203 > subdirectory
 204 of the build tree. Once an <SPAN
 205 CLASS="PRODUCTNAME"
 206 >eCos</SPAN
 207 > system has been built, the install
 208 tree contains all the files needed for application development including
 209 the header files and the target library. By making copies of the
 210 install tree after a build it is possible to separate application
 211 development and system configuration, which may be desirable for
 212 some organizations. </P
 213 ></DIV
 214 ></DIV
 215 ><DIV
 216 CLASS="NAVFOOTER"
 217 ><HR
 218 ALIGN="LEFT"
 219 WIDTH="100%"><TABLE
 220 SUMMARY="Footer navigation table"
 221 WIDTH="100%"
 222 BORDER="0"
 223 CELLPADDING="0"
 224 CELLSPACING="0"
 225 ><TR
 226 ><TD
 227 WIDTH="33%"
 228 ALIGN="left"
 229 VALIGN="top"
 230 ><A
 231 HREF="configuration-and-the-package-repository.html"
 232 ACCESSKEY="P"
 233 >Prev</A
 234 ></TD
 235 ><TD
 236 WIDTH="34%"
 237 ALIGN="center"
 238 VALIGN="top"
 239 ><A
 240 HREF="ecos-user-guide.html"
 241 ACCESSKEY="H"
 242 >Home</A
 243 ></TD
 244 ><TD
 245 WIDTH="33%"
 246 ALIGN="right"
 247 VALIGN="top"
 248 ><A
 249 HREF="creating-build-tree.html"
 250 ACCESSKEY="N"
 251 >Next</A
 252 ></TD
 253 ></TR
 254 ><TR
 255 ><TD
 256 WIDTH="33%"
 257 ALIGN="left"
 258 VALIGN="top"
 259 >Configuration and the Package Repository</TD
 260 ><TD
 261 WIDTH="34%"
 262 ALIGN="center"
 263 VALIGN="top"
 264 ><A
 265 HREF="configuration-and-the-package-repository.html"
 266 ACCESSKEY="U"
 267 >Up</A
 268 ></TD
 269 ><TD
 270 WIDTH="33%"
 271 ALIGN="right"
 272 VALIGN="top"
 273 >Creating the Build Tree</TD
 274 ></TR
 275 ></TABLE
 276 ></DIV
 277 ></BODY
 278 ></HTML
 279 >