This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

`qconfig`

Query and display QNX installations and configurations

Syntax:

qconfig [-a] [-b] [-d path] [-e | -i | -l] [-h]
        [-n installation_name] [-p] [-r program]

Options:

-a

Display all installed products and updates in a machine-readable format.

The -a option was added in QNX Neutrino Core OS 6.3.2 and an update to QNX Momentics 6.3.0 SP1 and QNX Momentics 6.3.0 SP2.

-b

Display the installed product baseline.

The -b option was added in QNX Neutrino Core OS 6.3.2 and an update to QNX Momentics 6.3.0 SP1 and QNX Momentics 6.3.0 SP2.

-d path

The name of the directory where all of the individual configuration files are located. There's one configuration file per installation.

-e

Set up the runtime environment (see the examples). If you specify this option, qconfig produces the commands to set these environment variables:

QNX_HOST
QNX_TARGET
PATH
LD_LIBRARY_PATH
MAKEFLAGS

You'll find this option useful when setting up the environment for building software.

-i

List all installations in an easy-to-parse form. The form is:

count: number_of_installations
name: ...
version: ...
host: ...
target: ...

There's a set of lines for each version of software that you've installed.

-l

List all installations in human-readable format (the default).

-n installation_name

Select a specific installation by name. The name may be incorporated as part of the configuration file using the <name> tag or, if not present, it defaults to the filename.

-p

Display the installed product updates.

The -p option was added in QNX Neutrino Core OS 6.3.2 and an update to QNX Momentics 6.3.0 SP1 and QNX Momentics 6.3.0 SP2.

-r program

Run the given program in the environment.

Description:

The qconfig utility sets or queries the QNX configuration files. It supports the coexistence of multiple versions of Neutrino on one machine.

On Windows, use QWinCfg instead of qconfig.

Whenever you install a version of Neutrino, a configuration file is stored in a directory that depends on the host OS. Each configuration file defines the name of the installation and its base, host, and target directories.

The QNX_CONFIGURATION environment variable usually identifies the directory where the configuration files are stored, but you can override it by specifying the -d option. If neither of these produces a valid location, qconfig looks in /etc/qnx/qconfig before giving up and returning an error.

If you don't specify an installation with the -n option, qconfig uses the most current installation.

You can use qconfig to query your current configuration in a human-readable format, or you can use the -e option to set up your environment to use a certain installation.

Examples:

List all the QNX installations:

qconfig

Set up your shell environment for a specific installation:

eval `qconfig -n "QNX Momentics 6.3.0" -e`

The syntax for evaluating the output of the -e option depends on the host OS and the shell that you're using. The command shown above works with ksh and bash.

Run a specific instance of qde (the IDE):

qconfig -n "QNX Momentics 6.3.0" -r qde

Environment variables:

QNX_CONFIGURATION: The name of the directory that stores the configuration files.