HP Caliper for HP-UX Release Notes Release 5.3 February 2011 HP Part Number: 5900-1559 Published: February, 2011 Edition: 5.
© Copyright 2011 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Highlights of This Release............................................................................4 New Options and Enhancements in 5.3......................................................................................4 Deprecations...........................................................................................................................4 Deletions................................................................................................................................
1 Highlights of This Release NOTE: For the latest information about HP Caliper, see the HP Caliper Web site at http://hp.com/ go/caliper. In particular, you should go to the Latest Release page and see if there is any information about problems found after the software kit was produced. For more information about these highlights, see the HP Caliper User Guide. If you have questions about HP Caliper, send email to caliper-help@cup.hp.com. New Options and Enhancements in 5.3 The HP Caliper 5.
2 Known Problems and Workarounds GUI Limitations • Using the same HP Caliper GUI project for both HP-UX and Linux sometimes results in corruption of the project. When this occurs, the GUI will post an error message at the end of a collection run saying it failed to save the information to the project. This limitation can be avoided by using separate workspaces for HP-UX and Linux.
• When marking targets of branches in disassembly, targets in split procedures will not be marked if the branch origin is in one part (hot or cold) of the procedure and branch target is in the other. To enable marking of branch targets, set disasm_mark_branch_targets = True in the .caliperinit file or a configuration file.
• It is not possible to debug an application while it is being measured by HP Caliper. • Missing function name for STUB. Shared bound executables make use of “stubs” to bridge calls between load modules. HP Caliper reports stubs with the name of the function they bridge to, for example: {STUB}->function in most, but not all cases. • A program that calls setjmp, forks, or execs a process with the child process doing a longjmp to the parent-saved address fails with the precise measurement configurations.
3 Installation Information Operating System Requirements HP-UX 11i v2 or later is required. Hardware Requirements HP Caliper is supported on the HP Integrity server family. Software Requirements Local Server for Linux/x86 The local HP Caliper server requires the following minimum library versions: • glibc 2.3.3 or later • libstd++ 3.3.3 or later • libgcc 3.3.3 or later Shared library version requirements for the local Caliper include: • libstdc++.so.5 • libgcc_s.so.1 • libc.so.6.
For example: $ cd /tmp gunzip caliper-5.x.x.depot.gz Make sure the file has the .gz suffix. Some browsers remove the .gz extension but do not uncompress the file. If the extension is missing, rename the file to caliper-5.x.x.depot.gz. To install the software on your system, in a shell, as root, use the following command: $ /usr/sbin/swinstall -x reinstall=true -s /tmp/caliper-5.x.x.depot \* If necessary, replace /tmp with the directory to where you downloaded the package.
4 Documentation and Other Information Resources The complete HP Caliper documentation set contains the following: • HP Caliper Quick Start • HP Caliper User Guide • HP Caliper Advisor Rule Writer Guide • HP Caliper Ktrace Features Guide • HP Caliper for HP-UX Release Notes • HP Caliper for Linux Release Notes You can get more information about HP Caliper in these ways: • An HP Caliper man page is provided. Type: man caliper • Help text: To get short help text, type caliper -h or caliper -?.
• Introduction to Microarchitectural Optimization for Intel Itanium 2 Processors Reference Manual, Document number 251464-001, Intel Corporation, 2002. • Itanium 2 Processor Microarchitecture, Cameron McNairy and Don Soltis, IEEE Micro, IEEE Computer Society, March-April 2003, pages 44-55. • A Methodology for using the Intel Itanium 2 performance counters for bottleneck analysis, Sverre Jarp, Hewlett-Packard Laboratories, August 2002.
5 Support Information For Answers to Your Questions You can get help with using and understanding HP Caliper by sending email to the HP Caliper development team. Please send questions to caliper-help@cup.hp.com. For Support Questions on the Web For support questions, contact the HP support organization at their Web site, the IT Resource Center (ITRC). Contact the site nearest you, either Americas/Asia-Pacific or Europe. The ITRC gives you access to: • A technical knowledge base with self-solve tools.
6 Changes in Previous Releases This section describes changes for the three releases prior to this one. Changes in Release 5.2 New Options and Enhancements The HP Caliper 5.2 release has the following improvements: • Support is added for the quad-core Intel® Itanium® processor 9300 series. • Support is added for simultaneous fprof sampling on multiple PMU counters. The -s or --sampling-spec option can be used multiple times to specify the list of sampling events.
Deprecations • Use of caliper pbo to collect edge profile using dynamic instrumentation is deprecated. If caliper pbo is invoked to collect arc count, the following warning is issued: Caliper pbo edge profile using dynamic instrumentation (--pbo-data-type=arc-stride/stride-arc/arc,dcache-miss) is deprecated. Use the +Oprofile=collect compiler option instead.
Enhancements to the GUI • The HP Caliper GUI for x86 Linux systems now has the option of connecting to a local, x86–based HP Caliper server (in addition to the capability of connecting to a remote Itanium-based server). This is useful for viewing performance data without the need for access to a remote server. Note that the Collect view is disabled when the GUI connects to the x86–based HP Caliper server as it has no perfomance measurement capabilities.
measured. A new io sub option measures and reports the size and time of logical and physical reads and writes for each process or thread. • cstack measurements have been enhanced to report blocking primitives (mutexes, rwlocks, and condition variables). • When HP Caliper is run as root, the cstack measurement now records and reports both user and kernel space portions of the call stack (HP-UX only). • Per-thread data collection and reporting are now the measurement default.
window, register highlighting (via "find" in pop-up menu), and sort on metric while maintaining issue groups. • The system usage measurement can now be made and viewed in the GUI. Deprecations • The option: --data-summary is deprecated as of this release and will be deleted in a future release. Use --dcache-data-profile instead. Deletions • The acount measurement is no longer supported. Changes in Release 4.