Getting Started Guide

  • XX.XX
  • 04/09/2020
  • Public Content

Get Started with Debugging with Intel® System Studio
for Windows* OS

This document provides startup and usage information for the GNU* Project Debugger (GDB)
shipped with Intel® System Studio (Linux* and Android* targets only)
.
For Windows* OS host, only remote debugging of Linux* OS targets is supported.
Refer to the Intel® System Studio release notes for an introduction to the entire suite.
In case you need assistance installing or running this product, please visit our Get Help page at http://software.intel.com/en-us/support for support options.
For discussions, user-to-user help and general debugging information, please also join our online community at http://software.intel.com/en-us/forums/debug-solutions.

Debugging on a Remote Target System with GDB

GDB comes with a remote debug agent called gdbserver. This debug agent can be installed on the debug target to launch a debuggee and attach to it remotely from the development host. This is used when the program needs to be run on a target host that is different from the host used for development, particularly when the target has a limited amount of resources (either CPU and/or memory).
To start a debugging session, follow the steps below:
  1. Depending on the target system, there are different gdbserver executables provided. Select an appropriate one under
    <install-dir>\debugger_<version>\gdb\targets\<target-arch>\<target>\bin\gdbserver
    , where:
    • <install-dir>
      is the installation directory. The default one is
      C:\IntelSWTools\<suitename>
      .
    • <target-arch>
      defines the architecture of the target system. Possible values are
      ia32
      ,
      intel64
      , and
      Quark
      .
    • <target>
      is the target system type.
    Not all combinations of host/target systems are supported. Refer to the Intel ® Parallel Studio XE release notes for more information.
  2. Ensure that the application to debug is launched.
  3. Start the gdbserver on the target system by either loading an application to debug or attaching to it:
    • Load an application called
      my_application
      by executing the command below:
    • Attach to a running application with PID
      my_pid
      by executing the command below:
    The expected output for both steps is below:
    Process program created; pid = ... Listening on port 2000
  4. Start GDB on the host.
    Do not use
    gdb-ia.exe
    directly. Use
    gdb-ia.bat
    instead.
  5. Сonnect to the gdbserver on the target system called
    my_target
    and debug the remote application
    my_remote_application
    : The port number must match the one specified during launch of gdbserver on the target called
    my_target
    .
    Expected output:
    Remote debugging using my_target:2000
    Make sure the connection is not blocked by a firewall.
    Alternatively, you can use the multi-mode, which enables reusing the gdbserver across different debug sessions (it does not terminate):
    1. Start gdbserver on the target system in multi-mode: Expected output:
      localhost:2000 Listening on port
    2. Start GDB on host via
      gdb-ia.bat
      and connect to the target with the following command: Expected output:
      my_target:2000 Remote
For more information, refer to the GDB User Guide.

Training and Documentation

Document
Description
Only available for Linux*/Android* target!
Contains descriptions of the GNU* Debugger (GDB) functions and interfaces including Intel-extended features
This document contains the most up-to-date information about the product, including:
  • Overview information (including new features and product contents)
  • System requirements (hardware and software requirements for installing and using the product)
  • Installation information
  • Known limitations
  • Technical support (links to contacts for reporting problems and getting support)
Intel® System Studio 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.
1

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reservered for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804