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>)超出范围。
参考
- 使用内核过程 op_pk_bulk_size_get() 获取数据包的 bulk 数据大小
- 使用内核过程 op_pk_total_size_set() 直接为数据包的总大小赋值
- 使用内核过程 op_pk_total_size_get() 获取数据包的总大小
- 使用内核过程 op_pk_fd_set() 修改未格式化数据包中某字段的大小(并为其赋值)
- 使用内核过程 op_pk_fd_strip() 或 op_pk_nfd_strip() 从数据包中剥离某个字段,从而消除其对数据包总大小的贡献