op_pk_format()
摘要
获取与指定数据包相关联的数据包格式的名称。
语法
op_pk_format (pkptr, fmt_name)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
fmt_name |
char* |
数据包格式的名称(由该内核过程填入) [该值应当是一个静态声明的字符数组,或一个指向动态分配内存的字符指针;无论哪种方式,它都必须指向一个足够大的字符串,以容纳指定数据包的格式名称。如果指定的数据包是无格式的,该字符串将被置为 “NONE”。] |
返回类型
void
无返回值。
示例
/* obtain the arriving packet */
pkptr = op_pk_get (INPUT_STRM);
/* determine the format of the packet */
op_pk_format (pkptr, pk_format);
/* print out a debug statement */
printf ("processing packet with format [%s]\n", pk_format);
/* store the packet in the second subqueue */
op_subq_pk_insert (1, pkptr, OPC_QPOS_TAIL);
详情
有格式的数据包可以通过内核过程 op_pk_create_fmt() 创建。创建时指定的格式决定了所创建数据包的内部结构。数据包格式可以在数据包格式编辑器(Packet Format Editor)的一个模式中定义,也可以通过 Ema 程序定义。格式由一组命名数据包字段的列表组成,每个字段都有指定的类型、以比特为单位的大小,以及一个在数据包创建时可置位或不置位的默认值。
每个有格式的数据包都有一个关联的格式。无格式和有格式的数据包都可以传入该内核过程,但只有有格式的数据包会产生有意义的结果;无格式的数据包会使字符串 “NONE” 被赋给传入的字符指针。
用途
提供一种确定数据包格式名称的机制。对于根据所处理数据包的类型进行进程逻辑分支,这一信息很有用。显示到达数据包格式的调试语句也很有用,如前一页示例所示。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针、格式错误的数据包或无效的
fmt_name参数) - 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
参考
- 使用内核过程 op_pk_is_format() 测试数据包格式的名称
- 使用内核过程 op_pk_create_fmt() 基于指定格式创建数据包
- 使用内核过程 op_pk_nfd_type() 确定数据包命名字段的类型
- 使用内核过程 op_pk_nfd_name_to_index() 将字段名称转换为字段索引
- 使用内核过程 op_pk_nfd_get() 获取数据包命名字段的值
- 使用内核过程 op_pk_nfd_set() 设置数据包命名字段的值