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 数据结构)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com