Provided by: ecosconfig-imx_200910-0ubuntu6_amd64 
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 User's 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)