op_q_wait_time()

摘要

获取数据包在当前包含它的子队列中“等待”的时间长度。

语法

op_q_wait_time (pkptr)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[数据包的指针可以从许多内核过程获得,但在此上下文中最常见的来源是 op_subq_pk_access() 和 op_subq_pk_remove()。]

返回类型

double

指定数据包在其外围队列内的当前子队列中度过的时间长度。若发生可恢复错误,将返回常量 OPC_TIME_INVALID。

示例

/* determine if queue is empty; if not, then process its contents */
if (!op_q_empty ())
	{
	/* determine the number of subqueues */
	num_subqs = op_topo_child_count (op_id_self (), OPC_OBJTYPE_SUBQ);

	/* loop through each subqueue */
	for (i = 0; i < num_subqs; i++)
		{
		/* determine the number of packets in subqueue */
		num_pkts = op_subq_stat (i, OPC_QSTAT_PKSIZE);

		/* loop through each packet in subqueue */
		for (j = 0; j < num_pkts; j++)
			{
			/* schedule self interrupt based on packet’s wait time */
			pkptr = op_subq_pk_access (i, j);
			op_intrpt_schedule_self (1.0 - op_q_wait_time (pkptr), PROC_COMP);
			}
		}
	}

详情

Q 包的内核过程只能在运行于队列模块上的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从运行在处理器上的进程、管道阶段模型中调用它们,或从通过内核过程 op_intrpt_schedule_call() 调度的函数中调用它们,都将导致错误。

该内核过程只应应用于当前包含在外围队列某个子队列中的数据包。对于已从子队列中取出的数据包、尚未插入子队列的数据包,或仅存储在队列进程状态变量指针中的数据包,如果对其应用该内核过程将导致错误。

每当数据包从子队列中移除并重新插入时,其等待时间都会被重置。以下场景描述了这种重置现象:

  • 在 T = 5 时,一个数据包进入子队列输入流
  • 在 T = 5 时,该数据包被插入某个子队列
  • 在 T = 8 时,对该数据包应用该内核过程,它返回数值 3
  • 在 T = 10 时,该数据包从子队列中移除,临时存储在状态变量中,然后重新插入另一个子队列
  • 在 T = 11 时,对该数据包应用该内核过程,它返回数值 1

用途

提供一种机制来确定指定数据包在外围队列内某个子队列中被存储的时间长度。这对于判断处理时间敏感数据包的相对紧迫性,或确定固定时延排队系统的剩余时间,通常很有用。

错误

  • 程序中止:段违例。(由于无效的数据包指针或畸形数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包 (<pk_id>)。
  • 程序中止:数据包指针指向无主的数据包 (<pk_id>)。
  • 可恢复错误:数据包 (<pk_id>) 当前未入队。

参考

  • 使用内核过程 op_q_insert_time() 确定数据包被插入其当前子队列的时间
  • 使用内核过程 op_q_stat() 获取队列相关统计量的值
  • 使用内核过程 op_subq_stat() 获取子队列相关统计量的值

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