op_prg_odb_print_major()

摘要

以 ODB 跟踪语句的格式,从主缩进层级开始向标准输出设备打印一串字符串。

语法

op_prg_odb_print_major (string0, string1, …, OPC_NIL)
参数 类型 说明
string0 const char* 要打印的第一个字符串
string1 const char* 要打印的第二个字符串
… const char* 要打印的其余字符串
OPC_NIL 字符串序列终止符。[本内核过程的参数构成一个可变长度的字符串序列,打印到标准输出设备。该序列以符号常量 OPC_NIL 终止。]

返回类型

void

无返回值。

示例

节选自:示例模型(std/tcp);进程模型(tcp);函数块;函数(tcp_state_info())。

sprintf (str0, "rcv requests pending   : (%d)", num_rcvs_allowed);
sprintf (str1, "local receive window   : (%d)", receive_window);
sprintf (str2, "remote receive window  : (%d)", remote_window);
op_prg_odb_print_major ("Window-Related Variables", str0, str1, str2, OPC_NIL);

sprintf (str0, "send unacked           : (%d)", send_unacked);
sprintf (str1, "send_next              : (%d)", send_next);
sprintf (str2, "receive next           : (%d)", receive_next);
op_prg_odb_print_minor (str0, str1, str2, OPC_NIL);

标准输出设备上显示的示例输出:

               |       Window-Related Variables
               |           rcv requests pending   : (3)
               |           local receive window   : (6400)
               |           remote receive window  : (10788)
               |           send unacked           : (4525)
               |           send_next              : (5000)
               |           receive_next           : (1200)

详情

ODB 跟踪语句的对齐策略为:

  • 第 17 列:星号表示内核过程调用,竖线表示由 op_prg_odb_print_major() 或 op_prg_odb_print_minor() 打印的用户诊断语句
  • 第 25 列:内核过程调用的参数与返回值,以及 op_prg_odb_print_major() 打印的第一个字符串(即主缩进层级)
  • 第 33 列:op_prg_odb_print_major() 打印的第二个至最后一个字符串,以及 op_prg_odb_print_minor() 打印的全部字符串(即次缩进层级)

注意: 只有传入本内核过程的第一个字符串出现在主缩进层级;所有其他字符串参数都出现在次缩进层级。

本内核过程在优化仿真内核下使用时不执行任何操作。

用途

为按 ODB 跟踪语句所使用的标准格式打印诊断消息提供了一种机制。主缩进层级突出显示单条概要或横幅消息,用以解释其后的诊断消息。注意,本内核过程在仿真未运行于 ODB 之下时并不会在内部限制其输出,因此对本内核过程的调用通常嵌入在依赖于 ODB 中跟踪处于激活状态的条件块内(例如由 op_prg_odb_trace_active()、op_prg_odb_ltrace_active() 或 op_prg_odb_pktrace_active() 判断)。

错误

  • 程序中止:段违例,由以下一种或多种情况引起:(1) 字符串指针无效;(2) 字符串未以 null 终止;(3) 字符串序列未以符号常量 OPC_NIL 终止。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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