QNX Developer Support
|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Query and display QNX installations and configurations
qconfig [-a] [-b] [-d path] [-e | -i | -l] [-h] [-n installation_name] [-p] [-r program]
QNX Neutrino, Linux, and Solaris
- Display all installed products and updates in a machine-readable
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.
- 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.
- Set up the runtime environment (see the examples).
If you specify this option, qconfig produces the commands
to set these environment variables:
You'll find this option useful when setting up the environment for building software.
- 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.
- 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.
- 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.
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.
List all the QNX installations:
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
- The name of the directory that stores the configuration files.