op_pk_bulk_size_set()

摘要

将指定数据包的 bulk 数据大小设置为指定值。

语法

op_pk_bulk_size_set (pkptr, bulk_size)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
bulk_size OpT_Packet_Size 要赋给指定数据包的 bulk 大小(以比特计)
[该数可以为正、负或零。如果 bulk 大小为负,所得的数据包总大小必须为正或零,否则将发生错误。]

返回类型

void

无返回值。

示例

节选改编自:示例模型(models/std/ip);进程模型(ip_encap);状态 ENCAP 的 enter execs。

/* Obtain a packet arriving from a higher protocol layer and its length in bytes*/
pkptr = op_pk_get (IP_ENCAP_INSTRM_TRANSP);
data_len = op_pk_total_size_get (pkptr) / 8;

/* Create an IP packet and encapsulate the new arrival within its data field. */
ip_pkptr = op_pk_create_fmt ("ip_dgram");
op_pk_nfd_set (ip_pkptr, "data", pkptr);

/* The data field has a modeled size of zero in order to allow the packet to be */
/* broken into an arbitrary number of smaller sized packets. The bulk size */
/* attribute of the packet will instead be used to model the size of the */
/* encapsulated data. */
op_pk_bulk_size_set (ip_pkptr, data_len * 8);

/* Obtain the destination address from the accompanying ICI. */
ip_iciptr = op_intrpt_ici ();
if (ip_iciptr == OPC_NIL)
	{
	op_sim_end ("Fatal error in process ip_encap:",
		"Required ICI is missing", "","");

详情

bulk 数据大小是数据包的一个属性,用于建模那些未显式归属于各个字段的数据量。修改数据包的 bulk 数据大小会按比例修改数据包的总大小,而总大小是 bulk 数据大小与数据包各字段大小之和。数据包的 bulk 数据大小可以在任何时候修改或访问。未格式化和已格式化的数据包都可以通过该内核过程设置其 bulk 数据大小。创建时,未格式化数据包的 bulk 数据大小被设置为作为 op_pk_create() 参数指定的值;新创建的已格式化数据包的 bulk 数据大小被设置为零。

你也可以使用 op_pk_bulk_size_set() 将 bulk 数据大小设置为负数。负的 bulk 数据大小适用于表示减少传输数据量的压缩技术。

**注意:**即使 bulk 数据大小为负,数据包总大小也必须为正或零。

用途

提供一种修改数据包 bulk 数据大小的机制。当数据包包含大量数据、无需建模为赋给特定字段的显式内容,而可以简单地建模为具有特定总大小的一组比特时,这通常很有用。此类例子可包括包含文件传输或遥测数据的数据包。

错误

  • 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包。
  • 程序中止:数据包指针指向无主数据包 (<pk_id>)。
  • 可恢复错误:bulk 数据包大小(<bulk_size>)超出范围。

参考

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