doc/html/user-guide/component-repo-and-working-dirs.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 >The Component Repository and Working Directories</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="eCos Programming Concepts and Techniques"
  23 HREF="ecos-programming-concepts-and-techniques.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Templates"
  26 HREF="cdl-templates.html"><LINK
  27 REL="NEXT"
  28 TITLE="Build Tree"
  29 HREF="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="cdl-templates.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="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="COMPONENT-REPO-AND-WORKING-DIRS">Chapter 25. The Component Repository and Working Directories</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="component-repo-and-working-dirs.html#COMPONENT-REPO"
  95 >Component Repository</A
  96 ></DT
  97 ><DT
  98 ><A
  99 HREF="build-tree.html"
 100 >Build Tree</A
 101 ></DT
 102 ><DT
 103 ><A
 104 HREF="install-tree.html"
 105 >Install Tree</A
 106 ></DT
 107 ><DT
 108 ><A
 109 HREF="repository-app-build-tree.html"
 110 >Application Build Tree</A
 111 ></DT
 112 ></DL
 113 ></DIV
 114 ><P
 115 >Each of the file trees involved in <SPAN
 116 CLASS="PRODUCTNAME"
 117 >eCos</SPAN
 118 > development has a
 119         different role. </P
 120 ><DIV
 121 CLASS="SECT1"
 122 ><H1
 123 CLASS="SECT1"
 124 ><A
 125 NAME="COMPONENT-REPO">Component Repository</H1
 126 ><P
 127 >The <SPAN
 128 CLASS="PRODUCTNAME"
 129 >eCos</SPAN
 130 > <I
 131 CLASS="FIRSTTERM"
 132 >component repository</I
 133 >
 134           contains directories for all the packages that are shipped
 135           with <SPAN
 136 CLASS="PRODUCTNAME"
 137 >eCos</SPAN
 138 > or provided by third parties.</P
 139 ><P
 140 >The component repository should not be modified as part of
 141 application development. </P
 142 ><DIV
 143 CLASS="FIGURE"
 144 ><A
 145 NAME="AEN2022"><P
 146 ><B
 147 >Figure 25-1. Component repository</B
 148 ></P
 149 ><P
 150 ><IMG
 151 SRC="pix/comprepos.png"></P
 152 ></DIV
 153 ><DIV
 154 CLASS="SECT2"
 155 ><H2
 156 CLASS="SECT2"
 157 ><A
 158 NAME="AEN2025">Purpose</H2
 159 ><P
 160 >The component repository is the master copy of source code
 161 for all system and third party components. It also contains some
 162 files needed to administer and build the system, such as <B
 163 CLASS="COMMAND"
 164 >ecosadmin.tcl</B
 165 >.</P
 166 ></DIV
 167 ><DIV
 168 CLASS="SECT2"
 169 ><H2
 170 CLASS="SECT2"
 171 ><A
 172 NAME="AEN2029">How is it modified?</H2
 173 ><P
 174 >You modify it by importing new versions of packages from a
 175 distribution or removing existing packages. These activities are
 176 undertaken using the <SPAN
 177 CLASS="PRODUCTNAME"
 178 >eCos</SPAN
 179 > <SPAN
 180 CLASS="APPLICATION"
 181 >Package Administration Tool</SPAN
 182 >.</P
 183 ></DIV
 184 ><DIV
 185 CLASS="SECT2"
 186 ><H2
 187 CLASS="SECT2"
 188 ><A
 189 NAME="AEN2034">When is it edited manually?</H2
 190 ><P
 191 >Files in the component repository should only be edited manually
 192 as determined by the component maintainer.</P
 193 ></DIV
 194 ><DIV
 195 CLASS="SECT2"
 196 ><H2
 197 CLASS="SECT2"
 198 ><A
 199 NAME="AEN2037">User Applications</H2
 200 ><P
 201 >User application source code should <SPAN
 202 CLASS="emphasis"
 203 ><I
 204 CLASS="EMPHASIS"
 205 >not</I
 206 ></SPAN
 207 > go
 208 into the component repository.</P
 209 ></DIV
 210 ><DIV
 211 CLASS="SECT2"
 212 ><H2
 213 CLASS="SECT2"
 214 ><A
 215 NAME="AEN2041">Examples of files in this hierarchy:</H2
 216 ><P
 217 ></P
 218 ><DIV
 219 CLASS="VARIABLELIST"
 220 ><DL
 221 ><DT
 222 ><TT
 223 CLASS="FILENAME"
 224 ><TT
 225 CLASS="REPLACEABLE"
 226 ><I
 227 >BASE_DIR</I
 228 ></TT
 229 >/doc/ref/ecos-ref.html</TT
 230 ></DT
 231 ><DD
 232 ><P
 233 >The top level HTML file for the
 234                   <I
 235 CLASS="CITETITLE"
 236 ><SPAN
 237 CLASS="PRODUCTNAME"
 238 >eCos</SPAN
 239 > Reference
 240                     Manual</I
 241 >. </P
 242 ></DD
 243 ><DT
 244 ><TT
 245 CLASS="FILENAME"
 246 ><TT
 247 CLASS="REPLACEABLE"
 248 ><I
 249 >BASE_DIR</I
 250 ></TT
 251 >/prebuilt/pid/tests/kernel/<TT
 252 CLASS="REPLACEABLE"
 253 ><I
 254 >&#60;version&#62;</I
 255 ></TT
 256 >/tests/thread_gdb.exe</TT
 257 ></DT
 258 ><DD
 259 ><P
 260 ></P
 261 ></DD
 262 ><DT
 263 ><TT
 264 CLASS="FILENAME"
 265 ><TT
 266 CLASS="REPLACEABLE"
 267 ><I
 268 >BASE_DIR</I
 269 ></TT
 270 >/prebuilt/linux/tests/kernel/<TT
 271 CLASS="REPLACEABLE"
 272 ><I
 273 >&#60;version&#62;</I
 274 ></TT
 275 >/tests/thread_gdb.exe</TT
 276 ></DT
 277 ><DD
 278 ><P
 279 >Pre-built tests for the supported platforms, and
 280                   the synthetic Linux target.</P
 281 ></DD
 282 ><DT
 283 ><TT
 284 CLASS="FILENAME"
 285 ><TT
 286 CLASS="REPLACEABLE"
 287 ><I
 288 >BASE_DIR</I
 289 ></TT
 290 >/examples/twothreads.c</TT
 291 ></DT
 292 ><DD
 293 ><P
 294 >One of the example programs.</P
 295 ></DD
 296 ><DT
 297 ><TT
 298 CLASS="FILENAME"
 299 ><TT
 300 CLASS="REPLACEABLE"
 301 ><I
 302 >BASE_DIR</I
 303 ></TT
 304 >/ecosadmin.tcl</TT
 305 ></DT
 306 ><DD
 307 ><P
 308 >The Tcl program which is used to  import new versions of packages
 309 from a distribution or remove existing packages.</P
 310 ></DD
 311 ><DT
 312 ><TT
 313 CLASS="FILENAME"
 314 ><TT
 315 CLASS="REPLACEABLE"
 316 ><I
 317 >BASE_DIR</I
 318 ></TT
 319 >/packages/language/c/libm/<TT
 320 CLASS="REPLACEABLE"
 321 ><I
 322 >&#60;version&#62;</I
 323 ></TT
 324 >/src/double/portable-api/s_tanh.c</TT
 325 ></DT
 326 ><DD
 327 ><P
 328 >Implementation of the hyperbolic tangent function in the standard
 329 math library.</P
 330 ></DD
 331 ><DT
 332 ><TT
 333 CLASS="FILENAME"
 334 ><TT
 335 CLASS="REPLACEABLE"
 336 ><I
 337 >BASE_DIR</I
 338 ></TT
 339 >/pkgconf/rules.mak</TT
 340 ></DT
 341 ><DD
 342 ><P
 343 >A file with <B
 344 CLASS="COMMAND"
 345 >make</B
 346 > rules, used
 347 by the <TT
 348 CLASS="FILENAME"
 349 >makefile</TT
 350 >.</P
 351 ></DD
 352 ></DL
 353 ></DIV
 354 ></DIV
 355 ></DIV
 356 ></DIV
 357 ><DIV
 358 CLASS="NAVFOOTER"
 359 ><HR
 360 ALIGN="LEFT"
 361 WIDTH="100%"><TABLE
 362 SUMMARY="Footer navigation table"
 363 WIDTH="100%"
 364 BORDER="0"
 365 CELLPADDING="0"
 366 CELLSPACING="0"
 367 ><TR
 368 ><TD
 369 WIDTH="33%"
 370 ALIGN="left"
 371 VALIGN="top"
 372 ><A
 373 HREF="cdl-templates.html"
 374 ACCESSKEY="P"
 375 >Prev</A
 376 ></TD
 377 ><TD
 378 WIDTH="34%"
 379 ALIGN="center"
 380 VALIGN="top"
 381 ><A
 382 HREF="ecos-user-guide.html"
 383 ACCESSKEY="H"
 384 >Home</A
 385 ></TD
 386 ><TD
 387 WIDTH="33%"
 388 ALIGN="right"
 389 VALIGN="top"
 390 ><A
 391 HREF="build-tree.html"
 392 ACCESSKEY="N"
 393 >Next</A
 394 ></TD
 395 ></TR
 396 ><TR
 397 ><TD
 398 WIDTH="33%"
 399 ALIGN="left"
 400 VALIGN="top"
 401 >Templates</TD
 402 ><TD
 403 WIDTH="34%"
 404 ALIGN="center"
 405 VALIGN="top"
 406 ><A
 407 HREF="ecos-programming-concepts-and-techniques.html"
 408 ACCESSKEY="U"
 409 >Up</A
 410 ></TD
 411 ><TD
 412 WIDTH="33%"
 413 ALIGN="right"
 414 VALIGN="top"
 415 >Build Tree</TD
 416 ></TR
 417 ></TABLE
 418 ></DIV
 419 ></BODY
 420 ></HTML
 421 >