Befehl "caccelstat"

Zweck

Berichtet Statistiken zu kohärenten Akzeleratoren für das gesamte System oder für jeden Akzelerator und Prozess.

Syntax

Systemweite zusammengefasste Statistiken

caccelstat -a [-t count] [-i interval]

Kontextstatistiken

caccelstat -c [-p pid -d device] [-t count] [-i interval] [-@ wparname]

Zusammengefasste Einheiten- oder AFU-Statistiken (Accelerator Function Unit, Akzeleratorfunktionseinheit)

caccelstat -d [device] [-t count] [-i interval] [-@ wparname]

Zusammengefasste Prozesskontextstatistiken

caccelstat -p [pid] [-t count] [-i interval] [-@ wparname]

Zusammengefasste Kontextstatistiken für Einheitenkernel

caccelstat -k [device] [-t count] [-i interval] [-@ wparname]

Beschreibung

Mit dem Befehl caccelstat können Sie kohärente Akzeleratoraktivitäten im System überwachen. Der Befehl kann zusammengefasste Statistiken für alle CAPI-fähigen (Coherent Accelerator Processor Interface) oder Statistiken für jeden einzelnen CAPI-fähigen Prozess anzeigen. Er kann auch Statistiken für jede einzelne AFU (Accelerator Function Unit) anzeigen. Eine AFU ist eine kohärente Akzeleratoreinheit, wie z. B. /dev/caccel0.

Systemweite zusammengefasste Statistiken

Der systemweite zusammengefasste Statistikbericht enthält die folgenden Informationen:

Anzahl der CAPI-fähigen Prozesse
Anzahl der Akzeleratoren im System
Anzahl der Benutzerkontexte
Anzahl der Kernelkontexte
Anzahl der Masterkontexte
Anzahl der Fehlseitenbedingungen
Anzahl der Segmenttabellenfehler (STAB)
Anzahl der AFU-Fehler
Anzahl der AFU-Ausnahmen
Anzahl der AFU-Signale
Anzahl der AFU-Blockierungen

Kontextstatistiken

Dieser Bericht enthält Kontextstatistiken; jeweils eine Zeile pro Kontext. Wenn die Prozess-ID (PID) und die Einheit nicht angegeben werden, werden alle registrierten Benutzerkontexte im System berichtet. Kernelkontexte werden ausgeschlossen. Wenn die PID oder die Einheit angegeben wird, werden Kontexte für diese PID bzw. diese Einheit berichtet. Wenn sowohl eine PID als auch eine Einheit angegeben werden, werden nur die Kontexte angezeigt, die zu der ausgewählten PID und der ausgewählten Einheit gehören.

Der Bericht enthält die folgenden Informationen:

State

Der Kontextstatus.

Dieses Feld kann die folgenden Werte enthalten:

S: Der Kontext ist ausgesetzt.
R: Der Kontext ist aktiv.
D: Die Kontextzuordnung wurde aufgehoben.
A: Der Kontext ist zugeordnet.
E: Der Kontext ist fehlerhaft.

Für einen Masterprozess wird M mit dem jeweiligen Status kombiniert. Wenn der Kontext des Masterprozesses beispielsweise aktiv ist, wird im Statusfeld MR angezeigt.

Hinweis: Der Ausführungsstatus (R) impliziert nicht, dass die AFU diesen Kontext ausführt. Er bedeutet, dass sie sich in keinem der anderen Status befindet.

pid

Die Prozess-ID. Diese Spalte wird übersprungen, wenn die PID in der Option angegeben ist.

pf

Die Anzahl der Fehlseitenbedingungen.

spf

Die Anzahl der STAB-Fehler.

pi

Die Anzahl der Einlagerungen.

err

Die Anzahl der Prozessfehler.

exc

Die Anzahl der Prozessausnahmen.

sig

Die Anzahl der Prozesssignale.

stalls

Die Anzahl der AFU-Blockierungen aufgrund von Ausnahmen.

aur

Der AUR-Wert (Accelerator Utilization Register) dieses Prozesses. Wenn AUR nicht unterstützt wird, wird in diesem Feld 0 angezeigt.

Gerät

Der Einheitenname. Diese Spalte wird übersprungen, wenn die Einheit in der Option angegeben ist.

AFU-Statistiken

Dieser Bericht enthält zusammengefasste Statistiken für eine AFU in allen Prozesskontexten. Wenn die Einheit nicht angegeben wird, werden Statistiken für alle AFUs im System berichtet. Dieser Bericht enthält die folgenden Spalten; jeweils eine Zeile pro Einheit:

nctx: Die Anzahl registrierter Prozesskontexte.
pf: Die Anzahl der Fehlseitenbedingungen.
spf: Die Anzahl der STAB-Fehler.
pi: Die Anzahl der Einlagerungen.
err: Die Anzahl der AFU-Fehler.
exc: Die Anzahl der AFU-Ausnahmen.
sig: Die Anzahl der AFU-Signale.
stalls: Die Anzahl der AFU-Blockierungen aufgrund voller Ausnahmewarteschlangen.
Gerät: Der Einheitenname. Diese Spalte wird übersprungen, wenn die Einheit in der Option angegeben ist.

Zusammengefasste Prozesskontextstatistiken

Dieser Bericht enthält zusammengefasste und prozessspezifische Kontextstatistiken für einen CAPI-fähigen Prozess. Die PID ist die AIX-Prozess-ID. Wenn die PID nicht angegeben wird, werden Statistiken für alle CAPI-fähigen Prozesse im System berichtet.

Dieser Bericht enthält die folgenden Spalten; jeweils eine pro Kontext:

