op_stat_obj_reg()
摘要
返回一个可用于写入链路、路径、模块或子模块统计量(仅局部)的句柄。
语法
op_stat_obj_reg (group_dot_stat_name, obj_id, index)
| 参数 | 类型 | 说明 |
|---|---|---|
group_dot_stat_name |
const char* |
需要获取句柄的统计量的组名和名称,两者以句点分隔。 |
obj_id |
Objid |
包含待注册统计量的对象的 ID。 |
index |
int |
目标统计量的数字索引;若统计量没有维度,则用 OPC_STAT_INDEX_NONE。参见表 79“Statistic Index Symbolic Constants“(第 24 页)。 |
返回类型
Stathandle
可用于调用内核过程 op_stat_write() 和 op_stat_write_t() 的统计量句柄。
示例
count = op_topo_assoc_count (self, OPC_TOPO_ASSOC_IN, OPC_OBJMTYPE_LINK);
if (count != 1)
op_sim_end ("Only one link should be connected to packet generator in this model",
"", "", "", "");
objid = op_topo_assoc (self, OPC_TOPO_ASSOC_IN, OPC_OBJMTYPE_LINK, 0);
link_stat = op_stat_obj_reg ("Test.Non-Dimensional Counter", objid,
OPC_STAT_INDEX_NONE);
for (j=0; j < 4; j++)
{
link_dim_stat [j] = op_stat_obj_reg ("Test.Dimensional Counter", objid, j);
}
/* rest of original pksw code */
address_dist = op_dist_load ("uniform_int", 0, 3);
ete_gsh = op_stat_reg ("ETE delay", OPC_STAT_INDEX_NONE, OPC_STAT_GLOBAL);
详情
该过程与 op_stat_reg() 类似;主要区别在于:该过程允许使用任何形式的可执行代码(如管道过程和外部代码)访问任何对象的统计量,并且仅支持局部统计量。
仿真内核集中管理全局和局部统计量。每个统计量都维护一个组名、名称、索引、类型和输出向量。用户在首次通过 op_stat_obj_reg() 注册统计量时指定其组名、名称和索引。此后以已注册的组名和名称再次调用该内核过程,将与先前注册时创建的统计量“会合”(rendezvous),并返回同一个句柄。这使得多个进程可以访问同一个统计量,前提是它们有围绕名称同步的机制。同一模块内的进程可以在同一个局部统计量上会合。任何进程都可以在同一个全局统计量上会合。
维度化统计量提供一组输出统计量。Stathandle 指由索引指定的该组中的元素。对于无维度的统计量,索引值必须使用符号常量 OPC_STAT_INDEX_NONE。
注册统计量需要根据指定的名称和组在现有统计量集合中进行搜索。为了提升性能,用户应当只注册一次统计量,并把得到的统计量句柄缓存起来(例如存放在状态变量中)供后续使用。
用途
统计量注册使多个进程能够共享同一个输出向量来记录仿真度量。通过注册获得对统计量的访问后,进程可以围绕统计量名称进行协调,从而避免独立开发的模型之间的冲突。该函数返回一个统计量句柄,通过内核过程 op_stat_write() 和 op_stat_write_t() 向统计量写入新值时需要该句柄。
错误
- 程序中止(Program Abort):段错误。(由于无效或格式错误的
stat_name参数) - 可恢复错误(Recoverable Error):无法注册统计量(
<stat_name>)。(由于统计量未声明) - 可恢复错误(Recoverable Error):无法注册统计量(
<stat_name>)。(由于可用内存不足) - 程序中止(Program Abort):该内核过程需要进程上下文。
- 可恢复错误(Recoverable Error):统计量索引(
<stat_index>)超出范围。
参考
- 使用内核过程 op_stat_reg() 在进程模型内访问节点或模块统计量
- 使用内核过程 op_stat_write() 向输出统计量写入值,并以当前仿真时间标记
- 使用内核过程 op_stat_write_t() 向输出统计量写入值,并以指定仿真时间标记
- 使用内核过程 op_stat_scalar_write() 向标量统计量写入值