Miscellaneous
This release supports HP-UX 10.30, including kernel threads.
This release supports PA-RISC 2.0 object files.
This release supports the HP aCC compiler.
This release contains a new utility, purela_show, which generates simplified reports from license and usage data maintained in a standard or aggregate PureLA database.
Japanese language support
This release is available with GUI support for the Japanese language. See the Internationalization section below.
Miscellaneous
This release now fully supports the 10.22 CC and 10.32 cc compilers that are available with HP-UX 10.20. In addition, preliminary support is provided for the HP Fortran 90 compiler.
A number of problems reported with PureCoverage 4.0 have been fixed. Please contact support if you have questions about specific reported problems.
PureCoverage has been tested with HP-UX versions 9.01, 9.03, 9.04, 9.05, 10.00, 10.01, 10.10, 10.20, 10.30, and 11.00 from Hewlett Packard.
NOTE: This is the last release of PureCoverage to support HP-UX 9.x.
PureCoverage has been tested with the following compilers:
See the "Restrictions and Known Issues" section for more details.
PureCoverage supports these threads packages:
This change is due to the dld problem below:
One known instance of this problem occurs you use getservbyname() because it loads network protocols using shl_load().
Not all programs using shl_load will experience a problem. Patches are available from HP as of 3/99 on both 11.x and 10.20. The patch numbers are:
PHSS_17225 for 10.20
PHSS_17571 for 11.00
IMPORTANT NOTE FOR aCC USERS: PHSS_17225 does not replace the dld that ships with aCC. This is an oversight. If your instrumented aCC compiled programs hang the aCC dld has the problem that this patch fixes. Rational has verified with HP that replacing aCC's dld with the patched /usr/lib/dld.sl is appropriate:
% cd /usr/lib/aCC
% mv dld.sl dld.old.sl
% ln -s /usr/lib/dld.sl .
-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.
Error: Child process exited with status = 1.
This is caused by an 'ar' failure in this locale. A workaround is to unsetenv LANG before instrumenting.
! 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 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 <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.
g++ 2.7.2 exceptions are not supported.
XDB & Softdebug
Wait...loading shared-library map tables.
xdb panic: Mapped addresses for dld
overlap text segment for dld
There is a simple workaround for this problem and we've implemented it in the shell script <purecovhome>/purecov_xdb. Whenever you use xdb on an instrumented program use this script to invoke xdb.
DDE - Distributed Debugging Environment
prop system -on alias `after_debug delete intercept signal SIGCHLD; \ prop system -off; \ breakpoint -in main -entry -exit; \ go
PureCoverage does not support a type of relocation information known as "old style fixups". These were generated by HP-UX system software before release 3.0. If PureCoverage detects old style fixups the message: Object file has incompatible format (may be older than HPUX 3.0) is generated. We have seen this problem with HP's libsql.a and some of Oracle's Oracle6 libraries.
There is a simple workaround. Given a problem object module (or modules) the workaround is to have /bin/ld build a new object module. Suppose the old object modules are called `foo.o' and `bar.o'. Issuing the command:
% ld -r -o new_foo.o foo.o
% ld -r -o new_bar.o bar.o
or
% ld -r -o foo_and_bar.o foo.o bar.o
would generate a new object module where the old style fixups have been removed.
In the case of an archive file the following script will create a new archive given the full pathname of the original:
#!/bin/sh
# Remove old fixups from an archive.
# Supply original .a name as first argument.
cd /tmp
lib=new_`basename $1`
ar x $1
rm -f $lib
for member in `ar t $1` ; do
ld -r -o _$member $member
ar q $lib _$member
rm $member _$member
done
echo Created `pwd`/$lib
General Limitations
Source Annotation Limitations
!!! Unable to write Lines to Offset Mapping: CONSTRAINT_ERROR
The compiler will fail to generate source information for the associated Ada file that is consumable by Purify Apex, Quantify Apex, and PureCoverage Apex. In this case, no source annotations or line level coverage and performance data will be available for functions in the affected file.
Debugging
For example, if you are using package Puretools.Purify in your application, then you can use the following debugger command:
>p Puretools.Purify.What_Colors(my_address, nbytes)
If you are not using the Ada wrappers in your code, then you would invoke:
>p purify_what_colors(my_address, nbytes)
The C function names and signatures are available in the C/C++ reference sections for each tool. See Help:Manuals:Rational Apex/Pure Integration Manuals.
Using rcc/RCC directly