op_ici_print()
摘要
将指定 ICI 的内容打印到标准输出设备。
语法
op_ici_print (iciptr)
| 参数 | 类型 | 说明 |
|---|---|---|
iciptr |
Ici * |
指向目标 ICI 的指针 [指向 ICI 的指针可以从两个内核过程获得: op_ici_create() 返回指向新分配 ICI 的指针(在 ICI 发送进程中),以及 op_intrpt_ici() 返回与传入中断关联的 ICI 的指针(在 ICI 接收进程中)。] |
返回类型
void
无返回值。
示例
/* obtain incoming ICI */
iciptr = op_intrpt_ici();
/* determine if the ICI is of the appropriate type; */
/* if so, print its contents onto the terminal */
op_ici_format (pkptr, ici_name);
if (strcmp (ici_name, "fddi_mac_fr_llc") == 0)
op_ici_print (iciptr);
在标准输出设备上显示的示例输出:
------------- ICI (34) -------------
format (fddi_mac_fr_llc)
svc_class : (2)
dst_addr : (13)
pri : (1)
tk_class : (0)
------------------------------------
详情
默认情况下,仿真的标准输出设备就是启动仿真进程的命令 shell。如果仿真进程是由应用程序 GUI 派生的,则标准输出设备是启动应用程序进程的命令 shell。如果仿真进程是从窗口系统的某个窗口启动的,默认的标准输出设备将与该窗口关联。可以在仿真命令行上使用 > I/O 重定向操作符将标准输出重定向到文件。
该内核过程生成的 ICI 信息的格式见「示例」小节。注意 ICI 的唯一数字 ID 会打印在横幅中。
该内核过程不会影响其所操作的 ICI 的内容或安装状态。
对于等于常量 OPC_NIL 的 ICI 指针,该内核过程只是打印一条表明该 ICI 地址为 NIL 的消息,不会产生错误。
用途
为用户提供了一种从终端监视 ICI 内容、或将 ICI 内容记录到文件中供日后研究的机制。当传入的 ICI 包含用于进程计算或影响进程逻辑流向的值时,打印 ICI 内容在仿真调试器中非常有用。打印 ICI 的语句可以添加到状态执行代码中(用于事件驱动的打印),或添加到诊断块中(用于在调试器中发出 prodiag 命令时按用户要求打印数据包信息)。(也可以直接在仿真调试器中使用 iciprint_ev 和 iciprint_pk 命令打印 ICI。)
错误
- 程序中止:Segmentation violation。(由于无效的 ICI 指针或格式错误的 ICI 数据结构)
参考
- 使用内核过程 op_intrpt_ici() 获取与传入中断关联的 ICI 的指针
- 使用内核过程 op_pk_format() 获取数据包的格式
- 使用内核过程 op_ici_format_print_proc_set() 为指定格式的 ICI 命名结构字段指定自定义打印过程