libnids中的API文档翻译

libnids-1.20
1.介绍
2.IP分片
3.TCP流重组
4.一个应用示例
5.libnids基本的数据结构和函数
6.Misc有用之处


/////////先来一段关于TCP重组的,其他不管。



3.TCP流重组
为了接收TCP流中交换的数据,必须声明一个回调函数
void tcp_callback(struct tcp_stream * ns, void ** param)

tcp_stream结构体重提供了一个TCP连接的所有信息。例如,它包含了两个half_stream类型的结构(叫做客户和服务器),

它们分别描述一个连接的一端。我们将在后面介绍它的所有结构成员。



tcp_stream结构中有一个叫做nids_state的值。tcp_callback的行为取决于它的取值。


 1)ns->nids_state==NIDS_JUST_EST

在这种情况下,ns描述了一个刚刚建立的连接。Tcp_callback函数必须决定是否期望在该以后连接中的数据到达时得到通知。

所有的连接参数都是可用的(IP地址,端口号等)。如果连接是被关注的,tcp_callback函数通知libnids它索期望接收的数据(到

客户、服务器的普通数据和紧急数据)。然后函数返回。


 2)ns->nids_state==NIDS_DATA
在这种情况下,新的数据已经到达。half_stream结构体(tcp_stream的成员)包含数据缓冲。


 3)nids_state取值如下时:
  NIDS_CLOSE
  NIDS_RESET
  NIDS_TIMED_OUT
表明连接已经关闭。tcp_callback函数应释放已分配给它的资源,如果有的话。




 4)ns->nids_state==NIDS_EXITING

在这种情况下,libnids正在退出。这是应用程序利用留在half_stream缓冲区里数据的最后机会。

当从一个已抓取的文件而不是网络中读取数据流时,libnids可能根本看不到close,reset或者timeout。

如果应用程序有未处理的数据(例如,从使用nids_discard()函数而来的,这是允许应用程序去处理它的。)

你可能感兴趣的:(数据结构,api,tcp,Stream,文档,callback)