Release notes for PureCoverage version 2002a.06.00 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. - Modified support for Change Request Management systems, including Rational's ClearQuest and ClearDDTS. Please see online help for more information. - Support for Forte 7 compiler (compiler version 5.4). - This release does not support Solaris 2.5.1 (SunOS 5.5.1). New in PureCoverage 2002.05.00 ========================= - Bug fixes and compatibility with OS patches. - Support for Forte 6 Update 2 compiler (compiler version 5.3). - Support for gcc 2.95.3 compiler. - This is the last release to support Solaris 2.5.1 (SunOS 5.5.1). New in PureCoverage 2001a.04.00 =============================== - Bug fixes and compatibility with OS patches. - HTML-based online help system. See the "HTML Help" topic in the Restrictions and Known Issues section. - New product versioning system. This release is the successor of: PureCoverage 5.3 for Solaris - Support for Forte 6 Update 1 compiler (compiler version 5.2). - Support for gcc 2.95.2 compiler. New in PureCoverage 5.3 ======================= - Bug fixes and compatibility with OS patches. - Support for Solaris 8. - Support for Forte 6 (compiler version 5.1) compiler. New in PureCoverage 5.2 ======================== - 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 - 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 HP-UX. New in PureCoverage 4.2 ======================= - bug fixes ================================================== Supported systems ================= Operating system and Hardware ----------------------------- PureCoverage has been tested with Solaris versions 2.6, 7 and 8 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: - Forte 7 (compiler version 5.4) - Forte 6 Update 2 (compiler version 5.3) - Forte 6 Update 1 (compiler version 5.2) - Forte 6 (compiler version 5.1) - Sun Workshop C and C++ 4.2 and 5.0 - GNU gcc and g++ versions 2.8.1, 2.95.X - Cygnus GNUpro v.98r Threads ------- PureCoverage supports these threads packages: - The native Solaris libthread library. - The Solaris Pthreads library, libpthread. - Transarc DCE threads. ================================================== Restrictions and Known Issues ============================= Licensing Troubleshooting ------------------------- - When PureCoverage is properly installed, a .lm_license_file file is created in the product home directory to allow PureCoverage to locate your licenses even when LM_LICENSE_FILE is not set appropriately in the user's environment. If you get a message such as: Error: Unable to open /product_home/.lm_license_file. Your installation is incomplete. Did you run rs_install? ... Check your product home directory to see if .lm_license_file exists and is readable by you. If the file does not exist, your installation is incomplete. You may need to re-run rs_install or license_setup. If the permissions are incorrect, change them so that the file is readable by all expected users of PureCoverage. - If you manually change the location of your licenses (e.g. without using license_setup), the .lm_license_file will not be updated and you will not be able to checkout a license unless you set the env var LM_LICENSE_FILE to point to the new location. You should always use license_setup to make changes to your licenses. - Be sure you install the products that correspond to your license(s). Do not install PurifyPlus unless you have a PurifyPlus license. To check your license, locate the "INCREMENT" line(s) in your license file (*.dat) or license update file (*.upd). The license feature name is the first word on the line after "INCREMENT". For example: INCREMENT PurifyPlusUNIX rational 5.0 10-jan-2001 1 1234556789012 ^^^^^^^^^^^^^^ If you do not see "PurifyPlusUNIX" on the increment line, you do not have a PurifyPlus license and should not install PurifyPlus. HTML Help --------- As of version 2001a.04.00, the online help has been replaced by a more robust HTML based help system. The new online help incorporates all the information from the product user manual. The following restrictions and notes apply to using the HTML help system: - The only supported browser for the HTML based help system is Netscape Navigator, versions 4.7.x. The HTML based help system does not work with pre 4.7 versions or with 6.x versions. - You may view the help in stand-alone mode by pointing your browser to the following: product_home/UI/html/pcu.htm (Where "product_home" is the installation location of PureCoverage. e.g. the result of the -printhomedir option.) - Netscape must be on your path when you run your instrumented program. Your path is used to locate the browser. - The first time you request help from a viewer, a new netscape session will be started, even if you already have netscape running. This session will be re-used by subsequent help requests unless you re-use the launched browser for another purpose. If you close the browser, a new browser will be launched upon the next help request. - The new help system uses Javascript. On some platforms, the MOZILLA_HOME environment variable must be set in order for Javascript based web pages to work properly. If you experience Java related problems with the help: Make sure your netscape installation directory is on your path and that MOZILLA_HOME is either not set at all (we will set it for you) or is set to the same installation directory. If MOZILLA_HOME is set but does not point to the same netscape installation as the netscape on your path, the help may not work correctly. If MOZILLA_HOME is not set at all, PureCoverage will attempt to set it when we start netscape. But we will be unable to set it correctly if the netscape found on your path does not resolve to an actual installation directory. For example, if netscape actually references a wrapper script in /usr/local/bin. In this case, you will need to set MOZILLA_HOME explicitly. See the Netscape release notes for more information on MOZILLA_HOME. - Use the Help->Help Topics menu item to access the top level of the help system. - Context sensitive help is available on leaf menu items and on buttons ONLY. For information about a window, use the Help->On Window menu item. - PDF versions of the PureCoverage Quick Reference card is available in the doc/pdf section of your installation, if you have installed PDF documentation. Otherwise, see the corresponding area of your installation CD. General ------- - PureCoverage does not present accurate line-by-line coverage data in the annotated source window if the code is compiled with both debug and optimization flags. - If PureCoverage is run in "/tmp" or "/usr/tmp" or "/var/tmp" the generated instrumented *.o files are deleted in these directories. So please do not use commands like : PureCoverage cc -nolink ld file.o in "/tmp" or "/usr/tmp" or "/var/tmp" . However there is a work-around for this , You can use the option "-save-tmp-files" to tell PureCoverage not to delete the generated objects. So using: PureCoverage -save-tmp-files cc -nolink ld file.o will generate the instrumented file_pure_*.o in "/tmp" or "/usr/tmp" or "/var/tmp". Otherwise you can use -always-use-cache-dir so that the generated file_pure*.o is generated in cache-dir where it is not deleted (Note: if cache-directory is installed in "/tmp","/usr/tmp","/var/tmp" the generated *_pure_*.o in cache are not deleted , so you can have the cache-directory safely in "/tmp","/usr/tmp","/var/tmp") - 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. Users are encouraged to use the libraries from the lib32 directory, and not from purecovhome. 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 search the solutions knowledge base at: http://eservice.rational.com/solutions Or contact Rational Technical Support. - 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. - 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. - If you are running your application on a different machine from the one on which it was built, please ensure that both the machines have the same operating system. Further, the system libraries on the two machines should be identical. Otherwise, PureCoverage might generate a warning message. For more details on how to build and run on different machines, please please see solution #5829 at: http://eservice.rational.com/solutions Or contact Rational Technical Support and reference Solution #5829. - 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. - Static data checking is not supported with the Forte 6 compiler. - 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'. 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. Copyright Notice ---------------- The following copyright applies to portions of the ClearQuest integration and HTML based help system. Copyright 1996 Netscape Communications Corporation, all rights reserved. Created: Jamie Zawinski (jwz@netscape.com), 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.