pid: Die AIX-Prozess-ID. Diese Spalte wird übersprungen, wenn die Einheit in der Option angegeben ist.
nctx: Die Anzahl registrierter Prozesskontexte.
pf: Die Anzahl der Fehlseitenbedingungen.
spf: Die Anzahl der STAB-Fehler.
pi: Die Anzahl der Einlagerungen.
err: Die Anzahl der AFU-Fehler.
exc: Die Anzahl der AFU-Ausnahmen.
sig: Die Anzahl der AFU-Signale.
stalls: Die Anzahl der AFU-Blockierungen aufgrund voller Ausnahmewarteschlangen.
aur: Der AUR-Wert (Accelerator Utilization Register) für diesen Prozess. Wenn AUR nicht unterstützt wird, wird in diesem Feld 0 angezeigt.

Zusammengefasste Kontextstatistiken für Einheitenkernel

Dieser Bericht enthält zusammengefasste oder einheitenkernelspezifische Kontextstatistiken. Wenn keine Einheit angegeben wird, werden Statistiken für alle AFUs berichtet. Dieser Bericht enthält die folgenden Spalten; jeweils eine pro Einheit:

pf: Die Anzahl der Fehlseitenbedingungen.
spf: Die Anzahl der STAB-Fehler.
pi: Die Anzahl der Einlagerungen.
err: Die Anzahl der AFU-Fehler.
exc: Die Anzahl der AFU-Ausnahmen.
Gerät: Der Einheitenname. Diese Spalte wird übersprungen, wenn die Einheit in der Option angegeben ist.

Zusammengefasste Statistiken für jede aktive Workloadpartition (WPAR) im System

Dieser Bericht enthält zusammengefasste Statistiken für jede aktive WPAR, die im System vorhanden ist. Dieser Bericht enthält die folgenden Spalten; jeweils eine Zeile pro WPAR.

wpar: Der WPAR-Name.
nctx: Die Anzahl der Kontexte.
pf: Die Anzahl der Fehlseitenbedingungen.
spf: Die Anzahl der STAB-Fehler.
pi: Die Anzahl der Einlagerungen.
err: Die Anzahl der AFU-Fehler.
exc: Die Anzahl der AFU-Ausnahmen.
sig: Die Anzahl der AFU-Signale.
stalls: Die Anzahl der AFU-Blockierungen.

Flags

Flag	Beschreibung
-a	Berichtet systemweite zusammengefasste Statistiken.
-c	Berichtet kontextspezifische Statistiken.
-d	Berichtet zusammengefasste AFU-Statistiken.
-p	Berichtet zusammengefasste Prozessstatistiken.
-k	Berichtet zusammengefasste Einheitenkernelstatistiken.
-t `Zahl`	Gibt an, wie oft die Statistiken berichtet werden sollen.
-i `Intervall`	Gibt das Zeitintervall in Sekunden an, in dem die Statistiken berichtet werden müssen.
-@ ALL	Berichtet zusammengefasste Statistiken für jede aktive WPAR, die im System vorhanden ist.
-@ `WPAR-Name`	Berichtet zusammengefasste Statistiken für die angegebene WPAR.

Beispiele

Geben Sie den folgenden Befehl ein, um systemweite zusammengefasste Statistiken zu berichten:
```
caccelstat -a
```
Geben Sie den folgenden Befehl ein, um systemweite zusammengefasste Statistiken 10 Mal in einem Abstand von jeweils einer Sekunde zu berichten:
```
caccelstat -a -t 10 -i 1
```
Geben Sie den folgenden Befehl ein, um alle Kontextstatistiken für die CAPI-fähigen Prozesse im System zu berichten:
```
caccelstat -c
```
Geben Sie den folgenden Befehl ein, um Kontextstatistiken für den Prozess 1234 zu berichten:
```
caccelstat -c -p 1234
```
Geben Sie den folgenden Befehl ein, um Kontextstatistiken für die Einheit /dev/memcopy0 zu berichten:
```
caccelstat -c -d /dev/memcopy0
```
Geben Sie den folgenden Befehl ein, um Prozessstatistiken für alle CAPI-fähigen Prozesse im System zu berichten:
```
caccelstat -p
```
Geben Sie den folgenden Befehl ein, um Prozessstatistiken für den CAPI-fähigen Prozess 1234 zu berichten:
```
caccelstat -p 1234
```
Geben Sie den folgenden Befehl ein, um Einheitenstatistiken für alle im System vorhandenen CAPI-Einheiten zu berichten:
```
caccelstat -d
```
Geben Sie den folgenden Befehl ein, um Einheitenstatistiken für die CAPI-Einheit /dev/memcopy0 zu berichten:
```
caccelstat -d /dev/memcopy0
```
Geben Sie den folgenden Befehl ein, um Einheitenkernelstatistiken für alle CAPI-Einheiten im System zu berichten:
```
caccelstat -k
```
Geben Sie den folgenden Befehl ein, um Einheitenkernelstatistiken für die CAPI-Einheit /dev/memcopy0 zu berichten:
```
caccelstat -k -d /dev/memcopy0
```
Geben Sie den folgenden Befehl ein, um zusammengefasste Statistiken für jede aktive WPAR im System zu berichten:
```
caccelstat -@ ALL
```
Geben Sie den folgenden Befehl ein, um Prozessstatistiken für alle CAPI-fähigen Prozesse in der WPAR testWpar zu berichten:
```
caccelstat -p -@ testWpar
```
Geben Sie den folgenden Befehl ein, um Einheitenstatistiken für die CAPI-Einheit /dev/memcopy0 in der WPAR testWpar zu berichten:
```
caccelstat -d -@ testWpar
```
Geben Sie den folgenden Befehl ein, um alle Kontextstatistiken für die CAPI-fähigen Prozesse in testWparzu berichten:
```
caccelstat -c -@ testWpar
```