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

QNX Technical Articles

QNX® Aviage® Acoustic Processing 1.3.0 ARMLE, PPCBE, and SHLE Patch (Patch ID 1846) Installation Note

QNX® Aviage® Acoustic Processing 1.3.0 ARMLE, PPCBE, and SHLE Patch (Patch ID 1846): Installation Note

Date of this edition: March 25, 2010

Target OS: This patch is compatible with targets that are running QNX® Neutrino® 6.3.2 or 6.4.0.

Host OS: You must have already installed the QNX® Momentics® development suite 6.3.2 or the QNX Software Development Platform 6.4.0 as a self-hosted QNX® Neutrino® system, or on one of the following development hosts:

Version Microsoft Windows Linux
QNX Momentics 6.3.2 Windows Vista, XP SP2, or 2000 SP4 Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7.0.4, or SUSE 10
QNX SDP 6.4.0 Windows Vista, Vista 64-bit, XP SP2 or SP3, or 2000 SP4 Linux Red Hat Enterprise Workstation 4 or 5, Red Hat Enterprise Server 5.1 64-bit, Red Hat Fedora Core 6 or 7, Ubuntu 6.0.6 LTS or 7, or SUSE 10

You must also have installed QNX Aviage Acoustic Processing 1.3.

Note:
  • This patch doesn't apply to QNX Aviage Acoustic Processing 1.2. For version 1.3, this patch supersedes the QNX Aviage Acoustic Processing 1.2 and 1.3 ARMLE, PPCBE, and SHLE qwa_rcs Libraries Patch (Patch ID 1401).
  • For information about the issues that this patch addresses, see the release notes.
  • You should also install the QNX Aviage Acoustic Processing 1.3 QWALive.exe for Windows Patch (Patch ID 1852).

This note includes:

Installing this patch on QNX Momentics 6.3.2

  1. Log in as root (or with administrator privileges on Windows).
  2. On Debian 3.1 hosts, set up your environment by typing: 
    source /etc/profile
  3. Download the patch-632-1846-WB-AGC.tar archive to your host environment.
  4. 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.2
            Version: 6.3.2
     Base Directory: C:/QNX632/
           QNX_HOST: C:/QNX632/host/win32/x86/
         QNX_TARGET: C:/QNX632/target/qnx6/

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

  5. Extract the archive you downloaded into the base directory:
    • Windows hosts:
      1. Open a command prompt (cmd.exe) and switch to the drive indicated in the base directory that you found earlier (e.g. C:).
      2. Copy the archive to your base directory, replacing base_dir with the path you found earlier:

        copy drive:\patch-632-1846-WB-AGC.tar base_dir

      3. Use the following commands to extract the archive contents. Don't specify the drive letter in the archive path:

        cd base_dir
        tar -xvf patch-632-1846-WB-AGC.tar

    • Neutrino and Linux hosts:

      Open a command shell and use the following commands (replacing base_dir with the path found earlier, and archive_path with the full path to the downloaded archive):

      cd base_dir
      tar -x -v -f archive_path/patch-632-1846-WB-AGC.tar

Structure of a patch

The patch is installed in the base_dir/patches/632-1846/ directory. This directory includes:

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.
target
A directory of fixes related to components that would be built into QNX Neutrino target or runtime systems.

Applying the patch

Next, you must replace the files on your development host with the patched files.

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

Creating a backup

To create a backup on any of our hosts:

  1. (Windows only) From the cmd.exe prompt, run ksh.
  2. Go to the base directory:

    cd base_dir

  3. Make a backup of the files that will be overwritten:

    pax -w < patches/632-1846/shiplist > patches/632-1846-backup.tar

    You can use whatever name you like for the backup archive. The pax utility might display some error messages when it attempts to back up nonexistent files for host operating systems other than the one you're using. You can ignore these messages.

  4. (Windows and Linux only) Go to the directory that holds the documentation plugins: 
    cd $QNX_HOST/usr/qde/eclipse/plugins
  5. (Windows and Linux only) Back up the Acoustic Processing documentation:

    pax -w com.qnx.doc.acoustic_processing_en_* > base_dir/patches/632-1846-doc-backup.tar

  6. (Windows only) Exit ksh.

Copying the files — Windows hosts

To apply the patch on a Windows system from the command prompt (remember to switch back to cmd.exe from ksh):

  1. Switch to the drive specified in your base directory (e.g. C:).
  2. Go to the patch directory (remember to replace / characters in the base directory with \):

    cd base_dir\patches\632-1846

  3. Install the target updates:

    cp -Rp target base_dir\.

  4. Move the Acoustic Processing documentation plugins to the correct location: 
    mv %QNX_TARGET%/usr/help/eclipse/plugins/com.qnx.doc.acoustic_processing_en_* %QNX_HOST%/usr/qde/eclipse/plugins

Copying the files — Neutrino and Linux hosts

To apply the patch on a Neutrino or Linux system:

  1. Go to the patch directory:

    cd base_dir/patches/632-1846

  2. Install the target updates:

    cp -Rp target base_dir/.

  3. (Linux only) Move the Acoustic Processing documentation plugins to the correct location: 
    mv $QNX_TARGET/usr/help/eclipse/plugins/com.qnx.doc.acoustic_processing_en_* $QNX_HOST/usr/qde/eclipse/plugins

Installing this patch on QNX SDP 6.4.0

Note: To make installing patches easier, get the applypatch Patch (Patch ID 1523) from the Download area on our website, and then install it.
  1. Log in as root (or with administrator privileges on Windows).
  2. On Debian 3.1 hosts, set up your environment by typing: 
    source /etc/profile
  3. Download the patch-632-1846-WB-AGC.tar archive to your host environment.
  4. On Windows hosts, run cmd.exe.
  5. Use the applypatch utility to install the patch:
    • On Linux, if you use sudo (as would be the case on Ubuntu), you must specify the -E option to preserve the environment. In this case, the PATH environment variable is set to a safe one for security reasons, so you need to specify the full path to the utility: 
      sudo -E $QNX_HOST/usr/bin/applypatch patch-632-1846-WB-AGC.tar
    • On other hosts, type: 
      applypatch patch-632-1846-WB-AGC.tar

    For more information about applypatch, see its entry in version 6.4.1 or later of the Utilities Reference.

    Note: During the installation, applypatch warns you that the following files in the patch are older than the files already on the disk:
    • target/qnx6/usr/include/qwa.h
    • target/qnx6/usr/include/qwa_err.h
    • target/qnx6/etc/readme/qnxaviage-ap/qwa_hf_example/qwa_hf_example.c
    • target/qnx6/etc/readme/qnxaviage-ap/qwa_vr_example/qwa_vr_example.c

    You should replace all of these files with the ones in the patch.

Uninstalling this patch on QNX SDP 6.4.0

  1. Log in as root (or with administrator privileges on Windows).
  2. On Debian 3.1 hosts, set up your environment by typing: 
    source /etc/profile
  3. On Windows hosts, run cmd.exe.
  4. Use the applypatch utility to install the patch:
    • On Linux, if you use sudo (as would be the case on Ubuntu), you must specify the -E option to preserve the environment. In this case, the PATH environment variable is set to a safe one for security reasons, so you need to specify the full path to the utility: 
      sudo -E $QNX_HOST/usr/bin/applypatch -U 1846
    • On other hosts, type: 
      applypatch -U 1846

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 or Welcome to the QNX Software Development Platform guide or visit our website, www.qnx.com.