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 数据流中数据包的函数。
工具子包
该子包包含用于处理解码过程中常见任务的函数,例如报告错误和获取被解码数据的相关信息。