inetpeer.h

/*
 *		INETPEER - A storage for permanent information about peers
 *
 *  Authors:	Andrey V. Savochkin <saw@msu.ru>
 */

#ifndef _NET_INETPEER_H
#define _NET_INETPEER_H

#include <linux/types.h>
#include <linux/init.h>
#include <linux/jiffies.h>
#include <linux/spinlock.h>
#include <asm/atomic.h>

//该结构为对端信息块结构，以v4addr为关键之，peer_root为跟，组织成AVL树。见樊东东P238
//对端信息块主要用于组装ip数据包时防止分片攻击，在建立tcp连接时检测连接请求段是否有效以及其序列号是否回绕
struct inet_peer {
	/* group together avl_left,avl_right,v4daddr to speedup lookups */
	struct inet_peer	*avl_left, *avl_right;  //用来将对端信息块组成AVL树。AVL树的根为peer_root。
	__be32			v4daddr;	/* peer's address */
	__u32			avl_height;
	struct list_head	unused; //用来链接到inet_peer_unused_head链表上。该 链表上的对端信息块都是当前闲置的， 可回收的。  unused_peers
	__u32			dtime;		/* the time of last use of not
						 * referenced entries */  //记录该对端信息块引用计数为0的时间。 当闲置的时间超出指定的时间时， 就会被回收。
	atomic_t		refcnt; //引用计数器，标识当前被使用的次数。 当引用计数为0，表示该对端信息块 没有被使用。
	atomic_t		rid;		/* Frag reception counter */ //递增ID，对端发送分片的计数器。 参见ipq结构中的rid成员。
	atomic_t		ip_id_count;	/* IP ID for the next packet */// 一个单调递增值，用来设置IP分片首部中的id域。根据对端地址初始化为随机值。
	__u32			tcp_ts;//TCP中，记录最后一个ACK段到达的 时间。参见tcp_options_received结构中 的ts_recent成员。
	__u32			tcp_ts_stamp; //TCP中，记录接收到的段中的时间戳， 设置ts_recent的时间。参见tcp_options_received 结构中的ts_recent_stamp成员。
};

void			inet_initpeers(void) __init;

/* can be called with or without local BH being disabled */
struct inet_peer	*inet_getpeer(__be32 daddr, int create);

/* can be called from BH context or outside */
extern void inet_putpeer(struct inet_peer *p);

/* can be called with or without local BH being disabled */
static inline __u16	inet_getid(struct inet_peer *p, int more)
{
	more++;
	return atomic_add_return(more, &p->ip_id_count) - more;
}

#endif /* _NET_INETPEER_H */