op_pk_total_size_get()
摘要
获取指定数据包的总大小。
语法
op_pk_total_size_get (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_Size
指定数据包的总大小(以比特计)。
示例
摘自:示例模型(models/std/eth_net);进程模型(eth_mac);函数块(eth_mac_llc_pk_accept())。
/* acquire the packet */
llc_pkptr = op_pk_get (HIGH_LAYER_INPUT_STREAM);
/* llc data larger than the maximum acceptable size will */
/* cause an error and the data will be discarded. */
if (op_pk_total_size_get (llc_pkptr) > MAX_DATA_SIZE)
{
/* compose and display the error message */
sprintf (err_str, "large packet with (%g) bits",
op_pk_total_size_get (llc_pkptr));
op_sim_message ("ethernet mac layer discarding excessively", err_str);
/* throw away the packet and return from invocation. */
op_pk_destroy (llc_pkptr);
FOUT
}
详情
数据包的总大小是 bulk 数据大小与各已设置字段大小之和。总大小可以直接修改:修改 bulk 数据大小、设置或取消设置数据包的字段,或修改数据包各字段的大小。未格式化数据包与格式化数据包均可通过此内核过程进行操作。
用途
提供了一种确定数据包总大小的机制,可用于统计量收集、资源分配或按大小对数据包分类。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
参考
- 使用内核过程 op_pk_total_size_set() 设置数据包的总大小
- 使用内核过程 op_pk_bulk_size_set() 仅设置数据包的 bulk 数据大小
- 使用内核过程 op_pk_bulk_size_get() 仅获取数据包的 bulk 数据大小
- 使用内核过程 op_pk_fd_set() 修改未格式化数据包中某字段的大小(并设置其值)
- 使用内核过程 op_pk_fd_strip() 或 op_pk_nfd_strip() 剥离数据包中的某个字段,从而消除该字段对数据包总大小的贡献