Man Linux: Main Page and Category List


       ecosconfig — eCos configuration program


       ecosconfig  [--help  ]  [--config=file]  [--prefix=dir]  [--srcdir=dir]
       [--no-resolve]  [--ignore-errors  | -i ]   [--verbose   |  -v  ]   [-q]


       This manual page documents briefly the ecosconfig command.

       This  manual  page  was written for the Debian distribution because the
       original program  does  not  have  a  manual  page.   Instead,  it  has
       documentation in the PDF format; see below.

       ecosconfig  is a program to configure your eCos kernel linked with your
       embedded application and creating the build tree.


       This program follows the usual  GNU  command  line  syntax,  with  long
       options  starting  with  two  dashes  (‘-’).   A  summary of options is
       included below.  For a complete description, see the PDF files.

       -h           --help
                 Provides basic usage guidelines for  the  available  commands
                 and qualifiers. All other qualifiers and commands are ignored
                 if --help is used.

                 Specifies an eCos configuration save  file  for  use  by  the
                 tool.  By default, the file ecos.ecc in the current directory
                 is used. Developers may prefer to use a common  location  for
                 all   their   eCos   configurations   rather  than  keep  the
                 configuration information in the base of the build tree.

                 Specifies an alternative location for the install  tree.   By
                 default,   the   install  tree  resides  inside  the  install
                 directory in the build tree.  Developers may prefer to locate
                 the  build  tree  in  a temporary file hierarchy but keep the
                 install tree in a more permanent location.

                 Specifies the  location  of  the  component  repository.   By
                 default,   the  tool  uses  the  location  specified  in  the
                 ECOS_REPOSITORY environment variable. Developers  may  prefer
                 to  use  of this qualifier if they are working with more than
                 one repository.

                 Disables  the  implicit   resolution   of   conflicts   while
                 manipulating the configuration data. developers may prefer to
                 reslove conflicts by editing the eCos configuration save file
                 manually The check command implicitely uses --no-resolve.

       --ignore-errors -i
                 By  default,  ecosconfig  will exit with an error code if the
                 current configuration contains any conflicts, and it  is  not
                 possible  to  generate  or  update  a  build  tree  for  such
                 configurations. This qualifier causes  ecosconfig  to  ignore
                 such  problems,  and hence it is possible to generate a build
                 tree even if there are still conflicts. Of course, there  are
                 no  guarantees  that  the  resulting  system will actually do
                 anything useful.

       -v           --verbose
                 Display more information.

       -q        Display less information.


       The available commands for ecosconfig are as follows:

       list      Lists  the  available  packages,  targets  and  templates  as
                 installed   in  the  eCos  repository.  Aliases  and  package
                 versions are also reported.

       new target [template [version]]
                 Creates a new eCos configuration  for  the  specified  target
                 hardware  and  saves  it.  A  software  template  may also be
                 specified. By default, the template named ‘default’ is  used.
                 If  the template version is not specified, the latest version
                 is used.

       target target
                 Changes  the  target  hardware   selection   for   the   eCos
                 configuration.  This  has  the  effect  of unloading packages
                 supporting the target selected  previously  and  loading  the
                 packages which support the new hardware. This command will be
                 used typically when switching between a  simulator  and  real

       template template [version]
                 Changes  the  template  selection for the eCos configuration.
                 This has the effect of unloading packages  specified  by  the
                 template   selected   previously  and  loading  the  packages
                 specified by the new template. By default, the latest version
                 of the specified template is used.

       remove packages
                 Removes  the  specified packages from the eCos configuration.
                 This command will be used  typically  when  the  template  on
                 which  a  configuration  is based contains packages which are
                 not required.

       add packages
                 Adds the specified packages to the eCos  configuration.  This
                 command  will  be used typically when the template on which a
                 configuration is based does  not  contain  all  the  packages
                 which  are 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 explicitely.

       version version packages
                 Selects  the specified version of a number of packages in the
                 eCos configuration.  By default, the most recent  version  of
                 each  package  is  used.  This command will be used typically
                 when an older version of a package is required.

       check     Presents the following  information  concerning  the  current

                    0. the selected target hardware

                    1. the selected template

                    2. additional packages

                    3. removed packages

                    4. the  selected version of packages where this is not the
                       most recent version

                    5. conflicts in the current configuration

                 The check  command  will  never  perform  automatic  conflict
                 resolution, so there is no need to use --no-resolve.

       resolve   Resolves   conflicts   identified   in   the   current   eCos
                 configuration by invoking an inference  capability.  Resolved
                 conflicts   are  reported,  but  not  all  conflicts  may  be
                 resolvable. This command will  be  used  typically  following
                 manual editing of the configuration.

       export file
                 Exports  a  minimal  eCos  configurastion  save file with the
                 specified name. This file contains only those  options  which
                 do  not  have  their  default  value.  Such  files  are  used
                 typically to transfer option values from one configuration to

       import file
                 Imports  a  minimal  eCos  configuration  save  file with the
                 specified name. The values of those options specified in  the
                 file are applied to the current configuration.


       The programs are documented fully by eCos Users Guide


       This  manual  page was written by Masato Taruishi <> for
       the Debian system (but may be used by others). This  is  mostly  copied
       from the eCos’s user guide available in html or PDF format.