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“.)
Parametrierung
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“.)
Parametrierung
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.
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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.
Parametrierung
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“.)
Parametrierung
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.
Parametrierung
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.
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
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“.)
Parametrierung
Parameter
Name |
Verfügbar wenn |
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“.)
Parametrierung
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“.)
Parametrierung
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.
Parametrierung
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. |