doc/html/user-guide/fine-grained-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 >Fine-grained 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="Manual Configuration"
  23 HREF="manual-configuration.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Coarse-grained Configuration"
  26 HREF="coarse-grained-configuration.html"><LINK
  27 REL="NEXT"
  28 TITLE="Editing an eCos Savefile"
  29 HREF="editing-an-ecos-savefile.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  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="coarse-grained-configuration.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 28. Manual Configuration</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="editing-an-ecos-savefile.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="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="FINE-GRAINED-CONFIGURATION">Fine-grained Configuration</H1
  86 ><P
  87 ><B
  88 CLASS="COMMAND"
  89 >ecosconfig</B
  90 > only provides
  91           coarse-grained control over the configuration: the hardware,
  92           the template and the packages that should be built. Unlike
  93           the Configuration Tool,
  94           <B
  95 CLASS="COMMAND"
  96 >ecosconfig</B
  97 > does not provide
  98           any facilities for manipulating finer-grained configuration options such as how many
  99           priority levels the scheduler should support. There are
 100           hundreds of these options, and manipulating them by means of
 101           command line arguments would not be sensible. </P
 102 ><P
 103 >In the current system fine-grained configuration options may
 104 be manipulated by manual editing of the configuration file. When
 105 a file has been edited in this way, the <B
 106 CLASS="COMMAND"
 107 >ecosconfig</B
 108 > tool
 109 should be used to check the configuration for any conflicts which
 110 may have been introduced:</P
 111 ><TABLE
 112 BORDER="5"
 113 BGCOLOR="#E0E0F0"
 114 WIDTH="70%"
 115 ><TR
 116 ><TD
 117 ><PRE
 118 CLASS="SCREEN"
 119 >$ ecosconfig check</PRE
 120 ></TD
 121 ></TR
 122 ></TABLE
 123 ><P
 124 >The <B
 125 CLASS="COMMAND"
 126 >check</B
 127 > command will list
 128 all conflicts and will also rewrite the configuration file, propagating
 129 any changes which affect other options. The user may choose to resolve
 130 the conflicts either by re-editing the configuration file manually
 131 or by invoking the inference engine using the <B
 132 CLASS="COMMAND"
 133 >resolve</B
 134 > command:</P
 135 ><TABLE
 136 BORDER="5"
 137 BGCOLOR="#E0E0F0"
 138 WIDTH="70%"
 139 ><TR
 140 ><TD
 141 ><PRE
 142 CLASS="SCREEN"
 143 >$ ecosconfig resolve</PRE
 144 ></TD
 145 ></TR
 146 ></TABLE
 147 ><P
 148 >The  <B
 149 CLASS="COMMAND"
 150 >resolve</B
 151 > command will
 152 list all conflicts which can be resolved and save the resulting changes
 153 to the configuration.</P
 154 ><P
 155 >It is necessary to regenerate the build tree and header files
 156 following any changes to the configuration before rebuilding <SPAN
 157 CLASS="PRODUCTNAME"
 158 >eCos</SPAN
 159 >:</P
 160 ><TABLE
 161 BORDER="5"
 162 BGCOLOR="#E0E0F0"
 163 WIDTH="70%"
 164 ><TR
 165 ><TD
 166 ><PRE
 167 CLASS="SCREEN"
 168 >$ ecosconfig tree</PRE
 169 ></TD
 170 ></TR
 171 ></TABLE
 172 ><P
 173 >All the configuration options and their descriptions are listed
 174 in the <I
 175 CLASS="CITETITLE"
 176 ><SPAN
 177 CLASS="PRODUCTNAME"
 178 >eCos</SPAN
 179 > Reference Manual</I
 180 >. </P
 181 ></DIV
 182 ><DIV
 183 CLASS="NAVFOOTER"
 184 ><HR
 185 ALIGN="LEFT"
 186 WIDTH="100%"><TABLE
 187 SUMMARY="Footer navigation table"
 188 WIDTH="100%"
 189 BORDER="0"
 190 CELLPADDING="0"
 191 CELLSPACING="0"
 192 ><TR
 193 ><TD
 194 WIDTH="33%"
 195 ALIGN="left"
 196 VALIGN="top"
 197 ><A
 198 HREF="coarse-grained-configuration.html"
 199 ACCESSKEY="P"
 200 >Prev</A
 201 ></TD
 202 ><TD
 203 WIDTH="34%"
 204 ALIGN="center"
 205 VALIGN="top"
 206 ><A
 207 HREF="ecos-user-guide.html"
 208 ACCESSKEY="H"
 209 >Home</A
 210 ></TD
 211 ><TD
 212 WIDTH="33%"
 213 ALIGN="right"
 214 VALIGN="top"
 215 ><A
 216 HREF="editing-an-ecos-savefile.html"
 217 ACCESSKEY="N"
 218 >Next</A
 219 ></TD
 220 ></TR
 221 ><TR
 222 ><TD
 223 WIDTH="33%"
 224 ALIGN="left"
 225 VALIGN="top"
 226 >Coarse-grained Configuration</TD
 227 ><TD
 228 WIDTH="34%"
 229 ALIGN="center"
 230 VALIGN="top"
 231 ><A
 232 HREF="manual-configuration.html"
 233 ACCESSKEY="U"
 234 >Up</A
 235 ></TD
 236 ><TD
 237 WIDTH="33%"
 238 ALIGN="right"
 239 VALIGN="top"
 240 >Editing an <SPAN
 241 CLASS="PRODUCTNAME"
 242 >eCos</SPAN
 243 > Savefile</TD
 244 ></TR
 245 ></TABLE
 246 ></DIV
 247 ></BODY
 248 ></HTML
 249 >