.exdicmd (EXDI-Befehl)

Artikel
11/01/2024

Die EXDICMD sendet einen EXDI-Befehl (Extended Debugging Interface) mithilfe der aktiven EXDI-Debugverbindung an das Zielsystem. Weitere Informationen zu EXDI finden Sie unter Konfigurieren des EXDI-Debuggertransports.

exdicmd component|target parameters

Dieser Befehl übergibt die Parameter direkt an eine EXDI-Komponente. Weitere Informationen zu den gültigen Befehlen, die für Ihr Zielsystem verfügbar sind, finden Sie in der Dokumentation für Ihre EXDI-Komponente.

Nicht alle EXDI-Komponenten haben diese Funktion implementiert.

Parameter

Dies sind die gültigen Parameter für .exdicmd.

Parameter	Beschreibung
`target:*:<string>`	Übergeben Sie die `<string>` Funktion an die Zielentität für alle Prozessorkerne.
`target:<n>:<string>`	Übergeben Sie die `<string>` Funktion an die Zielentität für den Prozessorkern n (n-Dezimalzahl).
`component:*:<string>`	Führen Sie eine EXDI-Komponentenfunktion `<string>` auf allen Prozessorkernen aus.
`component:<n>:<string>`	Führen Sie eine EXDI-Komponentenfunktion `<string>` auf dem Prozessorkern n (n-Dezimalzahl) aus.
`help`	Grundlegende Hilfe anzeigen.

Ziel-Exdicmd-Verwendung

.exdicmd target:*:<string>

Die Verwendung des Zielparameters ermöglicht die Kommunikation zwischen Dem Windows-Debugger und dem EXDI COM-Server. Der Debugger zeigt das Befehlsergebnis an, wenn der Befehl eine Antwort zurück an das Debuggermodul zurückgibt.

Der .exdicmd-Zielparameter verwendet jeden Befehl, den der EXDI-COM-Server verarbeiten kann. Dies ermöglicht die Verwendung von Befehlen über das hinaus, was direkt in der EXDI-Schnittstelle unterstützt wird.

Exdicmd-Verwendung der Komponente

.exdicmd <component>:

Der Zweck für diesen Befehl besteht in erster Linie darin, EXDI COM-Serverfunktionen auszuführen/zu testen, um grundlegende Funktionen zu überprüfen. Es wird in der Regel weniger verwendet als die oben beschriebene Zielparameterverwendung.

Beachten Sie, dass es Befehle gibt, die intern vom EXDI-COM-Server ausgeführt werden können, ohne sie an die JTAG-Zielentität senden zu müssen. Beispielsweise ist es möglich, Telemetrie vom EXDI-COM-Server zu sammeln, um den korrekten Vorgang zu überprüfen.

Environment

Deskriptor	Wert
Modi	Nur Kernelmodus
Ziel	Nur Livedebugging
Plattformen	Alle

Weitere Informationen

Beispiel für die Verwendung von .exdicmd mit einem OpenOCD-Ziel, das die Syntax verwendet, .exdicmd target:0:<OpenOCD command> wird unten gezeigt.

0: kd> .exdicmd target:0:info network
Target command response: e1000.0: index=0,type=nic,model=e1000,macaddr=52:54:00:12:34:56
 \ net0: index=0,type=user,net=10.0.2.0,restrict=off
OK
exdiCmd: The function: 'info network' was completed.

0: kd> .exdicmd target:0:info registers system -v
Target command response: 
NumberOfRegisters: 9

     Name | Value            | Access code
  fs_base | 0000000000000000 | n/a    
  gs_base | fffff8047b907000 | n/a    
k_gs_base | 000000e7cbdbe000 | n/a    
      cr0 | 0000000080050033 | n/a    
      cr2 | fffff8048454de64 | n/a    
      cr3 | 00000000001ae000 | n/a    
      cr4 | 00000000000006f8 | n/a    
      cr8 | 0000000000000000 | n/a    
     efer | 0000000000000d01 | 0xc0000080

exdiCmd: The function: 'info registers system -v' was completed.

Wenn das Zielsystem den Befehl nicht verstehen kann und eine unbekannte Befehlsmeldung zurückgegeben wird.

0: kd> .exdicmd target:0:Foo
Target command response: unknown command: 'Foo'

OUTMASK

Wenn die Ausgabe nicht angezeigt wird, überprüfen Sie, ob das Ausgabeformat so festgelegt ist, dass ausführliche Ausgabe mithilfe von OUTMASK (Steuerelementausgabeformat) angezeigt wird.

Wenn der Debugger nicht im ausführlichen Modus gestartet wurde, kann die OUTMASKE mithilfe .outmask 7FFvon .outmask festgelegt werden.

Hinweise

Weitere Informationen zum Einrichten einer EXDI-Debuggerverbindung finden Sie unter Konfigurieren des EXDI-Debuggertransports.

Freigeben über