qconfig

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.