caccelstat 命令

用途

报告与整个系统或每个加速器和进程的相干加速器相关的统计信息。

语法

系统范围聚集统计信息

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

上下文统计信息

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

聚集设备或加速器功能单元 (AFU) 统计信息

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

聚集进程上下文统计信息

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

聚集设备内核上下文统计信息

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

描述

caccelstat 命令用来监视系统中的相干加速器活动。此命令可以报告所有启用了相干加速器处理器接口 (CAPI) 的进程的聚集统计信息，也可以显示每个启用了 CAPI 的进程的统计信息。在加速器功能单元 (AFU) 是相干加速设备（例如 /dev/caccel0）的情况下，此命令还可以显示每个 AFU 的统计信息。

系统范围聚集统计信息

系统范围聚集统计信息报告包含以下信息：

启用了 CAPI 的进程的数目
系统中加速器的数目
用户上下文数
内核上下文数
主上下文数
缺页故障数
分段表 (STAB) 故障数
AFU 错误数
AFU 异常数
AFU 信号数
AFU 停止次数

上下文统计信息

此报告包含上下文统计信息，每个上下文都是其中一行。如果未指定进程标识 (pid) 和设备，那么将报告系统中的所有注册用户上下文。将省略内核上下文。如果指定了 pid 或设备，那么将报告该 pid 或设备的上下文。如果同时指定了 pid 和设备，那么将报告与所选 pid 和设备相关的上下文。

报告包含以下信息：

状态

上下文状态。

此字段可以具有以下值：

S: 上下文处于暂挂状态。
R: 上下文处于运行状态。
D: 上下文处于正在拆离状态。
A: 上下文处于正在连接状态。
E: 上下文处于错误状态。

对于主进程，会将 M 与状态组合在一起。例如，如果主进程的上下文处于运行状态，那么状态字段显示 MR。

注: 运行状态 (R) 并不意味着 AFU 正在运行此上下文。它表示 AFU 未处于任何其他状态。

pid

进程标识。如果在选项中指定了 pid，那么将跳过此列。

pf

缺页故障数。

spf

STAB 故障数。

pi

页面调入数。

err

进程错误数。

exc

进程异常数。

sig

进程信号数。

stalls

由于异常而导致 AFU 停止的次数。

aur

此进程的加速器利用率寄存器 (AUR) 值。如果 AUR 不受支持，那么此字段显示 0。

台设备

设备名。如果在选项中指定了设备，那么将跳过此列。

聚集设备 (AFU) 统计信息

此报告包含跨所有进程上下文的 AFU 的聚集统计信息。如果未指定设备，那么将报告系统中所有 AFU 的统计信息。此报告包括下列各列，每个设备都是其中一行：

nctx: 已注册进程的上下文数。
pf: 缺页故障数。
spf: STAB 故障数。
pi: 页面调入数。
err: AFU 错误数。
exc: AFU 异常数。
sig: AFU 信号数。
stalls: 由于异常队列将满而导致 AFU 停止的次数。
台设备: 设备名。如果在选项中指定了设备，那么将跳过此列。

聚集进程上下文统计信息

此报告包含启用了 CAPI 的进程的聚集统计信息和按进程上下文的统计信息。 pid 是 AIX 进程标识。如果未指定 pid，那么将报告系统中所有启用了 CAPI 的进程的统计信息。

此报告包括下列各列，每个上下文都是其中一行：

pid: AIX 进程标识。如果在选项中指定了设备，那么将跳过此列。
nctx: 已注册进程的上下文数。
pf: 缺页故障数。
spf: STAB 故障数。
pi: 页面调入数。
err: AFU 错误数。
exc: AFU 异常数。
sig: AFU 信号数。
stalls: 由于异常队列将满而导致 AFU 停止的次数。
aur: 此进程的加速器利用率寄存器值。如果 AUR 不受支持，那么此字段显示 0。

聚集设备内核上下文统计信息

此报告包含聚集统计信息或按设备内核上下文的统计信息。如果未指定设备，那么将报告所有 AFU 的统计信息。此报告包括下列各列，每个设备都是其中一行：

pf: 缺页故障数。
spf: STAB 故障数。
pi: 页面调入数。
err: AFU 错误数。
exc: AFU 异常数。
台设备: 设备名。如果在选项中指定了设备，那么将跳过此列。

系统中每个活动工作负载分区 (WPAR) 的聚集统计信息

此报告包含系统中存在的每个活动 WPAR 的聚集统计信息。此报告包括下列各列，每个 WPAR 都是其中一行：

wpar: WPAR 名称。
nctx: 上下文数。
pf: 缺页故障数。
spf: STAB 故障数。
pi: 页面调入数。
err: AFU 错误数。
exc: AFU 异常数。
sig: AFU 信号数。
stalls: AFU 停止次数。

标志

标志	描述
-a	报告系统范围聚集统计信息。
-c	按上下文报告统计信息。
-d	报告聚集 AFU 统计信息。
-p	报告聚集进程统计信息。
-k	报告聚集设备内核统计信息。
-t `计数`	指定必须报告统计信息的次数。
-i `interval`	指定报告统计信息必须相隔的时间间隔（以秒计）。
-@ ALL	报告系统中存在的每个活动 WPAR 的聚集统计信息。
-@ `wparname`	报告所指定 WPAR 的聚集统计信息。

示例

要报告系统范围聚集统计信息，请输入以下命令：
```
caccelstat -a
```
要以 1 秒为时间间隔报告系统范围聚集统计信息 10 次，请输入以下命令：
```
caccelstat -a -t 10 -i 1
```
要报告系统中启用了 CAPI 的进程的所有上下文统计信息，请输入以下命令：
```
caccelstat -c
```
要报告进程 1234 的上下文统计信息，请输入以下命令：
```
caccelstat -c -p 1234
```
要报告设备 /dev/memcopy0 的上下文统计信息，请输入以下命令：
```
caccelstat -c -d /dev/memcopy0
```
要报告系统中所有启用了 CAPI 的进程的进程统计信息，请输入以下命令：
```
caccelstat -p
```
要报告启用了 CAPI 的进程 1234 的进程统计信息，请输入以下命令：
```
caccelstat -p 1234
```
要报告系统中存在的所有 CAPI 设备的设备统计信息，请输入以下命令：
```
caccelstat -d
```
要报告 CAPI 设备 /dev/memcopy0 的设备统计信息，请输入以下命令：
```
caccelstat -d /dev/memcopy0
```
要报告系统中所有 CAPI 设备的设备内核统计信息，请输入以下命令：
```
caccelstat -k
```
要报告 CAPI 设备 /dev/memcopy0 的设备内核统计信息，请输入以下命令：
```
caccelstat -k -d /dev/memcopy0
```
要报告系统中每个活动 WPAR 的聚集统计信息，请输入以下命令：
```
caccelstat -@ ALL
```
要报告 testWpar WPAR 中所有启用了 CAPI 的进程的进程统计信息，请输入以下命令：
```
caccelstat -p -@ testWpar
```
要在 testWpar WPAR 中报告 CAPI 设备 /dev/memcopy0 的设备统计信息，请输入以下命令:
```
caccelstat -d -@ testWpar
```
要报告 testWpar 中启用了 CAPI 的进程的所有上下文统计信息，请输入以下命令：
```
caccelstat -c -@ testWpar
```