op_pk_total_size_set()
摘要
将指定数据包的总大小设置为指定值(前提是该值有效)。
语法
op_pk_total_size_set (pkptr, total_size)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [许多内核过程都可以获得数据包指针,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
total_size |
OpT_Packet_Size |
要分配给指定数据包的总大小(以比特计) [该数值必须为正数或零,否则将发生错误。] |
返回类型
Compcode
指示大小修改是否成功的完成代码。
修改成功时,此内核过程返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
摘自:示例模型(models/std/fddi);进程模型(fddi_gen);状态(ARRIVAL);enter execs。
/* create a packet to send to mac */
pkptr = op_pk_create_fmt ("fddi_llc_fr");
/* assign its overall size. */
op_pk_total_size_set (pkptr, pklen);
/* assign the time of creation */
op_pk_nfd_set (pkptr, "cr_time", op_sim_time ());
详情
数据包的总大小是 bulk 数据大小与各已设置字段大小之和。总大小可以直接修改:修改 bulk 数据大小、设置或取消设置数据包的字段,或修改数据包各字段的大小。当通过此内核过程直接修改总大小时,bulk 数据大小将按比例修改。
数据包的总大小可以在任何时候修改或访问。未格式化数据包与格式化数据包均可通过此内核过程设置大小。
如果新的总大小小于各字段大小之和,bulk 数据大小将为负数。负的 bulk 数据大小可用于表示减少传输数据量的压缩技术。也可以使用 op_pk_bulk_size_set() 将 bulk 数据大小设置为负数。
**注意:**即使 bulk 数据大小为负数,数据包总大小也必须为正数或零。
用途
提供了一种修改数据包总大小的机制。当数据包应当具有与当前各字段大小无关的特定总大小时,这通常很有用。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 程序中止:数据包指针指向未被拥有的数据包(
<pk_id>)。 - 可恢复错误:数据包总大小(
<size>)为负数。
参考
- 使用内核过程 op_pk_total_size_get() 获取数据包的总大小
- 使用内核过程 op_pk_bulk_size_set() 仅设置数据包的 bulk 数据大小
- 使用内核过程 op_pk_bulk_size_get() 仅获取数据包的 bulk 数据大小
- 使用内核过程 op_pk_fd_set() 修改未格式化数据包中某字段的大小(并设置其值)
- 使用内核过程 op_pk_fd_strip() 或 op_pk_nfd_strip() 剥离数据包中的某个字段,从而消除该字段对数据包总大小的贡献