QNX Technical Articles

Date of this edition: December 09, 2005

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, or 9; QNX^® Neutrino^® 6.3.0 SP1 or later; Linux Red Hat 8, 9, or Enterprise WS 3 or 4

For information about the issues addressed by this patch, see the release notes.

Contents...

This note includes:

• Installation procedure
• Structure of a patch
• Applying the patch
• Technical support

Installation procedure

You should back up the affected files before you install this patch. For more information, see "Applying the patch," below.

Here's how to install each QNX Momentics Patch:

1. Log in as root (or with administrator privileges on Windows).
2. Download the archive to your host environment.
3. Determine the base directory of your QNX Momentics installation by opening a command shell and using the qconfig command. For example:

   C:\>qconfig
   QNX Installations
   
   Installation Name: QNX Momentics 6.3.0
   Version: 6.3.0
   Base Directory: C:/QNX630/
   QNX_HOST: C:/QNX630/host/qnx6/x86/
   QNX_TARGET: C:/QNX630/target/qnx6/
     

   The base directory in this example is C:/QNX630/, but it could be different on your machine, depending on your host OS and where you installed QNX Momentics.

4. Extract the archive you downloaded into the base directory:

   Method 1: Command-line based

   For all hosts, you can open a command shell and use the following commands (replacing base_dir with the path found in step 2, and archive with the full path to the downloaded archive):

   cd base_dir
   tar -xvf archive

   Method 2: GUI based

   Use any GUI-based application that supports the TAR format (e.g. WinZIP under Windows). Ensure that the destination directory is your base directory.

   ---

   If you use WinZIP, choose Options-->Configuration, switch to the Miscellaneous tab in this dialog, and turn off the TAR file smart CR/LF conversion option. If this option is turned on, and you extract the archive, then your shiplist file will contain ^M characters.

   ---

5. Next, you must incorporate the patch into your host system; see "Applying the patch," below.

Structure of a patch

The patches are always installed in a directory like this:

base_dir/patches/630SPn-number/
Where n is the QNX Momentics 6.3.0 Service Pack number and number is the Patch ID number.

The files of interest within the 630SPn-number directory are:

Relnotes_rel.html
Contains the Release notes.

version
Includes the patch number and the build information.

manifest
Contains the checksums of the files shipped in the patch (as generated by the cksum utility).

shiplist
A list of the files included in the patch.

Applying the patch

Next, you must determine how to incorporate the patch into your host system. The patch is stored in a directory (or folder) that's separate from your development system. This allows you some flexibility in how to apply the patch.

There will be some instances in which the patch won't be effective unless you apply it to the development system in a particular way. The release notes for these patches will indicate which method you should use.

There are three methods for using a patch:

• modifying build and configuration files to look in the patch subdirectory
• creating an override directory tree
• replacing the development host files with those from the patch.

The first two methods work only for files within the $QNX_TARGET subtree. For tools and other host specific files, you must use the third method.

Method 1: Modifying build and configuration files

In the first method, you can use the files in the patch by simply modifying buildfiles to include the full path to the files in the patch subdirectory. This allows you to test the patch before committing to it. It doesn't affect your development host. If you choose to stop using the patch, you just need to change the buildfiles back.

Method 2: Using an override directory tree

You can use a similar approach that involves creating an "override" tree. You can tell the system builder and mkifs utilities to look for binaries in a particular subdirectory before looking in the standard location ($QNX_TARGET). To do this from the command line:

1. cd base_dir
2. pax -rw patches/630SPn-number/target/qnx6/* build/
3. Add base_dir/build to your system builder paths. For mkifs, you can use the -r option, specifying the same path.

Method 3: Replacing the development host files

The third method replaces the file on your development host with the patched files.

Since this is a destructive procedure, we recommend that you create a backup of the affected files.

To create a backup on any of our hosts (run ksh on Windows):

1. cd base_dir
2. pax -w < patches/630SPn-number/shiplist > patches/630SPn-number/backup.tar

You can use whatever name you like for the backup archive. Replace 630SPn-number with the actual basename and number of your patch. To apply the patch:

1. cd base_dir/patches/630SPn-number
2. pax -rw < shiplist base_dir

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.