Release notes for Rational PureCoverage 5.2 Solaris 2 Contents ======== o Changes from previous releases o Supported systems o Restrictions and known issues New in this release =================== - Bug fixes and compatibility with OS patches. - This release uses a new FlexLm based licensing. Read the new installation guide before installing the product. Use rs_install instead of pure_install for the installation. New In PureCoverage 5.1 ======================= - Bug fixes and compatibility with OS patches. - Support for Cygnus GNUPro 98r2 compilers - This will be the last release to support Solaris 2.4. New In PureCoverage 4.5 ======================= - Bug fixes and compatibility with OS patches. - Support for Solaris 7 and Sun Visual Workshop 5.0. - This is the last release to support SunOS 4. Apex Ada is no longer supported. New In PureCoverage 4.4 ======================= - Bug Fixes - Support for gcc/g++ 2.8.1 - Support for Rational's ClearQuest defect tracking tool. Please see the Restrictions and Known Issues section below for details on how to use Purify with ClearQuest or ClearDDTS. - Supports FLEXlm based licensing when installed as part of RSDSU. New in PureCoverage 4.3 ======================= - Support for Apex 3.0.0 Ada and C++ on Solaris and HPUX. - Support for Rational's ClearQuest defect tracking tool. Please see the Restrictions and Known Issues section below for details on how to use PureCoverage with ClearQuest or ClearDDTS. New in PureCoverage 4.2 ======================= - bug fixes ================================================== Supported systems ================= Operating system and Hardware ----------------------------- PureCoverage has been tested with Solaris versions 2.5, 2.5.1, 2.6 and 2.7 on SPARC platforms. PureCoverage has also been tested on normal and V8+ SPARC programs on the UltraSPARC. Compilers --------- PureCoverage has been tested with the following compilers: - Sun Workshop C and C++ 4.2 and 5.0 - SPARCWorks C and C++ versions 3.x - SPARCWorks f77 versions: 3.0 - GNU gcc and g++ versions, through version 2.8.1. - Cygnus GNUpro v.98r2 Threads ------- PureCoverage supports these threads packages: - The native Solaris libthread library. - The Solaris Pthreads library, libpthread. - Transarc DCE threads. ================================================== Restrictions and Known Issues ============================= General ------- - As of version 5.1, the product home directory was reorganized. The new layout should be transparent to most users. All libraries have been moved to a lib32 sub-directory, but top level links preserve backward compatibility for accessing the stubs libraries. In the unlikely event you need to access private libraries such as solaris2_threads.so, and you use -printhomedir to construct the path, you must now add a "lib32" component to the path: `purecov -printhomedir`/lib32/solaris2_threads.so Reference to these libraries is rarely necessary. - PureCoverage may not work properly with applications that use Java 1.2 libraries. For details, please see Technical Note #11091 at: http://solutions.rational.com/solutions/ Or contact Rational Technical Support and reference Tech Note #11091. - Archive libraries containing both 32-bit and 64-bit libraries are not supported. All components of a link must be of the same ELF type, and the first archive member is used to determine the link type. - gcc/g++ 2.8.1 is supported, but there are known problems with C++ shared libraries containing gcc/g++ produced objects files containing exception handling code. - This release of PureCoverage does not support Solaris 2.3. - Because of operating system differences, programs instrumented on one version of Solaris may crash or generate incorrect results if run on a different version of the operating system. - PureCoverage does not support use of the LD_PRELOAD environment variable. - The SPARCWorks incremental linker, ild, is automatically disabled by PureCoverage due to an incompatibility with file naming conventions. - Earlier releases of PureCoverage intercepted calls to dlclose() and prevented dynamically loaded libraries from being unmapped. This had the effect of preventing static destructors from running but allowing coverage data for such libraries to be saved at program exit. By default, PureCoverage 4.0 now allows libraries to be unmapped, at the expense of not saving coverage data for such libraries. The new -dlclose-mode integer option controls this behavior : -dlclose-mode=0 (default for earlier releases) libraries may not be unmapped. -dlclose-mode=1 (default for PureCoverage 4.0) libraries may be unmapped. -dlclose-mode=2 libraries may be unmapped, coverage data is saved just prior to unmapping. User Interface -------------- - The PureCoverage GUI menus and buttons become inaccessible if either the NumLock or ScrollLock key is activated. The workaround is to switch them off, or add the following line(s) to your $HOME/.Xdefaults file. ! Ignore the NumLock and ScrollLock keys on ! mouse buttons PureCoverage*ignoreModifierMask: Mod3|Mod2 This second workaround will take effect for a new PureCoverage viewer after you restart your X-session or run a command like 'xrdb -merge $HOME/.Xdefaults'. - The "Invoke ClearDDTS" Button has been modified to bring up the ClearQuest web interface. This feature only works with Netscape Navigator. The site-wide URL for ClearQuest can be given during installation or set by manually editting the file pure_clearquest_url in your PureCoverage home directory. A user can override the site-wide URL by setting the environment variable PURE_CLEARQUEST_URL This feature is partly implemented by a shell script, ("pure_invoke_clearquest" in your PureCoverage home directory) to allow you to tailor its operation to your needs. If you wish, you may copy and customize this. script. As long as the directory containing the script appears in your search path before your PureCoverage home directory, it will be used instead of the original script. If you prefer to use PureCoverage with ClearDDTS, you can do so by setting the X resource: PureCoverage*ddtsCommandString to 'xddts', if xddts is in your search path, or to the full path to your xddts executable. xddts is invoked by a shell script ("pure_invoke_ddts" in your PureCoverage home directory). If you wish to customize it, please read the section on customizing "pure_invoke_clearquest" above. If you already have a customized "pure_invoke_ddts" script in your search path, All you need to do is set your X resource as described above, and PureCoverage will find your customized script automatically. The following copyright applies to portions of this ClearQuest integration code: Copyright 1996 Netscape Communications Corporation, all rights reserved. Created: Jamie Zawinski , 24-Dec-94. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. Compilers --------- - The GNU gcc extensions are not tested against PureCoverage. Most gcc extensions will probably work fine. Known limitations at present include problems with nested functions (e.g.: making a pointer to a nested function and attempting to call through it will not work). Threads ------- - Customers using unsupported threads packages should contact Rational Software technical support (support@rational.com) to ensure compatibility.