Query and display QNX installations and configurations
Syntax:
qconfig [-abc] [-d path] [-e | -i | -l] [-h]
[-n installation_name] [-p] [-r program]
Runs on:
Linux, Mac, Microsoft Windows
Options:
- -a
- Display all installed products and updates in a machine-readable format.
(Added in the 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.
(Added in the 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.
(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.
(Added in the 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 QNX Neutrino on one machine.
Whenever you install a version of QNX 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.
- The way that you choose which version of the OS depends on how you installed QNX SDP.
For more information, see
Choosing the version of the OS
in the Compiling and Debugging chapter of the
QNX Neutrino Programmer's Guide.
Examples:
List all the QNX installations:
qconfig
Set up your shell environment for a specific installation:
eval `qconfig -n "QNX Software Development Platform 7.0.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.
Environment variables:
- QNX_CONFIGURATION
- The name of the directory that stores the configuration files.