Intel® System Debugger User Guide

ID 648476
Date 06/13/2024
Confidential
Document Table of Contents

Intel(R) System Debugger - System Debug CLI User Guide

Contents

Quick Start (TL;DR)

The Intel(R) System Debug CLI is a Python*-based, scriptable command-line interface to the Intel(R) System Debugger - System Debug.

Launching

Launch isd_​shell from the Intel(R) System Debugger installation folder.

Then, you can use the intel_​sysdbg entry point to launch the program.

$ intel_sysdbg --help

For example, launch an Intel(R) System Debug instance and connect the Intel(R) System Debug CLI to it automatically by running the following command:

$ intel_sysdbg --launch_and_connect

If a TCA profile is available in the workspace, it will be used by default.

Alternatively, launch isd_​cli. The Intel(R) System Debug CLI module is imported as “sysdbg”. For example, the previous command can be executed as follows:

>>> sysdbg.launch_and_connect()

Scripting Mode

Launch or source isd_​env from the Intel(R) System Debugger installation folder and import the package in a Python* console. For example, connect the Intel(R) System Debug CLI to an Intel(R) System Debug instance running on local port 1534 with the following commands:

>>> import intel.sysdbg
>>> session = intel.sysdbg.connect(host="localhost", port="1534")
>>> session.status()
>>> session.halt()

In order to launch an Intel(R) System Debug instance and connect the Intel(R) System Debug CLI to it automatically, run the following commands:

>>> import intel.sysdbg
>>> session = intel.sysdbg.launch_and_connect()
>>> session.status()
>>> session.halt()

Connection Handling

Connection handling is completely managed by Target Connection Assistant (TCA). The most recently used TCA profile is stored in the workspace and automatically loaded on launch. To change the TCA profile, use the following commands:

>>> from intel import tcacli as tca
>>> tca.select_profile()

Indices and tables

Notices and Disclaimers

Intel technologies may require enabled hardware, software or service activation.

No product or component can be absolutely secure.

Your costs and results may vary.

(C) Intel Corporation. Intel, the Intel logo, and other Intel marks are trademarks of Intel Corporation or its subsidiaries. Other names and brands may be claimed as the property of others.

No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document. The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.

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.