QNX Technical Articles

Date of this edition: October 03, 2005

Target OS: QNX^® Neutrino^® 6.3.0 SP1 or later

Host OS: Microsoft Windows XP SP1 or SP2, 2000 SP4, 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 on installing this TDK, see the installation note. For the most up-to-date version of these release notes, log into your myQNX account, and then go to the Download Center area of www.qnx.com.

Contents

• What's in this TDK?
• Fixed issues
• Known issues
• Documentation
• Technical support

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 TDK?

Binaries

This TDK doesn't contain the CPM binaries. They're shipped with the QNX Momentics Development Suite.

Source Code

This TDK contains the source to the CPM binaries and CPM regression test suite. The source includes ham, hamctl, libha, and libham.

This version of the TDK includes updated versions of the following:

• In lib/ha:
  • ha_ReConnectAttach.c
  • ha_reopen.c
  • halibcdecs.h
• In services/ham:
  • ham/ham.c
  • ham/ham.use
  • ham/ham_guardian.c
  • lib/ham_stop.c

After you've installed the source bundle, you can find the associated archive in $QNX_TARGET/usr/src/archives/qnx/tdk-cpm-src.zip.

If you have QNX Momentics PE, you can compile the source using the IDE or the command-line tools; if you have SE, you have to use the command-line tools.

Compiling with the IDE

Once you've installed the TDK, you can simply import the source into a project by doing the following:

1. Start the IDE.
2. Select File-->Import and select QNX Source Package.
3. Select the source package that you want to import, then follow the instructions on the screen.

Compiling with the command-line tools

Here's how to compile the source from the command line:

1. Decompress the archive:
   • On Windows, use Winzip.
   • On Linux, Solaris, and QNX Neutrino, type:

     unzip -d dirname $QNX_TARGET/usr/src/archives/qnx/tdk-cpm-src.zip
         

     where dirname is the directory where you'd like to put the source files.

2. On Windows, start a bash shell in which to run the commands below.
3. Go to the directory where you saved the source:

   cd dirname
     

4. Run the setenv.sh script to configure the environment to build things locally and not install over any existing binaries:

   . ./setenv.sh
     

5. Type make to build the software. You'll find the results of the build in the dirname/install directory.

Fixed issues

• The usage message for ham has been corrected. (Ref# 18979)
• These tests in the test suite no longer report a failure:
  • bk1_genha and bk3_genha no longer fail the ha_dup test. This issue affected applications that used ha_dup to duplicate an HA-aware file descriptor. Duplicated HA FDs are now recovered correctly. (Ref# 20881)
  • Regression test bk2_hamcondition. Applications that call ham_detach_self() and later call ham_entity_handle_free() formerly could crash because the ham_detach_self() call was incorrectly freeing the handle. This has now been fixed. (Ref# 20882)
  • HAM/CPM: (Regression) bk1_hamrestart. This test case made invalid assumptions about the value of the PATH environment variable. Applications that use an explicit full path for restarting shouldn't have been affected by this issue. (Ref# 20883)
• The ham_stop_nd() function is now implemented in libham. (Ref# 23118)
• The ha_ReConnectAttach() function no longer occasionally fails with an error of EBADF (bad file number) when all the arguments are correct. (Ref# 23818)

Known issues

• When you compile the source code, you'll see these benign warnings:
  • Error *warning: overriding commands for target
  • Warning ignoring old commands for target

  You can ignore these messages. (Ref# 20919)

• If you use gcc 3.3.1 to compile the regression tests that are included with the TDK, you'll see some integer constant is too large for "long" type warnings. You can ignore these messages. (Ref# 24112)
• If you advance the system time (e.g. by using the date utility), the HA manager thinks it's missed some heartbeats. (Ref# 22150)
• In Microsoft Windows, certain programs (e.g. Norton Ghost) add directories inside double quotation marks (e.g. ...;"c:\Program Files\Norton Ghost\";...) to your PATH environment variable. This causes the Cygwin spawn() function to fail, which in turn causes cp to fail when called by ln-w. (Ref# 20046)

  Workaround: Modify your PATH environment variable and remove any quotation marks.

Be sure to check the QNX Momentics release notes for related issues.

Documentation

The functionality provided by the TDKs is already described within the QNX Momentics documentation set. For information on CPM, see the:

• High Availability Manager chapter of the System Architecture guide
• High Availability Toolkit Developer'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.