ACE 解码子包

ACE Decode API 是一组为协议解码提供支持的函数。这些例程可以划分为几个不同的类别:

  • 缓冲区子包(Buffer sub-package)
  • 分片子包(Fragmentation sub-package)
  • 数据包子包(Packet sub-package)
  • 协议信息子包(Protocol Info sub-package)
  • TCP 流子包(TCP Stream sub-package)
  • 工具子包(Utilities sub-package)

缓冲区子包

解码协议时,缓冲区常用于暂存临时数据或中间结果。缓冲区子包提供便于在自定义解码器中使用缓冲区的函数。该子包通常与 TCP 流子包配合使用。

分片子包

分片子包中的函数可用于处理支持分片的协议中的分片数据包。

数据包子包

数据包子包包含各种用于访问和修改单个数据包各元素的 *_Get() 和 *_Set() 函数。例如,每个数据包都为其源和目的分别维护一个套接字号(端口号)和一个主机名。

通常,*_Socket_Set() 和 *_Host_Set() 函数由较低层协议使用,在编写自定义应用层解码时很少用到。根据解码类型的不同,调用 *_Socket_Get() 和 *_Host_Get() 函数可能会有用。如果相关协议维护独立的数据连接和控制连接,或者需要将套接字或主机信息作为协议摘要行或详情行的一部分,这些访问函数就会很有帮助。

本子包包含 Ace_Packet_Protocol_Info_Append(),用于创建保存每个协议解码的摘要行和详情行的数据结构。

协议信息子包

协议子包(Protocol sub-package)包含用于访问协议信息的函数。其中特别是 Ace_Protocol_Info_Summary_Set(),用于设置协议的摘要行。

该子包的函数所访问的协议信息存储在 AceT_Pk_Protocol_Info 数据结构中。对于每个已被解码器处理过的协议层,数据包都各有一个这样的数据结构。该数据结构包含下表所列的元素。

表 2:AceT_Pk_Protocol_Info 数据元素

元素 数据类型 说明
protocol_id int 对应层中协议的 ID。
offset int 协议在数据包内的起始偏移(以字节计)。
summary_string char * 对应层的摘要信息。
fragment_id int 若数据包是分片,则为分片 ID。
details VosT_Ll_Desc * 对应层的详情行列表。

该子包还包含用于访问数据包属性的函数。

TCP 流子包

TCP 流子包包含用于访问 TCP 数据流中数据包的函数。

工具子包

该子包包含用于处理解码过程中常见任务的函数,例如报告错误和获取被解码数据的相关信息。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com