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:

QNX Neutrino, Linux, Microsoft Windows

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.

---

-c

Print the runtime environment strings in csh style.

---

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.

---

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.

---

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.

---

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`

---

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.

See also:

qbinaudit, QWinCfg, showlicense, sysinfo

Controlling How Neutrino Starts and Configuring Your Environment in the Neutrino User's Guide