HP Caliper for HP-UX Release Notes Release 5.5 September 2012 HP Part Number: 5900-2350 Published: September 2012 Edition: 5.
© Copyright 2012 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.5......................................................................................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.5 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.
in the other. To enable marking of branch targets, set disasm_mark_branch_targets = True in the .caliperinit file or a configuration file. • Running HP Caliper on set-user-ID and set-group-ID programs For security reasons, the HP-UX kernel does not allow users to run HP Caliper or any other program to monitor a program that has its setuid or setgid bit set. If you run a set-user-ID program under HP Caliper, the setuid/setgid will not be honored.
• 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. To measure a program such as this, you must specify the --process-all option.
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 Java Java version 1.5.0.03 is required if you want to attach HP Caliper to an application and enable attribution of samples to JVM compiled methods at run time. Java 1.5 is needed to run the HP Caliper GUI. Java 1.5 is also needed if you want to measure a Java application on HP-UX with HP Caliper.
The latest version of HP Caliper is available on the HP Caliper Web page at: http://hp.
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 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.3 New Options and Enhancements The HP Caliper 5.3 release has the following improvements: • A new option --sw-process-list, is added. This option is used in the system-wide mode (-w option) to specify a list processes to analyze. This option is used to reduce the overhead of Caliper in the system-wide mode.
Deletions None. Changes in Release 5.1 New Options and Enhancements to Options The HP Caliper 5.1 release has the following improvements: • The cstack report has been enhanced to report inter-process blocking primitives (semaphores, message queues, sockets, pipes, regular file descriptors, etc.). This process level blocking primitive information is provided in addition to the previously reported primitives (mutexes, rwlocks, condition variables, etc.).
• HP Caliper can now generate reports from Caliper databases created on a different OS than the one from which HP Caliper is reporting. You can now view measurement information on a different system than that used to make the measurement. • The –db-save option has a new argument, all, that specifies that symbols, code, and line tables should be saved to the HP Caliper database. This information can then be used to report without access to the original binaries.
Changes in Release 4.4 New Options and Enhancements to Options • The new option: --db-save=[syms][:code][:src] allows you to save in the database containing your measurements, additional information helpful in later reporting. This option must be used when the measurement is first made. You can then generate reports or view reports in the GUI without needing access to the system where data was collected.
$ ssh-agent /bin/sh $ ssh-add [enter your passphrase] $ Caliper or $ ssh-agent SSH_AUTH_SOCK=/tmp/ssh-2tVlwIXMua/agent.4624; export SSH_AUTH_SOCK; SSH_AGENT_PID=5948; export SSH_AGENT_PID; $ SSH_AUTH_SOCK=/tmp/ssh-2tVlwIXMua/agent.4624; export SSH_AUTH_SOCK; $ ssh-add [enter your passphrase] $ Caliper On Windows, the Caliper GUI has been tested with cygwin's version of Open SSH (typically installed at C:\cygwin\bin\ssh).