op_pk_nfd_access()
摘要
获取指定数据包中某个整数、double、结构或信息字段的值,字段保持不变;目标字段由名称指定。
语法
op_pk_nfd_access (pkptr, fd_name, value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
目标数据包的指针 [许多内核过程都可以获得数据包指针,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
fd_name |
const char* |
目标字段的名称 [该名称必须是数据包格式中已定义的字段,否则会发生错误。] |
value_ptr |
void* |
指向某个变量的指针,用于填入指定字段的值 [此参数可以接受除 packet 以外任何数据类型的指针。参数指针的数据类型必须与指定字段的数据类型一致,否则会发生错误。] |
返回类型
Compcode
完成代码,指示是否成功获取指定字段的值。如果发生错误(例如字段缺失),将返回常量 OPC_COMPCODE_FAILURE。
示例
/* Access the datagram field information structure */
/* to assign source address information. */
op_pk_nfd_access (pk_copy_ptr, “fields”, &pkt_fields_ptr);
/* Set the source address before forwarding the packet. */
pkt_fields_ptr->src_addr = iface_ptr->addr_range_ptr->address;
pkt_fields_ptr->src_internal_addr = ip_rtab_addr_convert (iface_ptr->addr_range_ptr->address);
详情
该内核过程支持访问任意数据类型(packet 除外)的数据包字段。structure 类型字段的值会被复制到传入的变量中,但除此之外不受影响(即结构字段仍然保持置位且可访问,并继续为数据包的总大小贡献相同的比特数)。
警告: 由于该内核过程在访问结构字段的值时不会将结构字段从数据包中移除,多个进程可能同时在同一个对象上工作,可能无意中相互影响。
对于 integer、double 和 information 类型的字段,该内核过程的行为与 op_pk_nfd_get() 相同。
用途
提供获取数据包字段值的机制。该内核过程实现的功能与 op_pk_nfd_get() 完全相同,不同之处在于
- structure 类型的字段不会从数据包中被剥离
- packet 类型的字段不受支持
错误
- 程序中止:段错误。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 程序中止:数据包指针指向不属于自己的数据包(
<pk_id>)。
参考
- 使用内核过程
op_pk_nfd_set()的某个格式为数据包字段赋值 - 使用内核过程
op_pk_nfd_access_read_only_ptr()对数据包的结构字段进行高效的只读访问 - 使用内核过程
op_pk_fd_get()从非格式化(或格式化)数据包中获取字段的值,通过数字索引指定要访问的字段 - 使用内核过程
op_pk_nfd_type()确定数据包字段的类型 - 使用内核过程
op_pk_nfd_size()确定数据包字段的大小 - 使用内核过程
op_pk_nfd_is_set()判断数据包字段是否已置位