Intel Software Network articles feed http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-kb/technical-notes/ en-us Intel® Thread Checker for Linux* - General Installation Information

Page Contents:


What software must already be installed?
Before installing Intel® Thread Checker onto Microsoft Windows*, you must have the VTune™ Performance Analyzer v7.2 already installed, as Intel® Thread Checker is a plug-in to the VTune™ environment. Visit the Intel® Threading Tools Web site to obtain VTune Performance Analyzer and/or Intel Thread Checker.

On Microsoft Windows systems, you must also have the following already installed:

  • Microsoft Visual* C++ v6.0, or higher
  • Intel® Compilers are required for source instrumentation or OpenMP* analysis.
  • Microsoft* Internet Explorer v6.0, or higher
  • Adobe* Reader*

To use the Linux* Remote Data Collector (Remote Agent), you must also install Intel Thread Checker on a Microsoft Windows system.


Installing a New Version Over an Already Installed Version
To install a new version of Intel Thread Checker, you must first uninstall the currently installed version.

Note: Before removing the current version from Windows, you might want to save your projects using File » Pack and Go menu in the VTune environment.

To remove the currently installed version from Windows*, go to Start » Control Panel » Add or Remove Programs » Intel® Thread Checker.

To remove the currently installed version from Linux, run uninstall32.sh or uninstall64.sh, which is typically found in the /opt/intel/itt directory.


