Home
Developer Resources
Technical Articles

QNX Technical Articles

QNX® Momentics® Development Suite 6.3.0 SP1 or Later (Professional Edition) IDE 4.0.1 Memory Analysis Target Patch (ID 525) Installation Note

QNX® Momentics® Development Suite 6.3.0 SP1 or Later (Professional Edition)

Date of this edition: May 01, 2007

Target OS: QNX® Neutrino® 6.3.0 SP1 or later

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


Note: For information about the issues that this patch addresses, see the Release Notes.

This note includes:

Installation procedure

Before installing this patch, you need to determine the patch number of the Memory Analysis Target Patch that you have currently installed on your system.

To verify if the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525) should be installed on your system:

  1. For Linux, Neutrino, and Solaris, start a shell. For Windows, run "bash".
  2. Navigate to the location base_dir/patches.
  3. Run the following command:

    ls */rel*libmalloc_g*.html

    If the command returns the message "No such file or directory", install the IDE 4.0.1 Memory Analysis Target Patch (Patch ID 525).

    If the command returns one or more files, each file will have the following format:

    630<version>-<number>/rel_libmalloc_g_patch<number>.html

    where:

    • version is the product version identifier assigned to the patch
    • number is the identifier assigned to the patch

    If you have only files in which the number is less than 0525, then you should install this patch. Otherwise, if the number is greater than 0525, and the patch with that number has been applied on your system, then you should not install patch 0525.

To install this patch:

  1. If not currently logged in as root, log in as root (or with administrator privileges on Windows).
  2. Open a web browser, go to our website www.qnx.com and log on to your myQNX account.
  3. Click Download Center-->Products & Updates-->QNX Momentics-->QNX Momentics 6.3.x-->QNX Momentics 6.3.0 Service Pack 2 and related downloads-->QNX Momentics 6.3.0 Service Pack 2 Patches and Updates.
  4. Download the patch-630SP2-0525-malloc-g.tar archive to your host environment.
  5. Determine the base directory of your QNX Momentics installation by opening a command shell and using the qconfig command. For example:
    $ qconfig
    QNX Installations
    
    Installation Name: QNX Momentics 6.3.0
    Version: 6.3.0
    Base Directory: /usr/qnx630/
    QNX_HOST: /usr/qnx630/host/qnx6/x86/
    QNX_TARGET: /usr/qnx630/target/qnx6/
      

    The base directory in this example is /usr/qnx630/, but it might be different on your machine, depending on your host and where you installed QNX Momentics.

  6. You can extract the archive you downloaded into this base directory using one of the following two methods, based on your host configuration:
    Method 1: Using the command line
    • For Windows hosts:
      1. Open a command prompt (cmd.exe) and change to the drive indicated in the base directory that you identified in step 2 (e.g. C:).
      2. Copy the archive to your base directory, replacing base_dir with the path from step 2:

        copy drive:\patch-630SP2-0525-malloc-g.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-630SP2-0525-malloc-g.tar

    • For Neutrino, Linux, and Solaris hosts:

      Open a command shell and use the following commands (replacing base_dir with the path you identified in step 2, and archive_path with the full path to the downloaded archive):

      cd base_dir
      tar -x -v -f archive_path/patch-630SP2-0525-malloc-g.tar

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

    Note: If you use WinZIP, choose Options-->Configuration, change to the Miscellaneous tab in this dialog, and de-select the TAR file smart CR/LF conversion option. If this option is selected and you attempt to extract the archive, your shiplist file will contain ^M characters.

Structure of a patch

The patch is installed in the base_dir/patches/630SP2-0525/ directory. This directory includes the following:

version
Includes the patch number and the build information.
manifest
Contains the checksums of the files shipped in the patch (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/630SP2-0525/shiplist > patches/630SP2-0525-backup.tar

    You can use whatever name you prefer 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 safely ignore these messages.

  4. (Windows only) Exit ksh.

Copying the files -- Windows hosts

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

  1. Change to the drive specified in your base directory (e.g. C:).
  2. Go to the patch directory. Remember to replace the forward slash characters (/) in the base directory with the backslash character (\):

    cd base_dir\patches\630SP2-0525

  3. Install the target updates:

    cp -Rp target base_dir\.


Note:
  • After you install, you must copy the files located in $QNX_TARGET/target_architecture/usr/lib/malloc_g/libmalloc.so.2 to $QNX_TARGET/target_architecture/usr/lib/libmalloc_g.so.
  • To use the features of the Memory Allocation perspective that these libraries support, you must copy the appropriate version of the libraries to your target machine. For more information about the libraries, see the IDE User's Guide.

Copying the files -- Neutrino, Linux, and Solaris hosts

To apply the patch on a Neutrino, Linux, or Solaris system:

  1. Go to the patch directory:

    cd base_dir/patches/630SP2-0525

  2. Install the target updates:

    cp -Rp target base_dir/.

  3. (QNX Neutrino only) Install the runtime updates:
    cd target/qnx6/x86
    cp -fRp . /
      

Note: To use the features of the Memory Allocation perspective that these libraries support, you must copy the appropriate version of the libraries to your target machine. For more information about the libraries, see the IDE User's Guide.

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.