The Intel® Debugger Extension for the Intel® Xeon Phi™ coprocessor is a plug-in for Microsoft Visual Studio* which facilitates debugging applications that run on Intel® Xeon Phi™ coprocessors. The Intel Debugger Extension can debug offload-enabled applications which contain both host and coprocessor code. You can either execute a host application containing offload Intel® Xeon Phi™ coprocessor code or attach to a plain Intel® Xeon Phi™ coprocessor native application.

Intel® Debugger Extension for Intel® Xeon Phi™ Coprocessor

Prerequisites

Before using the Intel® Debugging Extension with Microsoft Visual Studio*, set the following additional environment variables on your host system:

Intel® Manycore Platform Software Stack (Intel® MPSS) 4.4 or higher:

AMPLXE_COI_DEBUG_SUPPORT=TRUE

MYO_WATCHDOG_MONITOR=-1

For other prerequisites, new debugger features, hardware and software requirements, and known issues refer to the release notes.

Loading and Executing an Offload Enabled Application for the Intel® Xeon Phi™ Coprocessor

  1. Start Microsoft Visual Studio*
  2. Open a project for the Intel® Xeon Phi™ coprocessor and select Debug > Start Debugging to start a debug session.

The scope of coprocessors and information displayed during the debug session (threads, breakpoints, etc.) depends on the use of the offload model. If the offload model is not used, no code is executed on the coprocessor.

For more information on debugging on the Intel® Xeon Phi™ Coprocessor, see also Debugging Intel® Xeon Phi™ Applications on Windows* Host.

Attaching to a Process on the Intel® Xeon Phi™ Coprocessor

This only applies to applications running natively on the Intel® Xeon Phi™ Coprocessor.

  1. Make sure the process to debug already runs on the coprocessor.
  2. Select Tools > Options ... to open the Options dialog box.
  3. Select Intel Compilers and Tools > Debugger > Extension for MIC.
  4. Enter the path for Host Binary Directory. This is the directory containing (a copy of) the binary that is to be debugged on the coprocessor.
  5. Enter the path for Host Source Directory. This is the root directory containing the application sources.
  6. Optionally, enter search paths to shared libraries for the coprocessor application into the solib-searchpath directories text field. The semantic is the same as for the GNU* GDB command set solibsearch-path <paths>.
  7. Select Debug > Attach to Process....
  8. Select the Intel® Debugger Extension, specify the coprocessor IP and debug port (16000 by default), and select the process to debug from the list.

For more information on debugging on the Intel® Xeon Phi™ Coprocessor, see also Debugging Intel® Xeon Phi™ Applications on Windows* Host.

Documentation and Resources

Document Description

Intel® Parallel Studio XE Composer Edition Fortran - Debug Solutions Release Notes

Intel® Parallel Studio XE Composer Edition C++ - Debug Solutions Release Notes

Release Notes for debugging with Intel® Parallel Studio XE.
Intel® Parallel Studio XE Intel® Parallel Studio XE product page. See this page for support and online documentation.

Notices and Disclaimers

No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.

Intel technologies' features and benefits depend on system configuration and may require enabled hardware, software or service activation. Performance varies depending on system configuration. No product or component can be absolutely secure. Check with your system manufacturer or retailer or learn more at [intel.com].

Intel disclaims all express and implied warranties, including without limitation, the implied warranties of merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from course of performance, course of dealing, or usage in trade.

This document contains information on products, services and/or processes in development. All information provided here is subject to change without notice. Contact your Intel representative to obtain the latest forecast, schedule, specifications and roadmaps.

The products and services described may contain defects or errors which may cause deviations from published specifications. Current characterized errata are available on request.

Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

*Other names and brands may be claimed as the property of others.

Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.

© Intel Corporation.

This software and the related documents are Intel copyrighted materials, and your use of them is governed by the express license under which they were provided to you (License). Unless the License provides otherwise, you may not use, modify, copy, publish, distribute, disclose or transmit this software or the related documents without Intel's prior written permission.

This software and the related documents are provided as is, with no express or implied warranties, other than those that are expressly stated in the License.

For more complete information about compiler optimizations, see our Optimization Notice.