General Installation Tips for Linux*

  • To use the Linux Remote Data Collector (Remote Agent), you must also install Intel Thread Checker on a Microsoft Windows system.
  • The Remote Data Collector (RDC) .tar file for Linux is included with the Windows* installation package.
  • If you use ftp* to transfer the RDC .tar file to a Linux system, be sure to use a binary transfer.
  • If you are also using the Intel Compilers on your Linux system, you should install Intel Compilers before installing Intel Thread Checker.
    • If you update your Intel Compilers after installing Thread Checker, re-run the Thread Checker install script after updating the Intel Compilers.
    • Installation includes a script tcvars.sh (and tcvars.csh), typically in the /opt/intel/itt/tcheck/bin/32 or /opt/intel/itt/tcheck/bin/64 directory. Use the source tcvars.sh command to setup the shell environment for source instrumentation with the Intel® Compiler.
    • After installation, see the file tcheckFAQ.htm, typically found in the /opt/intel/itt directory, for important overview and usage information.
    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-linux-general-installation-information Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-linux-general-installation-information#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-linux-general-installation-information Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Linux* - Tips and Techniques

    Page Contents:


    I don't have source code. Can I use Intel® Thread Checker?
    Yes. For example: You are using an executable file from another vendor, so you don't have source code to it. But you are interested in diagnostics about a library (.dll or .so file) that is loaded by the vendor's executable file. You may not even have source code for the library that gets loaded. You can still use Thread Checker to see if any threading diagnostics are detected.Of course, if you really want to correct threading issues, you'll need source code.


    Collecting Thread Checker Diagnostics Outside of the VTune™ Environment
    To collect diagnostics outside of the VTune™ environment, follow this process:
    1. Compile your software using an Intel® Compiler and the /Qtcheck (on Microsoft Windows*) or -tcheck (on Linux*) switch. This option enables source instrumentation.

    2. Start your software as usual from the Windows*, DOS* or Linux* environment. For example, use Windows Explorer* to browse to your executable file and double-click on that file name.

    3. Run your software until it terminates normally. Don't forget to reduce your workload. Also because your software is instrumented, expect that it will run slower than usual.

    4. Exit (quit) your software, and a Thread Checker results ("*.thr") file is written to the working folder. If you are running on a Linux* system, transfer the .thr results file back to a Microsoft Windows* system (with Thread Checker installed) for viewing.

    5. To view the results file with Windows* Explorer, simply double-click the file. Alternatively you can start the VTune environment and open it with the File » Open File ... (NOT Open Project...) dialog. Important: Don't forget to set the file type to *.thr when using this dialog.
    Keep in mind that when collecting data outside of the VTune environment, only software that has been source instrumented will be analyzed by Thread Checker. Therefore, threading errors in the not instrumented softwa re may be missed. To ensure that all run-time code is instrumented, you must run from within the VTune environment or Microsoft .NET* Developer Environment.

    Note: Many third-party libraries, such as MFC* (Microsoft Foundation Class*) libraries, create and use threads. Therefore, software that uses MFC should always be run from within the VTune environment or Microsoft .NET* Developer Environment


    Analyze Multiple Processes or Executables
    Intel® Thread Checker only supports one process (executable) when run from within either the VTune™ environment or Microsoft .NET* Developer Environment. Furthermore, Thread Checker only supports finding diagnostics within one process; that is it will not produce diagnostics for synchronization objects shared between processes. However if your software launches another process, Thread Checker can still be used to find threading diagnostics within either process. To use Thread Checker for either process, use source instrumentation and run your software outside of the VTune™ environment.
    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-linux-tips-and-techniques Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-linux-tips-and-techniques#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-linux-tips-and-techniques Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker - Tips for Analyzing Long Diagnostic Lists

    This document provides the best known method for dealing with long diagnostic lists in Intel® Thread Checker.

    iconTips for Analyzing Long Diagnostic Lists [BKM.PDF]
    Size: 2586113 bytes
    Date: 03/14/03 02:38 PM

    Note: PDF Files require Adobe Acrobat* Reader†



    † This link will take you off of the Intel Web site. Intel does not control the content of the destination Web Site.

    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-tips-for-analyzing-long-diagnostic-lists Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-tips-for-analyzing-long-diagnostic-lists#comments http://software.intel.com/en-us/articles/intel-thread-checker-tips-for-analyzing-long-diagnostic-lists Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker - Threading Methodology [PDF]

    This document introduces threading concepts and provides a methodology for threading serial applications and for tuning threaded applications for performance using the Intel® Threading Tools.

    icon Threading Methodology: Practices & Principles [PDF]
    File Name: methodology.pdf
    Size: 1,684,645 bytes
    Date: 10/30/04

    Note: PDF Files require Adobe Acrobat* Reader†



    † This link will take you off of the Intel Web site. Intel does not control the content of the destination Web Site.

    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-threading-methodology-pdf Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-threading-methodology-pdf#comments http://software.intel.com/en-us/articles/intel-thread-checker-threading-methodology-pdf Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Windows* - Product Overview

    Intel® Thread Checker is a tool that locates software threading bugs, such as data races, stalls, and deadlocks. Thread Checker monitors your software's execution to detect hard-to-find and impossible-to-find intermittent errors whether or not they actually occurred during execution.

    Thread Checker uses instrumentation, which occurs automatically at run-time within the VTune environment or Microsoft .NET* Developer Environment, or can be performed beforehand with the Intel® C++ or Fortran Compilers.

    When your software has finished executing, a diagnostic list of potential threading errors will be displayed. You can drill down to the line of source code where each diagnostics occurred, look at the call stack, and review variable definitions and context.

    For more information on this product, including how to purchase or get a free evaluation copy, please visit the Intel® Threading Tools web site.

    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-product-overview Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-product-overview#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-product-overview Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Windows* - Preparing Your Software: Building or Making Source Code

    Page Contents:


    Tips on Preparing Microsoft Windows* Code for Intel® Thread Checker
    The following are general tips for preparing Windows* source code for Intel® Thread Checker. Build (make) your source with the following switches:

    • Be sure to build thread-safe by compiling with the /MD, /MDd, /MT or /MTd switch. This will use the thread-safe run-time libraries.

      Note: The default for Microsoft* and Intel® Compilers is the /ML or /MLd switch and this does not use thread-safe libraries.

    • Generate symbols by compiling with the /Zi, /ZI or /Z7 switches and link with the /DEBUG switch. This will enable Thread Checker to specify source code information (file name and line number) with its diagnostics.

    • Compile without optimization using the /Od switch. Just like when using a debugger, this will enable Thread Checker source code information (especially line numbers) to be accurate. Moreover, turning on compiler optimizations is usually not beneficial for code run under Intel Thread Checker.

    • Executable software must be built so that it contains a relocation section that allows for relocation in memory. Relocation is required for instrumentation. Most dynamic-link library (.dll) files can be relocated by default; however by default, most executable (.exe) files cannot be relocated. So always link with the /FIXED:NO switch to allow for relocation.

      Tip: Instead of changing your project's settings, set the (system) environment variable LINK to the value /FIXED:NO and re-link your code to add a relocation section.

    • To reduce executable (.dll or .exe) code size, link with the /INCREMENTAL:NO switch.

    Intel® Thread Checker Run-Time Warnings for Microsoft Windows* Applications
    If you get the warning "modules were created without base relocations" when you run Intel® Thread Checker activity in the VTune™ environment or Microsoft .NET* Development Environment, your code probably doesn't contain a relocation section. Link with the /FIXED:NO switch to add a relocation section.

    I don't have source code. Can I use Intel® Thread Checker?
    Yes -- But on Microsoft Windows*, do not expect to get any threading diagnostics for the application (.exe) file itself b ecause typically on Windows the executable does not have a relocation section.

    An example of using Thread Checker without source code might be if you are using an application file from another vendor, so you don't have source code for the for the application. But you are interested in diagnostics about a dynamic or shared library file that is loaded by the vendor's .application. You may not even have source code for the library that gets loaded. You can still use Thread Checker to see if any threading diagnostics are detected. Of course, if you really want to correct threading issues, you'll need source code.

    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-preparing-your-software-building-or-making-source-code Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-preparing-your-software-building-or-making-source-code#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-preparing-your-software-building-or-making-source-code Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Windows* - Execution Speed and Memory Usage

    Page Contents:


    Why does my software run so slow and/or use so much memory when run with Intel® Thread Checker?
    Intel® Thread Checker uses dynamic analysis as your threading software executes. As your software runs, Thread Checker uses instrumentation to monitor each thread, including the threading APIs used and memory accesses. Therefore Thread Checker uses more memory due to the instrumentation and significantly slows down the execution of any software.

    For this reason, it is critical to reduce the workload of your software before running it under Thread Checker. Reducing the workload may speed up analysis of the software and may reduce the memory used.

    About Workload Reduction: What does workload reduction mean?
    This is a reduction in the amount of work your program performs. It might include reducing the amount of data your program processes and/or reducing the amount of processing your program performs on each piece of data.

    Some examples of work-load reduction include:

    • Processing a 32x24 pixel image instead of a 1920x1440 pixel image. If there is a threading error within the loops that process the image, it does not provide you with any more information to find the same error thousands or millions of times. Finding a threading error a few (tens or hundreds) times is sufficient and makes you more productive.

    • Minimize the number of times you process each piece of data by reducing the loop iterations. Your software does not need a lot of accuracy when run under Intel® Thread Checker. After all, the goal is to find threading errors and not to get accurate results.

    • Minimize the update rates and/or length. Try using only one second of video, or reduce the update rate of the display to once per second instead of thirty or more updates a second.

    About Workload Reduction: What kind of workload reduction should I use?
    You should use as much workload reduction as possible while still being sure that you're executing the code that you want checked. Intel® Thread Checker uses dynamic analysis when executing your software. If section of your code is not executed, Thread Checker cannot give you diagnostics about the not-executed code. Where possible, you should try using multip le short runs over different code paths.


    Reducing Memory Usage
    Some general tips for reducing memory usage:

    • Reduce the size of the data-set that your software reads or writes, so that Intel® Thread Checker doesn't need to track as many memory accesses.

    • Disable Allocated memory guard padding by setting it to 0 (zero). In the VTune™ environment, this can be set via the Configure » Modify Intel® Thread Checker Collector menu item and the Analysis tab.

    • Make sure you are using the instrumentation level of All Functions instead of Full Image. In the VTune environment, this can be set via the Configure » Modify Intel® Thread Checker Collector menu item and the Module Instrumentation tab.

    • On Microsoft Windows*, link your software with the /INCREMENTAL:NO switch.
    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-execution-speed-and-memory-usage Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-execution-speed-and-memory-usage#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-execution-speed-and-memory-usage Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Windows* - Features List

    Features

    Patented advanced error detection engine:
    • Detects hidden potential errors, mapping them to the source-code line, call stack, and memory reference
    • Displays warnings for effective diagnosis, highlighting the most potentially severe errors
    • Tracks the error down to the specific variable in your source code using source instrumentation
    • Mitigates the risk of adding threads and enables hands-on learning about threading principles

    Patented advanced error detection engine:

    • Detects hidden potential errors, mapping them to the source-code line, call stack, and memory reference
    • Displays warnings for effective diagnosis, highlighting the most potentially severe errors
    • Tracks the error down to the specific variable in your source code using source instrumentation
    • Mitigates the risk of adding threads and enables hands-on learning about threading principles

    Works on standard debug builds:

    • Does not require your application to be recompiled

    Calibration run:

    • Recommends which modules to instrument based on usage, decreasing instrumentation time

    Patented OpenMP* analysis:

    • Enables rapid prototyping by determining the impact that threading will have atspecific points in your application

    Real-time verbose output and status query:

    • Start viewing detailed diagnostic information as soon as a potential error is uncovered, while Intel® Thread Checker continues to check the rest of the application.

    Improved existing features in the 3.1 release include the following:

    • 32-bit and 64-bit support for Windows Vista*
    • Support for Intel® VTune™ Performance Analyzer 9.0 for Windows*
    • Support for the latest Intel® multi-core processors, including
    • Intel® Core™ 2 Duo, and
    • Intel® Core™ 2 Quad processors
    • Performance optimizations by descriptor-based static binary instrumentation which, reduces the instrumented image size and decreases runtime overhead.

    Product Brief

    Intel® Thread Checker 3.1 for Windows* is instrumental at every phase of the application development cycle.

    • In the design phase, it helps you decide where and how to add threading in your application.
    • As you implement threading into your application, it can detect hard-to-find threading bugs like data races and deadlocks.
    • You can also ensure code quality by integrating it into your automated Quality Assurance/ test process.

    Compatibility

    Intel Thread Checker 3.1 for Windows is compatible with today's in dustry-standard development tools:

    • Microsoft Visual Studio* .NET
    • Microsoft Visual C++* .NET development environment Compiler 2005, 2003, 2002 Editions or Visual C++ 6.0
    • Intel® Fortran and C++ Compilers
    • Windows threads and POSIX* threads
    • Support for OpenMP*
    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-features-list Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-features-list#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-features-list Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Windows* - Compiler settings for Windows* OpenMP* applications when using Thread Checker

    Recommended Intel® Compiler Settings for Windows* OpenMP* Applications When Using the Intel® Thread Checker

    Get the best results from Intel® Thread Checker by using the following command to compile your Windows* OpenMP* applications:

    icl file.c /Qopenmp /MD [/Qtcheck] /Od /Zi /link /fixed:no
    Switch Purpose
    /Qopenmp
    (required)    		 Tells the compiler to process the OpenMP* pragmas.
    /MD
    (highly recommended)

    Specifies to use the dynamic multi-threaded version of the C runtime library ( msvcrt80.dll).

    Specifies to use the dynamic version of the OpenMP* runtime library. ( libguide40.dll or libiomp5md.dll)

    Note:

    • /MT uses the static version of the Intel runtime libraries for OpenMP* applications ( libguide.lib or libiomp5mt.lib). Intel® Thread Checker reports false positives if you use the static version of the OpenMP* runtime libraries.
    • /MT specifies to use the static multi-threaded C runtime library ( libcmt.lib) that reduces the information available for the analysis engine. This may cause Intel® Thread Checker to miss statically linked libc calls of standard libraries. However, Intel® Thread Checker should still catch the underlying system APIs used to implement the libc capabilities.
    /Qtcheck
    (optional)    		 Enables thread count independent (TCI) analysis mode instead of thread count dependent (TCD) analysis mode on OpenMP* applications.
    /Od
    (recommended)

    Allows Intel® Thread Checker to more easily associate errors to source lines.

    Intel® Thread Checker can also analyze optimized binaries, but it is difficult for Intel® Thread Checker to pinpoint the source code location causing a problem in optimized assembly that does not have specific source lines.
    /Zi
    (highly recommended)

    Creates symbols for the binary. Intel® Thread Checker uses the symbols to associate addresses to source lines.

    Note: For binaries compiled without /Zi (no symbols), Intel® Thread Checker instruments using API Imports. Intel® Thread Checker cannot find all threading errors within a binary that is instrumented with API Imports. The Default of API Imports instrumentation on a particular file can be changed to Full Image via advanced settings in Intel® Thread Checker, but the result is that you will not see the source code that caused the problem, only the assembly.
    /link /fixed:no
    (required)

    Required to allow Intel® Thread Checker to relocate functions within your binary.

    Related Documentation

    • Intel® Thread Checker Help » About OpenMP*
    • Using Intel® Thread Checker on OpenMP* Applications Compiled with the Microsoft* Compiler at [url…]

    Confirmed On:

    • Microsoft* Visual Studio* 2005 development system
    • Intel® C/C++ Compiler 10.1 for Windows*
    • Intel® Fortran Compiler 10.1 for Windows*
    • Intel® Thread Checker 3.1 for Windows*

    Operating System:

    Windows* XP Professional x64 Edition, Windows Server* 2003 Standard x64 Edition, Windows Server* 2003 Enterprise x64 Edition, Longhorn Beta 1, Windows Vista* Beta 1, Windows* Storage Server, Windows Vista* 64, Windows Vista* Starter, 32-bit version, Windows Vista* Home Basic, 32-bit version, Windows Vista* Home Premium, 32-bit version, Windows Vista* Business, 32-bit version, Windows Vista* Enterprise, 32-bit version, Windows Vista* Ultimate, 32-bit version, Windows Vista* RC2, Windows Vista* Home Basic, 64-bit version, Windows Vista* Home Premium, 64-bit version, Windows Vista* Business, 64-bit version, Windows Vista* Enterprise, 64-bit version, Windows Vista* Ultimate, 64-bit version, Windows Vista*, Windows Vista* 32, Windows Server* 2003 for Itanium-based Systems, Windows* XP Starter Edition, Windows* Compute Cluster Server 2003, Windows* 2000, Windows* XP 64-Bit Edition, Windows* XP Professional, Windows* XP Home Edition, Windows* XP Tablet PC Edition, Windows Server* 2003, Windows* XP Media Center Edition, Windows* 2000 Server, Windows* 2000 Advanced Server, Windows Server* 2003 Standard Edition, Windows* XP 64-Bit Edition Version 2003
    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-compiler-settings-for-windows-openmp-applications-when-using-thread-checker Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-compiler-settings-for-windows-openmp-applications-when-using-thread-checker#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-compiler-settings-for-windows-openmp-applications-when-using-thread-checker Software Products General Intel® Thread Checker for Windows* Knowledge Base     Intel® Thread Checker for Windows* - False positives generated in crtdll.c

    This is a known technical limitation in the current version of Intel® Thread Checker for Windows*.

    These are related to DllMain and loader lock. DllMain is serialized internally by Microsoft Windows* using the loader lock. However, Intel® Thread Checker is not able to model the loader lock because it is invisible to the application

    Whenever a thread is created or terminated, the DllMain is called and these errors are generated. These errors are not generated at startup phase.

    We recommend using the filtering functionality to suppress these diagnostics.

    Operating System:

    Windows* XP Professional x64 Edition, Windows Server* 2003 Standard x64 Edition, Windows Server* 2003 Enterprise x64 Edition, Longhorn Beta 1, Windows Vista* Beta 1, Windows* Storage Server, Windows Vista* 64, Windows Vista* Starter, 32-bit version, Windows Vista* Home Basic, 32-bit version, Windows Vista* Home Premium, 32-bit version, Windows Vista* Business, 32-bit version, Windows Vista* Enterprise, 32-bit version, Windows Vista* Ultimate, 32-bit version, Windows Vista* RC2, Windows Vista* Home Basic, 64-bit version, Windows Vista* Home Premium, 64-bit version, Windows Vista* Business, 64-bit version, Windows Vista* Enterprise, 64-bit version, Windows Vista* Ultimate, 64-bit version, Windows Vista*, Windows Vista* 32, Windows Server* 2003 for Itanium-based Systems, Windows* XP Starter Edition, Windows* Compute Cluster Server 2003, Windows* XP 64-Bit Edition, Windows* XP Professional, Windows* XP Home Edition, Windows* XP Tablet PC Edition, Windows Server* 2003, Windows* XP Media Center Edition, Windows Server* 2003 Standard Edition, Windows* XP 64-Bit Edition Version 2003
    ]]>     http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-false-positives-generated-in-crtdllc Fri, 19 Sep 2008 00:00:00 -0700 http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-false-positives-generated-in-crtdllc#comments http://software.intel.com/en-us/articles/intel-thread-checker-for-windows-false-positives-generated-in-crtdllc Software Products General Intel® Thread Checker for Windows* Knowledge Base