<!-- Copyright (C) 2003 Red Hat, Inc. -->
|
<!-- Copyright (C) 2003 Red Hat, Inc. -->
|
<!-- This material may be distributed only subject to the terms -->
|
<!-- This material may be distributed only subject to the terms -->
|
<!-- and conditions set forth in the Open Publication License, v1.0 -->
|
<!-- and conditions set forth in the Open Publication License, v1.0 -->
|
<!-- or later (the latest version is presently available at -->
|
<!-- or later (the latest version is presently available at -->
|
<!-- http://www.opencontent.org/openpub/). -->
|
<!-- http://www.opencontent.org/openpub/). -->
|
<!-- Distribution of the work or derivative of the work in any -->
|
<!-- Distribution of the work or derivative of the work in any -->
|
<!-- standard (paper) book form is prohibited unless prior -->
|
<!-- standard (paper) book form is prohibited unless prior -->
|
<!-- permission is obtained from the copyright holder. -->
|
<!-- permission is obtained from the copyright holder. -->
|
<HTML
|
<HTML
|
><HEAD
|
><HEAD
|
><TITLE
|
><TITLE
|
>Creating the Build Tree</TITLE
|
>Creating the Build Tree</TITLE
|
><meta name="MSSmartTagsPreventParsing" content="TRUE">
|
><meta name="MSSmartTagsPreventParsing" content="TRUE">
|
<META
|
<META
|
NAME="GENERATOR"
|
NAME="GENERATOR"
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
|
"><LINK
|
"><LINK
|
REL="HOME"
|
REL="HOME"
|
TITLE="eCos User Guide"
|
TITLE="eCos User Guide"
|
HREF="ecos-user-guide.html"><LINK
|
HREF="ecos-user-guide.html"><LINK
|
REL="UP"
|
REL="UP"
|
TITLE="Manual Configuration"
|
TITLE="Manual Configuration"
|
HREF="manual-configuration.html"><LINK
|
HREF="manual-configuration.html"><LINK
|
REL="PREVIOUS"
|
REL="PREVIOUS"
|
TITLE="Manual Configuration"
|
TITLE="Manual Configuration"
|
HREF="manual-configuration.html"><LINK
|
HREF="manual-configuration.html"><LINK
|
REL="NEXT"
|
REL="NEXT"
|
TITLE="Conflicts and constraints"
|
TITLE="Conflicts and constraints"
|
HREF="conflicts-and-constraints.html"></HEAD
|
HREF="conflicts-and-constraints.html"></HEAD
|
><BODY
|
><BODY
|
CLASS="SECT1"
|
CLASS="SECT1"
|
BGCOLOR="#FFFFFF"
|
BGCOLOR="#FFFFFF"
|
TEXT="#000000"
|
TEXT="#000000"
|
LINK="#0000FF"
|
LINK="#0000FF"
|
VLINK="#840084"
|
VLINK="#840084"
|
ALINK="#0000FF"
|
ALINK="#0000FF"
|
><DIV
|
><DIV
|
CLASS="NAVHEADER"
|
CLASS="NAVHEADER"
|
><TABLE
|
><TABLE
|
SUMMARY="Header navigation table"
|
SUMMARY="Header navigation table"
|
WIDTH="100%"
|
WIDTH="100%"
|
BORDER="0"
|
BORDER="0"
|
CELLPADDING="0"
|
CELLPADDING="0"
|
CELLSPACING="0"
|
CELLSPACING="0"
|
><TR
|
><TR
|
><TH
|
><TH
|
COLSPAN="3"
|
COLSPAN="3"
|
ALIGN="center"
|
ALIGN="center"
|
>eCos User Guide</TH
|
>eCos User Guide</TH
|
></TR
|
></TR
|
><TR
|
><TR
|
><TD
|
><TD
|
WIDTH="10%"
|
WIDTH="10%"
|
ALIGN="left"
|
ALIGN="left"
|
VALIGN="bottom"
|
VALIGN="bottom"
|
><A
|
><A
|
HREF="manual-configuration.html"
|
HREF="manual-configuration.html"
|
ACCESSKEY="P"
|
ACCESSKEY="P"
|
>Prev</A
|
>Prev</A
|
></TD
|
></TD
|
><TD
|
><TD
|
WIDTH="80%"
|
WIDTH="80%"
|
ALIGN="center"
|
ALIGN="center"
|
VALIGN="bottom"
|
VALIGN="bottom"
|
>Chapter 28. Manual Configuration</TD
|
>Chapter 28. Manual Configuration</TD
|
><TD
|
><TD
|
WIDTH="10%"
|
WIDTH="10%"
|
ALIGN="right"
|
ALIGN="right"
|
VALIGN="bottom"
|
VALIGN="bottom"
|
><A
|
><A
|
HREF="conflicts-and-constraints.html"
|
HREF="conflicts-and-constraints.html"
|
ACCESSKEY="N"
|
ACCESSKEY="N"
|
>Next</A
|
>Next</A
|
></TD
|
></TD
|
></TR
|
></TR
|
></TABLE
|
></TABLE
|
><HR
|
><HR
|
ALIGN="LEFT"
|
ALIGN="LEFT"
|
WIDTH="100%"></DIV
|
WIDTH="100%"></DIV
|
><DIV
|
><DIV
|
CLASS="SECT1"
|
CLASS="SECT1"
|
><H1
|
><H1
|
CLASS="SECT1"
|
CLASS="SECT1"
|
><A
|
><A
|
NAME="CREATING-BUILD-TREE">Creating the Build Tree</H1
|
NAME="CREATING-BUILD-TREE">Creating the Build Tree</H1
|
><P
|
><P
|
>Generating a build tree is a non-trivial operation and
|
>Generating a build tree is a non-trivial operation and
|
should not be attempted manually. Instead, <SPAN
|
should not be attempted manually. Instead, <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> is shipped
|
> is shipped
|
with a tool called <B
|
with a tool called <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> that should
|
> that should
|
be used to create a build tree.</P
|
be used to create a build tree.</P
|
><P
|
><P
|
>Usually <B
|
>Usually <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> will be
|
> will be
|
run inside the build tree itself. If you are creating a new build
|
run inside the build tree itself. If you are creating a new build
|
tree then typically you will create a new empty directory using
|
tree then typically you will create a new empty directory using
|
the <B
|
the <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>mkdir</B
|
>mkdir</B
|
> command, <B
|
> command, <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>cd</B
|
>cd</B
|
> into
|
> into
|
that directory, and then invoke <B
|
that directory, and then invoke <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> to
|
> to
|
create a configuration. By default, the configuration is stored
|
create a configuration. By default, the configuration is stored
|
in a file <TT
|
in a file <TT
|
CLASS="FILENAME"
|
CLASS="FILENAME"
|
>ecos.ecc</TT
|
>ecos.ecc</TT
|
> in the current
|
> in the current
|
directory. The configuration may be modified by editing this file directly. <B
|
directory. The configuration may be modified by editing this file directly. <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> itself
|
> itself
|
deals with a number of coarse-grained configuration options such
|
deals with a number of coarse-grained configuration options such
|
as the target platform and the packages that should be used.</P
|
as the target platform and the packages that should be used.</P
|
><P
|
><P
|
>The <B
|
>The <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> tool is also
|
> tool is also
|
used subsequently to generate a build tree for a configuration.
|
used subsequently to generate a build tree for a configuration.
|
Once a build tree exists, it is possible to run <B
|
Once a build tree exists, it is possible to run <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> again
|
> again
|
inside the same build tree. This will be necessary if your wish
|
inside the same build tree. This will be necessary if your wish
|
to change some of the configuration options.</P
|
to change some of the configuration options.</P
|
><P
|
><P
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> does not generate
|
> does not generate
|
the top-level directory of the build tree; you must do this
|
the top-level directory of the build tree; you must do this
|
yourself. </P
|
yourself. </P
|
><TABLE
|
><TABLE
|
BORDER="5"
|
BORDER="5"
|
BGCOLOR="#E0E0F0"
|
BGCOLOR="#E0E0F0"
|
WIDTH="70%"
|
WIDTH="70%"
|
><TR
|
><TR
|
><TD
|
><TD
|
><PRE
|
><PRE
|
CLASS="SCREEN"
|
CLASS="SCREEN"
|
>$ mkdir ecos-work
|
>$ mkdir ecos-work
|
$ cd ecos-work</PRE
|
$ cd ecos-work</PRE
|
></TD
|
></TD
|
></TR
|
></TR
|
></TABLE
|
></TABLE
|
><P
|
><P
|
>The next step is to run <B
|
>The next step is to run <B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
>: </P
|
>: </P
|
><TABLE
|
><TABLE
|
BORDER="5"
|
BORDER="5"
|
BGCOLOR="#E0E0F0"
|
BGCOLOR="#E0E0F0"
|
WIDTH="70%"
|
WIDTH="70%"
|
><TR
|
><TR
|
><TD
|
><TD
|
><PRE
|
><PRE
|
CLASS="SCREEN"
|
CLASS="SCREEN"
|
>$ ecosconfig <qualifiers> <command></PRE
|
>$ ecosconfig <qualifiers> <command></PRE
|
></TD
|
></TD
|
></TR
|
></TR
|
></TABLE
|
></TABLE
|
><DIV
|
><DIV
|
CLASS="SECT2"
|
CLASS="SECT2"
|
><H2
|
><H2
|
CLASS="SECT2"
|
CLASS="SECT2"
|
><A
|
><A
|
NAME="AEN2416">ecosconfig qualifiers</H2
|
NAME="AEN2416">ecosconfig qualifiers</H2
|
><P
|
><P
|
>The available command line qualifiers for
|
>The available command line qualifiers for
|
<B
|
<B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> are as follows. Multiple
|
> are as follows. Multiple
|
qualifiers may be used on the command line:
|
qualifiers may be used on the command line:
|
</P
|
</P
|
><P
|
><P
|
></P
|
></P
|
><DIV
|
><DIV
|
CLASS="VARIABLELIST"
|
CLASS="VARIABLELIST"
|
><DL
|
><DL
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--help</TT
|
>--help</TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Provides basic usage guidelines for the
|
>Provides basic usage guidelines for the
|
available commands and qualifiers.</P
|
available commands and qualifiers.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--config=<file></TT
|
>--config=<file></TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Specifies an <SPAN
|
>Specifies an <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration save file for
|
> configuration save file for
|
use by the tool. By default, the file
|
use by the tool. By default, the file
|
<TT
|
<TT
|
CLASS="FILENAME"
|
CLASS="FILENAME"
|
>ecos.ecc</TT
|
>ecos.ecc</TT
|
> in the
|
> in the
|
current directory is used. Developers may prefer to
|
current directory is used. Developers may prefer to
|
use a common location for all their <SPAN
|
use a common location for all their <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
>
|
>
|
configurations rather than keep the configuration
|
configurations rather than keep the configuration
|
information in the base of the build tree.</P
|
information in the base of the build tree.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--prefix=<dir></TT
|
>--prefix=<dir></TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Specifies an alternative location for the
|
>Specifies an alternative location for the
|
install tree. By default, the install tree resides
|
install tree. By default, the install tree resides
|
inside the <TT
|
inside the <TT
|
CLASS="FILENAME"
|
CLASS="FILENAME"
|
>install</TT
|
>install</TT
|
>
|
>
|
directory in the build tree. Developers may prefer
|
directory in the build tree. Developers may prefer
|
to locate the build tree in a temporary file
|
to locate the build tree in a temporary file
|
hierarchy but keep the install tree in a more
|
hierarchy but keep the install tree in a more
|
permanent location.</P
|
permanent location.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--srcdir=<dir></TT
|
>--srcdir=<dir></TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Specifies the location of the component
|
>Specifies the location of the component
|
repository. By default, the tool uses the location
|
repository. By default, the tool uses the location
|
specified in the
|
specified in the
|
<TT
|
<TT
|
CLASS="REPLACEABLE"
|
CLASS="REPLACEABLE"
|
><I
|
><I
|
>ECOS_REPOSITORY</I
|
>ECOS_REPOSITORY</I
|
></TT
|
></TT
|
>
|
>
|
environment variable. Developers may prefer to use
|
environment variable. Developers may prefer to use
|
of this qualifier if they are working with more than
|
of this qualifier if they are working with more than
|
one repository.</P
|
one repository.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--no-resolve</TT
|
>--no-resolve</TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Disables the implicit resolution of conflicts
|
>Disables the implicit resolution of conflicts
|
while manipulating the configuration data.
|
while manipulating the configuration data.
|
developers may prefer to resolve conflicts by
|
developers may prefer to resolve conflicts by
|
editing the <SPAN
|
editing the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration save file
|
> configuration save file
|
manually.</P
|
manually.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--ignore-errors</TT
|
>--ignore-errors</TT
|
>, <TT
|
>, <TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>-i</TT
|
>-i</TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>By default, ecosconfig will exit with an error code if the current
|
>By default, ecosconfig will exit with an error code if the current
|
configuration contains any conflicts, and it is not possible to
|
configuration contains any conflicts, and it is not possible to
|
generate or update a build tree for such configurations. This
|
generate or update a build tree for such configurations. This
|
qualifier causes ecosconfig to ignore such problems, and hence it is
|
qualifier causes ecosconfig to ignore such problems, and hence it is
|
possible to generate a build tree even if there are still
|
possible to generate a build tree even if there are still
|
conflicts. Of course, there are no guarantees that the resulting
|
conflicts. Of course, there are no guarantees that the resulting
|
system will actually do anything.</P
|
system will actually do anything.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--verbose</TT
|
>--verbose</TT
|
>, <TT
|
>, <TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>-v</TT
|
>-v</TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Display more information.</P
|
>Display more information.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><TT
|
><TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--quiet</TT
|
>--quiet</TT
|
>, <TT
|
>, <TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>-q</TT
|
>-q</TT
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Display less information.</P
|
>Display less information.</P
|
></DD
|
></DD
|
></DL
|
></DL
|
></DIV
|
></DIV
|
><P
|
><P
|
>The <TT
|
>The <TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--config</TT
|
>--config</TT
|
>, <TT
|
>, <TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--prefix</TT
|
>--prefix</TT
|
> and
|
> and
|
<TT
|
<TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--srcdir</TT
|
>--srcdir</TT
|
> qualifiers can also be written with two arguments,
|
> qualifiers can also be written with two arguments,
|
for example:</P
|
for example:</P
|
><TABLE
|
><TABLE
|
BORDER="5"
|
BORDER="5"
|
BGCOLOR="#E0E0F0"
|
BGCOLOR="#E0E0F0"
|
WIDTH="70%"
|
WIDTH="70%"
|
><TR
|
><TR
|
><TD
|
><TD
|
><PRE
|
><PRE
|
CLASS="SCREEN"
|
CLASS="SCREEN"
|
>ecosconfig --srcdir <TT
|
>ecosconfig --srcdir <TT
|
CLASS="REPLACEABLE"
|
CLASS="REPLACEABLE"
|
><I
|
><I
|
><dir></I
|
><dir></I
|
></TT
|
></TT
|
> ...</PRE
|
> ...</PRE
|
></TD
|
></TD
|
></TR
|
></TR
|
></TABLE
|
></TABLE
|
><P
|
><P
|
>This simplifies filename completion with some shells.</P
|
>This simplifies filename completion with some shells.</P
|
></DIV
|
></DIV
|
><DIV
|
><DIV
|
CLASS="SECT2"
|
CLASS="SECT2"
|
><H2
|
><H2
|
CLASS="SECT2"
|
CLASS="SECT2"
|
><A
|
><A
|
NAME="AEN2480">ecosconfig commands</H2
|
NAME="AEN2480">ecosconfig commands</H2
|
><P
|
><P
|
>The available commands for
|
>The available commands for
|
<B
|
<B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>ecosconfig</B
|
>ecosconfig</B
|
> are as
|
> are as
|
follows:</P
|
follows:</P
|
><P
|
><P
|
></P
|
></P
|
><DIV
|
><DIV
|
CLASS="VARIABLELIST"
|
CLASS="VARIABLELIST"
|
><DL
|
><DL
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>list</B
|
>list</B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Lists the available packages, targets and
|
>Lists the available packages, targets and
|
templates as installed in the <SPAN
|
templates as installed in the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> repository.
|
> repository.
|
Aliases and package versions are also
|
Aliases and package versions are also
|
reported.</P
|
reported.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>new <target> [<template> [<version>]]</B
|
>new <target> [<template> [<version>]]</B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Creates a new <SPAN
|
>Creates a new <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration for
|
> configuration for
|
the specified target hardware and saves it. A
|
the specified target hardware and saves it. A
|
software template may also be specified. By default,
|
software template may also be specified. By default,
|
the template named ‘default’ is used. If
|
the template named ‘default’ is used. If
|
the template version is not specified, the latest
|
the template version is not specified, the latest
|
version is used.</P
|
version is used.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>target <target></B
|
>target <target></B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Changes the target hardware selection
|
>Changes the target hardware selection
|
for the <SPAN
|
for the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration. This has the effect of
|
> configuration. This has the effect of
|
unloading packages supporting the target selected
|
unloading packages supporting the target selected
|
previously and loading the packages which support
|
previously and loading the packages which support
|
the new hardware. This command will be used
|
the new hardware. This command will be used
|
typically when switching between a simulator and
|
typically when switching between a simulator and
|
real hardware.</P
|
real hardware.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>template <template> [<version>]</B
|
>template <template> [<version>]</B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Changes the template selection for the <SPAN
|
>Changes the template selection for the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
>
|
>
|
configuration. This has the effect of unloading
|
configuration. This has the effect of unloading
|
packages specified by the template selected
|
packages specified by the template selected
|
previously and loading the packages specified by the
|
previously and loading the packages specified by the
|
new template. By default, the latest version of the
|
new template. By default, the latest version of the
|
specified template is used.</P
|
specified template is used.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>remove <packages></B
|
>remove <packages></B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Removes the specified packages from the <SPAN
|
>Removes the specified packages from the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
>
|
>
|
configuration. This command will be used typically
|
configuration. This command will be used typically
|
when the template on which a configuration is based
|
when the template on which a configuration is based
|
contains packages which are not required.</P
|
contains packages which are not required.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>add <packages></B
|
>add <packages></B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Adds the specified packages to the <SPAN
|
>Adds the specified packages to the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration. This
|
> configuration. This
|
command will be used typically when the template on which a
|
command will be used typically when the template on which a
|
configuration is based does not contain all the packages which are
|
configuration is based does not contain all the packages which are
|
required.For example, add-on packages provided by third parties will
|
required.For example, add-on packages provided by third parties will
|
not be known to the standard templates, so they will have to be added
|
not be known to the standard templates, so they will have to be added
|
explicitly. </P
|
explicitly. </P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>version <version> <packages></B
|
>version <version> <packages></B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Selects the specified version of a
|
>Selects the specified version of a
|
number of packages in the <SPAN
|
number of packages in the <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration. By
|
> configuration. By
|
default, the most recent version of each package is
|
default, the most recent version of each package is
|
used. This command will be used typically when an
|
used. This command will be used typically when an
|
older version of a package is required.</P
|
older version of a package is required.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>check</B
|
>check</B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Presents the following information
|
>Presents the following information
|
concerning the current configuration:</P
|
concerning the current configuration:</P
|
><P
|
><P
|
></P
|
></P
|
><OL
|
><OL
|
TYPE="1"
|
TYPE="1"
|
><LI
|
><LI
|
><P
|
><P
|
>the selected target hardware</P
|
>the selected target hardware</P
|
></LI
|
></LI
|
><LI
|
><LI
|
><P
|
><P
|
>the selected template</P
|
>the selected template</P
|
></LI
|
></LI
|
><LI
|
><LI
|
><P
|
><P
|
>additional packages</P
|
>additional packages</P
|
></LI
|
></LI
|
><LI
|
><LI
|
><P
|
><P
|
>removed packages</P
|
>removed packages</P
|
></LI
|
></LI
|
><LI
|
><LI
|
><P
|
><P
|
>the selected version of packages
|
>the selected version of packages
|
where this is not the most recent
|
where this is not the most recent
|
version</P
|
version</P
|
></LI
|
></LI
|
><LI
|
><LI
|
><P
|
><P
|
>conflicts in the current configuration</P
|
>conflicts in the current configuration</P
|
></LI
|
></LI
|
></OL
|
></OL
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>resolve</B
|
>resolve</B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Resolves conflicts identified in the
|
>Resolves conflicts identified in the
|
current <SPAN
|
current <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration by invoking an inference
|
> configuration by invoking an inference
|
capability. Resolved conflicts are reported, but not
|
capability. Resolved conflicts are reported, but not
|
all conflicts may be resolvable. This command will
|
all conflicts may be resolvable. This command will
|
be used typically following manual editing of the
|
be used typically following manual editing of the
|
configuration.</P
|
configuration.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>export <file></B
|
>export <file></B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Exports a minimal <SPAN
|
>Exports a minimal <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration
|
> configuration
|
save file with the specified name. This file
|
save file with the specified name. This file
|
contains only those options which do not have their
|
contains only those options which do not have their
|
default value. Such files are used typically to
|
default value. Such files are used typically to
|
transfer option values from one configuration to
|
transfer option values from one configuration to
|
another.</P
|
another.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>import <file></B
|
>import <file></B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Imports a minimal <SPAN
|
>Imports a minimal <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
> configuration
|
> configuration
|
save file with the specified name. The values of
|
save file with the specified name. The values of
|
those options specified in the file are applied to
|
those options specified in the file are applied to
|
the current configuration.</P
|
the current configuration.</P
|
></DD
|
></DD
|
><DT
|
><DT
|
><B
|
><B
|
CLASS="COMMAND"
|
CLASS="COMMAND"
|
>tree</B
|
>tree</B
|
></DT
|
></DT
|
><DD
|
><DD
|
><P
|
><P
|
>Generates a build tree based on the current <SPAN
|
>Generates a build tree based on the current <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
>
|
>
|
configuration. This command will be used typically
|
configuration. This command will be used typically
|
just before building <SPAN
|
just before building <SPAN
|
CLASS="PRODUCTNAME"
|
CLASS="PRODUCTNAME"
|
>eCos</SPAN
|
>eCos</SPAN
|
>.Normally a build tree can
|
>.Normally a build tree can
|
only be generated if if the configuration has no unresolved
|
only be generated if if the configuration has no unresolved
|
conflicts, but <TT
|
conflicts, but <TT
|
CLASS="OPTION"
|
CLASS="OPTION"
|
>--ignore-errors</TT
|
>--ignore-errors</TT
|
> can be used to override
|
> can be used to override
|
this.</P
|
this.</P
|
></DD
|
></DD
|
></DL
|
></DL
|
></DIV
|
></DIV
|
></DIV
|
></DIV
|
></DIV
|
></DIV
|
><DIV
|
><DIV
|
CLASS="NAVFOOTER"
|
CLASS="NAVFOOTER"
|
><HR
|
><HR
|
ALIGN="LEFT"
|
ALIGN="LEFT"
|
WIDTH="100%"><TABLE
|
WIDTH="100%"><TABLE
|
SUMMARY="Footer navigation table"
|
SUMMARY="Footer navigation table"
|
WIDTH="100%"
|
WIDTH="100%"
|
BORDER="0"
|
BORDER="0"
|
CELLPADDING="0"
|
CELLPADDING="0"
|
CELLSPACING="0"
|
CELLSPACING="0"
|
><TR
|
><TR
|
><TD
|
><TD
|
WIDTH="33%"
|
WIDTH="33%"
|
ALIGN="left"
|
ALIGN="left"
|
VALIGN="top"
|
VALIGN="top"
|
><A
|
><A
|
HREF="manual-configuration.html"
|
HREF="manual-configuration.html"
|
ACCESSKEY="P"
|
ACCESSKEY="P"
|
>Prev</A
|
>Prev</A
|
></TD
|
></TD
|
><TD
|
><TD
|
WIDTH="34%"
|
WIDTH="34%"
|
ALIGN="center"
|
ALIGN="center"
|
VALIGN="top"
|
VALIGN="top"
|
><A
|
><A
|
HREF="ecos-user-guide.html"
|
HREF="ecos-user-guide.html"
|
ACCESSKEY="H"
|
ACCESSKEY="H"
|
>Home</A
|
>Home</A
|
></TD
|
></TD
|
><TD
|
><TD
|
WIDTH="33%"
|
WIDTH="33%"
|
ALIGN="right"
|
ALIGN="right"
|
VALIGN="top"
|
VALIGN="top"
|
><A
|
><A
|
HREF="conflicts-and-constraints.html"
|
HREF="conflicts-and-constraints.html"
|
ACCESSKEY="N"
|
ACCESSKEY="N"
|
>Next</A
|
>Next</A
|
></TD
|
></TD
|
></TR
|
></TR
|
><TR
|
><TR
|
><TD
|
><TD
|
WIDTH="33%"
|
WIDTH="33%"
|
ALIGN="left"
|
ALIGN="left"
|
VALIGN="top"
|
VALIGN="top"
|
>Manual Configuration</TD
|
>Manual Configuration</TD
|
><TD
|
><TD
|
WIDTH="34%"
|
WIDTH="34%"
|
ALIGN="center"
|
ALIGN="center"
|
VALIGN="top"
|
VALIGN="top"
|
><A
|
><A
|
HREF="manual-configuration.html"
|
HREF="manual-configuration.html"
|
ACCESSKEY="U"
|
ACCESSKEY="U"
|
>Up</A
|
>Up</A
|
></TD
|
></TD
|
><TD
|
><TD
|
WIDTH="33%"
|
WIDTH="33%"
|
ALIGN="right"
|
ALIGN="right"
|
VALIGN="top"
|
VALIGN="top"
|
>Conflicts and constraints</TD
|
>Conflicts and constraints</TD
|
></TR
|
></TR
|
></TABLE
|
></TABLE
|
></DIV
|
></DIV
|
></BODY
|
></BODY
|
></HTML
|
></HTML
|
|
|
