configurator(1CC)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO

NAME

configurator- ChorusOS configuration utility

SYNOPSIS

configurator -c config-file [-debug] command...

DESCRIPTION

configurator is a host utility.

The configurator tool allows static configuration of the ChorusOS microkernel.

It allows three levels of configuration:

• Features

• Static tunables

• Environment variables

The configurator utility reads the XML configuration files in the conf directory and saves the user settings in the originating configuration files.

Setting an environment variable creates an environment file which is included in the ChorusOS boot system image.

After a configuration change, the system must be rebuilt with the make build command.

OPTIONS

The following options are supported:

-c config-file

For ChorusOS, config-file is conf/ChorusOS.xml

-debug

Instructs the configurator to apply command to all entities. This option gives a more complete status of the information. All XML declarations are displayed, irrespective of their attributes being visible or configurable.

OPERANDS

The following commands are supported:

-help

Displays the command line options.

-p profile

Get the list of commands from the profile file. Each line in the profile file contains a command, for example:

-set EVENT=true

.

Lines starting with # are comments.

-check

Checks both the XML syntax of the configuration files and the coherency of the configuration information. An error message is issued if an error is found in an XML file during parsing.

-display output-file

Writes a description of the currently selected configuration in HTML, storing the output in output-file. Use the -debug option if you need more information about the available configuration options. If you specify both -debug and -display, the HTML displayed describes the configuration options available, and not the current configuration settings.

-list {definitions | features | tunables | envs} [pattern]

Lists configurable definitions, features, tunables or environment variables that match the pattern. If you do not specify a pattern, all the definitions, features, tunables, or environment variables are listed.

-info {definition | feature | tunable} [pattern

Displays the possible values for the parameter and a description text for the definitions, features, or tunables that match the specified pattern. If the pattern is not specified, all elements are displayed.

{-set name=value... | -reset name... }

Sets the named feature or tunable to value. Depending on the type of the name declaration, value may be a boolean (true, false), an integer or hexadecimal value, or a string.

Resets the value of name to its default value.

{-setenv name=value... | -resetenv name... }

Adds the variable name with value value to the ChorusOS environment.

Removes the variable name from the ChorusOS environment.

-action name

Executes the action described by name. For internal use only.

EXAMPLES

To add the EVENT feature to your default configuration, move to the root of the configuration directory and type:

configurator -set ENV=true

FILES

The following files are used by this utility:

conf/ChorusOS.xml

Is the top level configuration file. It contains references to all other configuration files:

conf/typedef.xml




conf/mkconfig/mkconfig.xml




conf/mkconfig/os.xml




conf/mkimage/mkimage.xml

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

ews(1CC), env(1M), sysGetEnv(2K), sysSetEnv(2K), sysUnsetEnv(2K)

The Graphical Configuration Tool, In: ChorusOS 4.0 Introduction

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO