NAME
ecosconfig — eCos configuration program
SYNOPSIS
ecosconfig [--help ] [--config=file] [--prefix=dir] [--srcdir=dir]
[--no-resolve] [--ignore-errors | -i ] [--verbose | -v ] [-q]
command
DESCRIPTION
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.
OPTIONS
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.
--config=file
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.
--prefix=dir
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.
--srcdir=dir
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.
--no-resolve
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.
COMMANDS
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
hardware.
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
configuration:
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
another.
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.
SEE ALSO
The programs are documented fully by eCos Users Guide
available.
AUTHOR
This manual page was written by Masato Taruishi <taru@debian.org> 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.
ECOS(1)