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 source kit (SK), 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 source kit?
• 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 source kit?

This SK has the source to the TDP binaries, which you can use to build or customize the following QNX Neutrino binaries:

npm-qnet-l4_lite.so

The new lightweight version of the Qnet native network protocol DLL.

npm-qnet-compat.so

The previous version of the of the Qnet native network protocol DLL (deprecated).

gns

Global Name Service manager.

This SK also provides advanced samples of Qnet integration with other interconnects, including TCP and the IXP2800 PCI Bus.

After you've installed the source kit, you can find the associated archive in $QNX_TARGET/usr/src/archives/qnx/srcdrop-tdp.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 SK, 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 it:

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

     unzip -d dirname $QNX_TARGET/usr/src/archives/qnx/srcdrop-tdp.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.

Known issues

• When you compile the source code in the IDE, a few benign warnings will be reported as errors:
  • qnet_error.c: warning: implicit declaration of function `min' /cleanQNX630/workspace/os-tdp_TDP/services/net/npm/qnet/sh/dll.l4_lite.le
  • error #include "../qos/qos_private.h"
• 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 SP1 release notes for related issues.

Documentation

This product includes a manual, the Transparent Distributed Processing Source Kit Developer's Guide, that describes how to write a driver for Neutrino's lightweight L4 QNet to support different fast interconnects. If you're on a self-hosted Neutrino machine, you'll find this manual in the helpviewer; on other hosts, point a browser at:

${QNX_TARGET}/usr/help/product/tdp_sk_en/bookset.html.

The QNX Momentics Development Suite has other documentation related to Qnet, including:

• Native Networking (Qnet) chapter of the System Architecture guide
• Using Qnet for Transparent Distributed Processing chapter of the Neutrino User's Guide
• Transparent Distributed Processing Using Qnet chapter and Advanced Qnet Topics appendix of the Neutrino Programmer'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.