The following sections explain how to use the command-line configuration tool, configurator, for some common tasks.
The configurator utility provides an option to display the ChorusOS operating system configuration in HTML format. Within your build directory, type the following command:
$ configurator -display /tmp/ChorusOS.html |
You can then use your browser to navigate through the ChorusOS.html file generated by this command.
Two predefined profiles are provided, as described in "Feature Options". To select the basic profile, type:
% configurator -p conf/basic |
To re-select the extended (default) profile, type:
% configurator -p conf/extended |
You can use the configurator utility to add, remove, or list a feature.
To add a feature, type:
% configurator -set feature_name=true |
The status of the feature_name is set to true.
For example, to add the EVENT
feature to the
default configuration:
% configurator -set EVENT=true |
The configurator utility does not handle feature dependencies automatically. If you define a set that is not complete, an error message is displayed.
To remove a feature, type:
% configurator -set feature_name=false |
The status of the feature_name feature is set to false.
For example, to remove the EVENT
feature:
% configurator -set EVENT=false |
You can reset the value of a feature to the default as follows:
% configurator -reset EVENT |
The reset command resets the value to the extended profile default.
You can check the value of a feature as follows:
% configurator -list feature feature_name |
The output lists the feature and its status. If you omit feature_name, all features are displayed:
% configurator -list feature SEM bool 'true' EVENT bool 'true' RTMUTEX bool 'false' TIMER bool 'true' VTIMER bool 'false' DATE bool 'true' |
You can list a feature in greater detail with the -info option:
% configurator -info feature feature_name |
The output lists the feature, its status, possible values and its description. For example:
% configurator -info feature NFS_SERVER NFS_SERVER:bool='false' Possible values: true|false Description: NFS server access from target machine |
Tunable parameters are defined by symbolic names within the ChorusOS operating system components. Symbolic names include dots (.), to maintain compatibility with previous releases of the ChorusOS operating system.
The definition of a tunable parameter includes the definition of a default value for this parameter. Integer values of tunable parameters are expressed either as integers or as hexadecimal numbers.
To change the value of a tunable parameter, use:
% configurator -set tunable_name=value |
For example, to re-configure the kernel to allow the creation of 300 threads:
% configurator -set kern.exec.maxThreadNumber=300 |
You can check the value of a tunable parameter as follows:
% configurator -list tunable tunable_name |
You can list the values of all the kernel executive tunables as follows:
% configurator -list tunable kern.exec.* |
The output lists the kernel executive tunables and their values:
kern.exec.maxCpuNumber int '1' kern.exec.maxActorNumber int '64' kern.exec.maxThreadNumber int '300' kern.exec.bgStackSize int '0x1000' kern.exec.dflSysStackSize int '0x3000' kern.exec.dflUsrStackSize int '0x4000' kern.exec.dblFltStackSize int '0x800' kern.exec.intrStackSize int '0x3000' |
You can list a tunable parameter in greater detail with the -info option:
% configurator -info tunable tunable_name |
The tunable, its value and its description are displayed:
% configurator -info tunable kern.lap.* kern.lap.maxLapBindNumber:int='256' Description: Maximum number of bind LAPs kern.lap.maxLapSafeNumber:int='128' Description: Maximum number of safe LAPs |
The system environment is defined by the set of dynamic parameters. The system environment is a set of name-value pairs, where name and value are character strings. Values for system environment variables can be obtained by the system and applications at runtime using the sysGetEnv(2K) system call.
To display all the system environment variables, type:
% configurator -list env |
To set a new environment variable, or change its value:
% configurator -setenv envar=value |
Here is an example:
% configurator -setenv MESSAGE='HelloWorld' |
To unset a variable, so that it is removed from the environment, type:
% configurator -resetenv envar |
After you have finished modifying the configuration, rebuild the system image by typing:
% make build |