Page Contents:

• Intel® Thread Profiler for Windows* or Pthreads* API
  • General Tips on Preparing Source Code
  • Run-time Warnings
  • API: Can I use it without source code?
  
  
• Intel Thread Profiler for OpenMP*
  • General Tips on Preparing Source Code
  • Run-time Warnings
  • API: Can I use it without source code?

• For Windows*: Be sure to build thread-safe by compiling with the /MD, /MDd, /MT or /MTd switches to use the multi-threaded libraries.
  Note: On Windows*, the default for Microsoft and Intel® Compilers is the /ML or /MLd switch and this does not use thread-safe libraries.

• Be sure to provide symbols. For Windows* generate symbols by compiling with the /Zi, /ZI or /Z7 switches and link with the /DEBUG switch. For Linux* generate symbols with the -g switch. Symbols will enable Intel Thread Profiler to specify source code information (file name and line number) with its results.
  Note: Symbols can be generated with a "release" (optimized) build.

• You can use either an optimized "Release" or a non-optimized "Debug" build. A Debug build for Windows* will disable optimization with the /Od switch, and on Linux* a debug build will use the -O0 switch. Of course, just like when using a debugger, the Intel Thread Profiler Results (especially line numbers) may not be accurate, if you use an optimized build.

• On Windows*, executable software must be built so that it contains a relocation section which allows for relocation in memory and 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.
  Windows* 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.

• You must compile with Intel® Compilers to get support for OpenMP.
• On Windows*, be sure to build thread-safe by compiling with the /MD, /MDd, /MT or /MTd switches to use the multi-threaded libraries.
  Note: On Windows*, the default for Intel® Compilers is the /ML or /MLd switch and this does not use thread-safe libraries.
• Do not compile with the /Qtcheck or -tcheck switch.
• Symbols and line numbers are not required.
• Use an optimized "Release" build.
• When running in the VTune™ environment or Microsoft .NET* Developer Environment, compile with one of Windows* /Qopenmp or Linux* -openmp* switch or one of Windows* /Qopenmp_profile or Linux* -openmp switch, but not both. That is don't build with both /Qopenmp and /Qopenmp_profiler nor both of -openmp and -openmp_profile.
• To run from the Windows* shell or DOS* command-prompt, compile with the /Qopenmp_profile switch. To run from the Linux* shell, build with -openmp_profile.

This applies to:

Intel® Thread Profiler for Windows*