=============================================================================== Intel(R) Thread Profiler 3.1 for Linux* Release Notes =============================================================================== Contents -------- - Overview - Product Contents - What's New - System Requirements - Known Issues and Limitations - Technical Support - Related Products Overview -------- Intel(R) Thread Profiler for Linux* is a performance tuning tool for parallel programs that use POSIX* or OpenMP* or custom synchronization. Product Contents ---------------- Intel(R) Thread Profiler 3.1 for Linux* to be installed on Linux* systems. What's New ---------- - Support for the latest Intel(R) multi-core processors, including the new Intel(R) Core(TM) 2 Duo, Intel(R) Core(TM) 2 Quad, Dual-Core Intel(R) Xeon(R) series and Dual-Core Intel(R) Itanium(R) 2 series. - New Data Collection Options Collect performance data for 64-bit applications on Intel(R) 64 architecture systems using source or binary instrumentation. - Non-RPM Linux* Installer You can now install Intel(R) Thread Profiler for Linux* without root access. System Requirements ------------------- Linux* systems with Pentium(R) processors Minimum Hardware Required Intel(R) Pentium(R) 4 processor 512 MB of RAM 100 MB of disk space Recommended Hardware Pentium(R) 4 processor supporting Hyper-Threading Technology or Intel(R) Xeon(R) processor or higher 2 GB of RAM Required Software Red Hat* Enterprise Linux* 3.0, Red Hat* Enterprise Linux* 4.0, Red Hat* Enterprise Linux* 5.0, Fedora Core* 5, Fedora Core* 6, Red Flag* DC Server 5.0, SUSE* Linux* Enterprise Server 9.0, SUSE* Linux* Enterprise Server 10.0, GreatTurbo* Enterprise Server 10, SGI* Propack 4.0, SGI* Propack 5.0, Miracle* Linux* 4.0, Mandriva*/Mandrake* 10.1, HaanSoft* Linux* Server 2006, Intel(R) Linux Set, Ubuntu* Linux* 7.0, Debian* Linux* 4.0. When Intel(R) compilers are used with compiler instrumentation( -tprofile), Intel(R) compiler version 9.1 or higher must be used for platforms with Intel(R) 64 architecture and Intel(R) Itanium(R) platforms. Required Software for OpenMP* Analysis or Source Instrumentation Intel(R) C++ Compiler for Linux* 8.1, Package ID: l_cc_p_8.1.026 or higher Intel(R) Fortran Compiler for Linux* 8.1, Package ID: l_fc_p_8.1.023 or higher Linux* systems with Itanium(R) 2 processors Minimum Hardware Required Intel(R) Itanium(R) processor 512 MB of RAM 100 MB of disk space Recommended Hardware Dual Intel(R) Itanium(R) 2 processors or higher 2 GB of RAM Required Software Red Hat* Enterprise Linux* 3.0, Red Hat* Enterprise Linux* 4.0, Red Hat* Fedora Core 4, Red Flag* DC Server 5.0, SUSE* Linux* Enterprise Server 9.0, SUSE* Linux* Enterprise Server 10.0, GreatTurbo* Enterprise Server 10, SGI* Propack 4.0, SGI* Propack 5.0, Miracle* Linux* 4.0, Mandriva*/Mandrake* 10.1, HaanSoft* Linux* Server 2006, Ubuntu* Linux* 7.0, Debian* Linux* 4.0. When Intel(R) compilers are used with compiler instrumentation(-tprofile), Intel(R) compiler version 9.1 or higher must be used for platforms with Intel(R) 64 architecture and Intel(R) Itanium(R) platforms. Required Software for OpenMP* Analysis or Source Instrumentation Intel(R) C++ Compiler for Linux* 9.0, Package ID: l_cc_p_9.0.021 or higher Intel(R) Fortran Compiler for Linux* 9.0, Package ID: l_fc_p_9.0.021 or higher Known Issues and Limitations ---------------------------- This release does not support Unicode* file names. The binary instrumentation technology used by Intel(R) Thread Profiler for Linux* can cause some applications to change behavior or terminate abnormally. If this happens, try lowering the instrumentation levels of the problematic modules. When using Intel(R) C++ Compiler for Linux* version 10.0 Beta and Intel(R) Fortran Compiler for Linux* version 10.0 Beta with Intel(R) Thread Profiler versions l_cc_b_10.0.015 and l_fc_b_10.0.015 should be used. Intel(R) Thread Profiler remote data collector requires the compiler environmnet to be set if the application is compiled with Intel(R) Compiler for Linux*. Intel(R) Thread Profiler for Linux* does not support Intel(R) VTune(TM) Performance Environment Command line interface(vtl). Intel(R) Thread Profiler for Linux* will generate invalid results if your system time stamp counters are not synchronized. Intel(R) Thread Profiler for Linux* will display a message indicating that the time stamps counters are not being synchronized or corrupted activity results. This might be resolved either by restarting your system or setting the TP_NO_TSC environment variable to 1. If this does not resolve the issue, there might be issues in your BIOS and we recommend trying Intel(R) Thread Profiler for Linux* on a different machine. If you are using counted FLEXlm* license files during the installation of the client applications, please make sure that either the FLEXlm* server is not running or the FLEXlm* server is running with the complete license files which are used during the installation process. If you are interested in profiling an OpenMP* application in Intel(R) Thread Profiler for Linux*, please set the KMP_FOR_TPROFILE environment variable. Intel(R) Thread Profiler for Linux* cannot analyze processes that are already running. You must either specify the executable as the application to launch, or specify it as a module of interest. Please ensure that all the environment is set that is necessary for the analyzed application regular work before running Intel(R) Thread Profiler remote data collector(ittserver). Intel(R) Thread Profiler for Linux* supports analysis of native binaries and does not support intermediate executable representations intended for managed runtime environments. Software that defines functions with names that match system API names such as ReadFile() or CreateThread() may have link failures when built with source instrumentation using -tprofile. Such software may crash when run with Intel(R) Thread Profiler. To avoid this problem, ensure that your software uses function names that do not match system API names to avoid these issues. Linux* Analysis To use source instrumentation on Linux*, you must setup the environment before compiling with -tprofile or starting the ittserver: Linux* 32-bit: . /opt/intel/itt/tprofile/bin/32/tprofilevars.sh or source /opt/intel/itt/tprofile/bin/32/tprofilevars.csh Linux* 64-bit on Intel(R) 64 architecture: . /opt/intel/itt/tprofile/bin/32e/tprofilevars.sh or source /opt/intel/itt/tprofile/bin/32e/tprofilevars.csh Linux* 64-bit on Itanium(R) processors: . /opt/intel/itt/tprofile/bin/64/tprofilevars.sh or source /opt/intel/itt/tprofile/bin/64/tprofilevars.csh This release does not support the following types of Linux* binaries: - Linux applications statically linked with C/C++ runtime library or POSIX* thread library. - The Linux* kernel and any kernel modules. - The Linux* dynamic linker/loader (/lib/ld.linux.so.*, /lib/ld.*.so). Asynchronous signal handling is not fully supported in this release. Programs that use asynchronous signals may stall when analyzed with Intel(R) Thread Profiler. When an instrumented application calls the exec system function, the whole image context is replaced with the new image. If the application calls exec with the name of the instrumented image, then the instrumented image is used. In the other cases, the original (non-instrumented) image is called, and no results will be generated from this point in the run. Intel(R) Thread Profiler for Linux* does not support setuid images. The setuid mechanism is used to give a user process the effective user ID of another user, usually root. You can use Intel(R) Thread Profiler for Linux* and run the setuid executable only if you are logged in as the same user as the owner of the setuid executable. The application to analyze cannot be a command-line application that expects interactive user input. Source and binary instrumentation may dramatically increase the use of stack space. On Linux* you can use the limit or ulimit commands to specify the stack space used by applications. You may need to increase the stack space to complete the data collection. However, be careful with an unlimited stack space specification. This can result in insufficient space to create the pthread stacks which can cause the data collection to fail. Technical Support ----------------- The product support web site ( http://www.intel.com/cd/software/products/asmo-na/eng/286510.htm ) contains frequently asked questions, product documentation, product errata, as well as solutions to common issues. To receive technical support for this product or product updates, you need to register for an Intel(R) Premier Support account at the Intel(R) Registration Center (http://www.intel.com/software/products/registrationcenter/ ). When submitting an issue to Intel(R) Premier Support ( https://premier.intel.com/), be sure to select Intel(R) Thread Profiler for Linux* from the Product Name drop down list. When submitting an issue please provide the product build number. This information can be found in the tpSupport.txt file. This file is located on the Linux* system in the directory where Intel(R) Thread Profiler for Linux* was installed. The default installation directory is "/opt/intel/itt". Once you have contacted us with your suggestion or problem using your Premier Support account, a technical support engineer will respond within one Intel business day. If you have not received or have lost your Premier Support login ID or password, or are having trouble with access, please visit https://registrationcenter.intel.com/support for assistance. Related Products and Services ----------------------------- Information about Intel(R) Software Development Products is available at http://www.intel.com/software/products/support Some of the related products include: -Intel(R) Thread Checker is designed to help you create threaded applications more quickly by detecting thread safety issues in programs that use Win32*, Win64*, POSIX* and OpenMP* threads. Use it to identify source locations where shared memory or synchronization conflicts could cause consistency or deadlock are shown. ( http://www.intel.com/cd/software/products/asmo-na/eng/291669.htm ) - VTune(TM) Performance Analyzer enables you to evaluate how your application is utilizing the CPU and helps you determine if there are modifications you can make to improve your application's performance. ( http://www.intel.com/cd/software/products/asmo-na/eng/303059.htm ) - Intel(R) Compilers are an important part of making software run at top speeds with full support for the latest Pentium(R) and Itanium(R) processors. ( http://www.intel.com/cd/software/products/asmo-na/eng/278607.htm ) - Intel(R) Cluster Tools can help developers create, analyze and optimize high-performance applications on clusters of Intel(R) processor-based systems. ( http://www.intel.com/cd/software/products/asmo-na/eng/307698.htm ) - Intel(R) Performance Library Suite provides a set of routines optimized for various Intel processors. ( http://www.intel.com/cd/software/products/asmo-na/eng/302946.htm ) - Intel(R) Software College provides training for developers on leading-edge software development technologies. Training consists of online and instructor-led courses covering all Intel architectures, platforms, tools, and technologies. ( http://www.intel.com/software/college ) Disclaimer and Legal Information -------------------------------- The information in this document is subject to change without notice and Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. This document and the software described in it are furnished under license and may only be used or copied in accordance with the terms of the license. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. The information in this document is provided in connection with Intel products and should not be construed as a commitment by Intel Corporation. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The software described in this document may contain software defects which may cause the product to deviate from published specifications. Current characterized software defects are available on request. Intel, the Intel logo, Intel SpeedStep, Intel NetBurst, Intel NetStructure, MMX, i386, i486, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2,Celeron, Intel Centrino, Intel Xeon, Intel XScale, Itanium, Pentium, Pentium II Xeon, Pentium III Xeon, Pentium M, and VTune are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. * Other names and brands may be claimed as the property of others. Copyright(C) Intel Corporation 2007.