op_pk_encap_flag_is_set()
摘要
检查数据包上的某个标志是否已被置位。
语法
op_pk_encap_flag_is_set (pkptr, index)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
index |
int |
要在数据包上检查的标志 [标志可以是 0 到 31 之间的整数。] |
返回类型
Boolean
如果标志已置位,返回 OPC_TRUE;否则返回 OPC_FALSE。
示例
节选自 models/std/utilities/oms 中的 oms_bgutil.ex.c。
if (op_pk_encap_flag_is_set (pkptr, OMSC_BGUTIL_ENCAP_FLAG_INDEX))
{
/* Drill to get the actual bgutil packet. */
op_pk_encap_pk_get (pkptr, "bgutil_tracer", &bgutil_pkptr);
if (bgutil_pkptr == OPC_NIL)
{
return_routed_bgutil = 0.0;
*routed_packets_per_sec_ptr = 0.0;
FRET (return_routed_bgutil);
}
/* Get the src and dest objids. */
op_pk_nfd_get (bgutil_pkptr, "src_objid", &src_objid);
op_pk_nfd_get (bgutil_pkptr, "dest_objid", &dest_objid);
...
}
详情
index 参数所指示的标志编号没有特定含义;其含义完全由模型开发者决定。如果数据包已通过 op_pk_encap_flag_set() 置过标志,或者它包含这样的数据包,则可以使用 op_pk_encap_flag_is_set() 检测到该标志。一个数据包上可以置多个标志。
用途
提供一种检测带标志数据包的机制。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 可恢复错误:封装标志索引 (
<index>) 超出数据包 (<pk_id>) 的范围。合法范围为 0 到 (<index>)。
参考
- 使用内核过程 op_pk_encap_pk_get() 获取被封装数据包的副本
- 使用内核过程 op_pk_encap_flag_set() 在待封装的数据包上置标志