Port DEBUGGER - SSH¶

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
SSH-Host				string	Adresse des SSH-Hosts.
SSH-Port		22		int	Port, über den SSH am Host erreichbar ist.
SSH-Benutzername				string	Benutzername, mit dem sich auf dem SSH-Host angemeldet werden soll.
Authentisierungsmethode		Private Schlüsseldatei	[Private Schlüsseldatei, Passwort]	string	Methode, mit welcher sich beim Remote-System angemeldet wird.
SSH-Schlüsselpfad	Authentisierungsmethode: ‚Private Schlüsseldatei‘			string	Pfad zum privaten SSH-Schlüssel für hostbasierte Authentifizierung. Pfad kann absolut oder relativ zum Basispfad des Toolhosts angegeben werden.
SSH-Passwort	Authentisierungsmethode: ‚Passwort‘			string	Passwort des angegebenen Benutzers. Achtung: Das Passwort wird unverschlüsselt in der TBC gespeichert!
GDB-Pfad		‚gdb‘		string	Pfad zum GDB.
Argumentliste		‚[]‘		string	Argumente für den Aufruf von GDB in Python-Listen-Syntax.
Zeitüberschreitung		2		int	Timeout für GDB-Befehle in Sekunden.
GDB-Ausgaben protokollieren		☐		bool	Alle Ausgaben von GDB ins Meldungsfenster schreiben.
Programmdatei laden als		Programm- und Symboldatei	[Keine, Programmdatei, Symboldatei, Programm- und Symboldatei]	string	Wie die Programmdatei beim Verbinden des Ports im GDB geladen werden soll.
Programmdatei				string	Absoluter Pfad zu der zu ladenden Programmdatei auf dem Toolhost.

Jobs 🛈¶

Attach¶

Baut eine Verbindung zu einem Zielprozess auf. Der Zielprozess wird angehalten. (Entspricht GDB-Befehl „attach“.)

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
target				string	Prozess-Id

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
attachInfo				object	Informationen zum Attach (result, payloadDict)

ClearBreakpoints¶

Entfernt alle Breakpoints. (Entspricht GDB-Befehl „delete“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
breakInfo				object	Informationen zum Break-Call (result, payloadDict)

Cmd¶

Führt einen benutzerdefinierten GDB/MI-Befehl aus.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
command				string	GDB/MI-Befehl

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Rückgabewert des Befehls (result, payloadDict)

Continue¶

Führt die Applikation fort. (Entspricht GDB-Befehl „continue“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
continueInfo				object	Informationen zum Continue (result, payloadDict)

Detach¶

Trennt die Verbindung zu dem Zielprozess. (Entspricht GDB-Befehl „detach“.)

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
target				string	Prozess-Id

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
detachInfo				object	Informationen zum Detach (result, payloadDict)

GetBreakpointList¶

Listet alle vorhandenen Breakpoints auf. (Entspricht GDB-Befehl „info break“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
breakpointList				object	Liste aller Breakpoints (result, payloadDict)

GetCallstack¶

Gibt den aktuellen Callstack zurück. (Entspricht GDB-Befehl „backtrace“ bzw. „where“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
callstack				object	Informationen zum Callstack (result, payloadDict)

GetStatus¶

Gibt den aktuellen Status des Debuggers zurück.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
immediate		False	[False, True]	bool	Ob der letzte Status sofort, ohne Aktualisieren, ausgegeben werden soll.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
status				object	Status des Debuggers (result, payloadDict)

Interrupt¶

Unterbricht die Ausführung der Applikation. (Entspricht GDB-Befehl „interrupt“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
interruptInfo				object	Informationen zum Interrupt-Call (result, payloadDict)

IsConnected¶

Gibt True zurück, falls der zuletzt ausgeführte TargetConnect-Job erfolgreich war. Andernfalls, oder wenn ein TargetDisconnect ausgeführt wurde, False.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result			[False, True]	bool

ReadVariable¶

Liest den Wert einer Variable. Sollen mehrere Variablen gelesen und/oder geschrieben werden, ist zuvor ein Interrupt und anschließend ein Continue oft günstiger.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
displayFormat		‚natural‘	[‚binary‘, ‚decimal‘, ‚hexadecimal‘, ‚octal‘, ‚natural‘, ‚zero-hexadecimal‘]	string	Ausgabeformat der Variable (Default: natural)
variable				string	Name der zu lesenden Variable

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
variableInfo				object	Informationen zur Variable.

RemoveBreakpoint¶

Entfernt einen Breakpoint an der angegebenen Stelle. (Entspricht GDB-Befehl „delete“.)

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
breakpoint				object	Position oder Nummer des zu entfernenden Breakpoints
isNumber		False	[False, True]	bool	Gibt an, ob der Parameter „breakpoint“ eine Breakpoint-Position oder -Nummer ist.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
breakInfo				object	Informationen zum Break-Call (result, payloadDict)

Run¶

Startet die Ausführung der Applikation. (Entspricht GDB-Befehl „run“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
runInfo				object	Informationen zum Run-Call (result, payloadDict)

SetBreakpoint¶

Setzt einen Breakpoint an der angegebenen Stelle. (Entspricht GDB-Befehl „break“.)

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
location				object	Position des Breakpoints. Funktionsname, Zeilennummer oder Adresse.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
breakInfo				object	Informationen zum Break-Call (result, payloadDict)

StepInto¶

Einzelner Schritt, betritt die Subroutine. (Entspricht GDB-Befehl „step“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
stepInfo				object	Informationen zum Step-Call (result, payloadDict)

StepOut¶

Einzelner Schritt, verlässt die Subroutine. (Entspricht GDB-Befehl „finish“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
stepInfo				object	Informationen zum Step-Call (result, payloadDict)

StepOver¶

Einzelner Schritt, überspringt die Subroutine. (Entspricht GDB-Befehl „next“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
stepInfo				object	Informationen zum Step-Call (result, payloadDict)

TargetConnect¶

Baut eine Verbindung mit den Zielsystem auf. (Entspricht GDB-Befehl „target“.)

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
conntype			string	Verbindungsart
parameters			string	Verbindungsparameter
setTargetAsync	True	[False, True]	bool	Ermöglicht das Senden von Befehlen an das Target, während das zu debuggende Programm ausgeführt wird. Standardmäßig True.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
connectInfo				object	Informationen zum Connect (result, payloadDict)

TargetDisconnect¶

Trennt die Verbindung mit dem Zielsystem. (Entspricht GDB-Befehl „disconnect“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
disconnectInfo				object	Informationen zum Disconnect (result, payloadDict)

Version¶

Gibt ein Dictionary zurück aus dem Informationen zu Version und Lizenz bezogen werden können. (Entspricht GDB-Befehl „show version“.)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
versionInfo				object	Informationen zum Version-Call (result, payloadDict)

WriteVariable¶

Schreibt den Wert einer Variable. Sollen mehrere Variablen gelesen und/oder geschrieben werden, ist zuvor ein Interrupt und anschließend ein Continue oft günstiger.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
value				string	Neuer Wert der Variable. Bei Enums werden nur numerische Werte unterstützt.
variable				string	Name der zu schreibenden Variable

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
variableInfo				object	Informationen zur Variable.