HP Caliper for HP-UX Release Notes Release 5.2 March 2010 HP Part Number: 5969-7015 Published: March, 2010 Edition: 5.
© Copyright 20010 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.
Table of Contents 1 Highlights of This Release............................................................................................................5 New Options and Enhancements in 5.2...............................................................................5 Deprecations.........................................................................................................................5 Deletions...............................................................................................
Enhancements to the GUI..............................................................................................20 Deprecations..................................................................................................................21 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.2 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.
Other Known Problems and Workarounds • If you are using HP Caliper on HP-UX 11i v2, you will need to install kernel patch PHKL_34020. Please check the HP IT Resource Center for availability and download information for this patch. Contact the HP Caliper team if you have questions about this patch. • • • • • Per-process overview measurement is only available on 11.31 with kernel patch PHKL_38072. HP Caliper's measurements may affect your program's performance.
If you are attaching to an already running set-user-ID program, you must run HP Caliper as the root user. • • • • • • When you have used the -e elapsed_time (or --duration option), the target process may fail with a core dump if the detach occurs while the target is unloading shared libraries. The goal of HP Caliper is to measure any native Itanium application on HP-UX.
• • configurations. To measure a program such as this, you must specify the --process-all option. The cgprof results are affected by the instrumentation done to collect the data. The times may be inaccurate in absolute terms but valid in relative terms. Use fprof to obtain accurate timing data and cgprof for call-graph relative data. HP Caliper uses one POSIX thread per measured process. HP Caliper aborts if the number of measured processes reaches the per-process thread limit.
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.
How to Install To install HP Caliper, you run the SD-UX swinstall command, which will lead you through the installation process. It also gives you information about disk space requirements, version numbers, product descriptions, and dependencies. You can install HP Caliper separately, or as part of the HP C/aC++ and HP Fortran products. When you download HP Caliper from the Web, save the file in a convenient directory (for example, /tmp). Use the gunzip command to uncompress the file.
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 -?.
• • Using HP Caliper with an application program to characterize the Itanium memory hierarchy Using HP Caliper to measure performance data related to translation lookaside buffers (TLBs) You can also read these technical reports about the microarchitecture used in HP Integrity servers: • Dual-Core Update to the Intel® Itanium® 2 Processor Reference Manual for Software Development and Optimization, Document Number 308065-001.
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.
To Join an Email List of HP Caliper Users You can join an email list of HP Caliper users to share hints, comments, or suggestions in an informal way. To sign up: Send email to: majordomo@cxx.cup.hp.com.
6 Changes in Previous Releases This section describes changes for the three releases prior to this one. 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.).
Deletions • The HTML reporting option is deleted. If HP Caliper is invoked using the --html option, the following message is output: HP Caliper: usage error: --html option is no longer supported Use the -o option for text reports or Use the GUI to view the database. Changes in Release 5.0 New Options and Enhancements to Options The HP Caliper 5.
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. The x86–based server is packaged with the x86–based GUI (available from /gui_clients/caliper-clients.tar.gz). To connect to the local server, select Locall Connect ... from the main tool bar.
Use --dcache-data-profile to generate a dcache miss profile by data structure fields. This option will also generate a dcache miss profile by memory region. The compiler option +annotate=structs adds extra information to the compiled binary file. Currently only information about C/C++ structs can be added. This feature's default is off and no annotations are added. When +annotate=structs is used, it will annotate accesses to the fields of C/C++ structs for use by HP Caliper.
[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). Note that the Caliper GUI has not been tested with the Windows SSH implementation, PuTTY.