© 2001 Compaq Computer Corporation.

Applications developed using the Compaq C++ compiler require functionality provided in the C++ Run-Time Library. While this run-time library ships with the Tru64 UNIX operating system, newer versions are released with each new version of the compiler. These newer versions provide bug fixes and support for new features in the compiler.

The C++ library redistribution kit gives the user the opportunity to upgrade the C++ library to the most up-to-date libraries without having to upgrade the entire OS and alleviates the need for application developers to include it in their distributions. Because the library is built to be upwardly compatible, a later version of the library works with applications developed by all prior versions of the compiler.

While we strongly recommend upgrading for bug fixes, this is not mandatory. Read the compiler Release Notes to determine whether your application depends on these bug fixes.

Upgrading for new compiler feature support is not optional. To run an application developed using verion n of the compiler, you must use a version of the library that provides support for all its features. In previous versions, this typically results in undefined symbol errors from the loader at runtime. Starting in V6.3, failure to do so will result in the following diagnosic from the loader at runtime:

slab> a.out 333677:a.out: /sbin/loader: Fatal Error: object libcxx.so from liblist in a.out has version "cxx6.3", which does not match the found object: libcxx.so (with version ":V4.0.1")

The following table provides the version of the library that shipped with each version of the OS. The C++ Compiler Feature Version is the absolute highest version of the compiler with which an application could have been developed and be deployed on this platform without the redistribution kit. An application developed with a newer compiler or that depends on a bug fix requires the installation of the redistribution kit.

OS	Default C++ Library Shipped with System	Highest Version of C++ Compiler Not Requiring Redistribution Kit
4.0D	6.0-021	6.1-031
4.0E	6.0-021	6.1-031
4.0F	6.1-031	6.1-031
4.0G	6.2-037	6.2-040
5.0	6.2-024	6.2-040
5.0A	6.2-037	6.2-040
5.1	6.2-037	6.2-040
5.1A	6.3-001	6.5-nnn
5.1B	6.5-014	6.5-nnn

Getting the Redistribution Kit

The latest redistribution kit can be downloaded from the Compaq website using the following URL:

ftp://ftp.compaq.com/pub/products/C-CXX/Tru64/cxx/CXXREDIST650V01.tar

Instructions for Installing Redistribution Kit

To install the kit, follow these steps:

1. Check if the installed libcxx is earlier than the one on this redistribution kit
   Newer libcxx.so images have symbols defined which identify the version of the run-time library. If the symbol __libcxx_V60500001 exists in the image on your system, then you do not need to install this kit.

   # nm /usr/lib/cmplrs/cxx/libcxx.so | grep libcxx_V __libcxx_V60200002 | 0004396996916008 | G | 0000000000000000 __libcxx_V60200003 | 0004396996916016 | G | 0000000000000000 __libcxx_V60300001 | 0004396996918728 | G | 0000000000000000 __libcxx_V60500001 | 0004396996918728 | G | 0000000000000000

2. If an older redistribution kit was previously installed on the system, it must be removed prior to the installation of the new one.
   The subset name could be CXXLIBnnn or CXXREDISTnnn

   # /usr/sbin/setld -i | egrep "CXXLIB|CXXREDIST" | grep install CXXREDIST610 installed Compaq C++ Run-Time Library ... # /usr/sbin/setld -d CXXREDIST610

3. Install the redistribution kit

   # tar -xvf CXXREDIST650Vmm.tar # /usr/sbin/setld -l CXXREDIST650.kit

Send questions about proper usage or problem reports with this kit to compaq_cxx.bugs@compaq.com.