op_pk_tree_id()

摘要

获取指定数据包所属数据包“树”的标识符。数据包树是由同一个原始数据包复制而产生的一组数据包。

语法

op_pk_tree_id (pkptr)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]

返回类型

OpT_Packet_Id

标识指定数据包所属数据包“树”的整数值。

示例

/* Obtain the next control message. Control messages are processes in LIFO order. */
ctrl_pkptr = op_subq_pk_remove (CTRL_SUBQ, OPC_QPOS_TAIL);

/* Extract the control message’s instruction type and process accordingly. */
op_pk_fd_get (ctrl_pkptr, "instruction", &ctrl_inst);
switch (ctrl_inst)
	{
	case CTRL_INST_RECALL:
		/* All data packet’s that are copies of a particular original are to be */
		/* discarded. Obtain the "tree ID" that identifies this class of packets. */
		op_pk_fd_get (ctrl_pkptr, "tree_id", &recall_tree_id);

		/* Search for data packets that should be removed from data message queue. */
		q_size = op_q_stat (OPC_QSTAT_PKSIZE);
		for (i = 0; i < q_size; i++)
			{
			/* Extract the i_th packet and obtain its tree ID; */
			/* decide whether to delete */
			data_pkptr = op_subq_pk_access (DATA_SUBQ, i);
			if (op_pk_tree_id (data_pkptr) == recall_tree_id)
				{
				op_pk_destroy (op_subq_pk_remove (DATA_SUBQ, i--));
				i--;

详情

每当创建一个新的原始数据包时,都会生成一个新的树 ID。新的原始数据包由内核过程 op_pk_create() 或 op_pk_create_fmt() 的调用创建。其他可能导致数据包创建、但不会创建原始数据包的操作,是内核过程 op_pk_copy() 以及通过无线电或总线链路的数据包传输。由单个原始数据包的全部副本连同原始数据包本身共同构成一棵数据包树。每个树通过给新的原始数据包标记一个唯一的整数来获得树 ID。这棵树的维护只是一种松散的关联,仅仅通过在副本生成时将该标识符传递给副本来实现。也就是说,副本的副本也携带相同的树 ID。

注意,当一个数据包被复制时,封装在它内部的数据包也会被复制,并且这些数据包拥有与其对应的原始封装数据包相同的树 ID。

数据包 ID 通过内核过程 op_pk_id() 获取,在一次仿真运行的每个独立创建的数据包实例之间都是唯一的;数据包 ID 与树 ID 完全独立维护——两个数据包可能具有相同的树 ID,但任何两个数据包绝不会具有相同的数据包 ID。当具有某个树 ID 的全部数据包都被销毁后,该树 ID 将不会再被分配给任何进入循环的新数据包。

用途

该内核过程使由数据包复制产生的数据包能够与其起源的原始数据包关联起来。这在重传或广播复制发生之后进行端到端的数据包跟踪时特别有用。例如,当数据包传输请求由一个应用层进程发起时,提交的数据包有可能在较低的协议层被复制多次,尤其是在使用总线或无线电链路等广播介质时的物理层。因此当数据包最终到达其目的地时,它实际上是原始数据包的一个新实例,op_pk_id() 为该数据包返回的值将与原始数据包的不同。然而,op_pk_tree_id() 返回的树 ID 将是相同的。

错误

  • 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包。

参考

  • 使用内核过程 op_pk_id() 获取在每个独立数据包之间唯一的标识符。
  • 使用内核过程 op_pk_copy() 创建现有数据包的副本。

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