Query and display QNX installations and configurations
Syntax:
qconfig [-abc] [-d path] [-e | -i | -l] [-h]
[-n installation_name] [-p] [-r program]
Runs on:
QNX Neutrino, Linux, Microsoft Windows
Options:
- -a
- Display all installed products and updates in a machine-readable
format.
Note:
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.
Note:
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.
- -c
- Print the runtime environment strings in csh style.
Note:
The -c option was added in QNX Momentics 6.3.0 SP3 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.
Note:
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.
Note:
To change the version of QNX Neutrino that you're developing for
on a Windows machine, use
QWinCfg
instead of
qconfig.
QWinCfg changes the registry on your machine;
qconfig changes only the settings in your current shell.
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.
Note:
This utility doesn't list the installed packages in any particular order.
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`
Note:
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.