Developer Resources
Board support packages
Foundry27 projects
Forums
Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® Momentics® 6.3.0 Service Pack 1 or Service Pack 2 qconfig Patch (Patch ID 205) Release Notes

QNX® Momentics® 6.3.0 SP1 PE and SE

Date of this edition: July 27, 2006

Target OS: QNX® Neutrino® 6.3.0 SP1 or later

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4, or NT SP6a; Sun Solaris 7, 8, 9, or 10; QNX® Neutrino® 6.3.0 SP1 or later; Linux Red Hat 8, 9, or Enterprise WS 3 or 4

Contents

Throughout this document, you may see reference numbers associated with particular issues, changes, etc. When corresponding with our Technical Support staff about a given issue, please quote the relevant reference number. You might also find the reference numbers useful for tracking issues as they become fixed.

What's in this patch?

This patch includes an updated version of the qconfig utility that provides more information about the QNX software on your system. (Ref# 29317)

These files are installed in the host-specific directories under your base installation directory for QNX Momentics:

  • host/win32/x86/usr/bin/qconfig.exe
  • host/linux/x86/usr/bin/qconfig
  • host/solaris/sparc/usr/bin/qconfig
  • host/qnx6/x86/usr/bin/qconfig

Here's the updated description of qconfig, which you'll also find in the Documentation Update 1.0.0.

Syntax:

qconfig [-a] [-b] [-c] [-d path] [-e | -i | -l] [-h]
        [-n installation_name] [-p] [-r program]

Runs on:

QNX Neutrino, Windows, Linux, and Solaris

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 runtime environment strings in csh style.
-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.

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.

Known issues

None currently known.

Technical support

If you have any questions, comments, or problems with a QNX product, please contact Technical Support. For more information, see the How to Get Help chapter of the Welcome to QNX Momentics guide or visit our website, www.qnx.com.