lib_icmp_type.h

浏览该文件的文档.

#ifndef __LIB_ICMP_TYPE_INCLUDE_H__
#define __LIB_ICMP_TYPE_INCLUDE_H__

#define ICMP_TYPE_ECHOREPLY     0
#define ICMP_TYPE_ECHO          8

#define ICMP_CODE_EXTRA         16

typedef struct ICMP_STREAM ICMP_STREAM;
typedef struct ICMP_CHAT ICMP_CHAT;
typedef struct ICMP_STAT ICMP_STAT;
typedef struct ICMP_HOST ICMP_HOST;
typedef struct ICMP_PKT ICMP_PKT;
typedef struct ICMP_PKT_STATUS ICMP_PKT_STATUS;

/**< ICMP 通信过程中每个主机的 PING 响应状态信息汇总 */
struct ICMP_STAT {
        double tmin;                    /**< 最短时间 */
        double tmax;                    /**< 最长时间 */
        double tsum;                    /**< 总时间 */
        double tave;                    /**< 平均时间 */
        size_t nsent;                   /**< 已经发送的包个数 */
        size_t nreceived;               /**< 已经收到的包个数 */
        double loss;                    /**< 丢失的包个数 */
};

#define ICMP_MIN_PACKET         32
#define ICMP_MAX_PACKET         1024

/**< ICMP 所发送的每个 PING 包之后的主机状态应答 */
struct ICMP_PKT_STATUS {
        size_t reply_len;               /**< 包回复的数据长度 */
        char   from_ip[64];             /**< 源地址 */

        double         rtt;             /**< 往返时间(毫秒)(Round Trip Time) */
        unsigned short seq;             /**< 序列号(seq no) */
        unsigned char  ttl;             /**< 生存时间(time to live) */
        unsigned int   gid;
        char          *data;
        size_t         dlen;
        char           status;
#define ICMP_STATUS_INIT                0
#define ICMP_STATUS_OK                  1
#define ICMP_STATUS_UNREACH             (1<<1) 
#define ICMP_STATUS_TIMEOUT             (1<<2)

        ICMP_PKT      *pkt;
};

/**< 目的主机信息结构 */
struct ICMP_HOST {
        ICMP_STAT icmp_stat;            /**< ICMP 通信过程中的状态 */
        char dest_ip[32];               /**< 目的主机IP地址 */
        char domain[64];                /**< 目的主机IP所对应的域名 */
        struct sockaddr_in dest;        /**< 发送包时目的主机地址 */
        struct sockaddr_in from;        /**< 接收时源主机地址 */
        int   from_len;                 /**< 接收时存储在 from 中的地址长度 */
        int   delay;                    /**< 发送 PING 的间隔，单位为毫秒 */
        int   timeout;                  /**< 超时时间(毫秒) */
        size_t dlen;                    /**< 每个发送包的大小(字节) */
        size_t nsent;                   /**< 已经发送给该目的主机包的个数 */

        ICMP_PKT **pkts;                /**< 所有包的数组 */
        size_t npkt;                    /**< 设置的向该目的主机发送包的个数 */
        size_t ipkt;                    /**< 记录下一个要发送的包的下标 */

        ACL_RING   host_ring;           /**< 链入 ICMP_CHAT->host_head 链中 */
        ICMP_CHAT *chat;                /**< 所属的通信对象 */
        char  enable_log;               /**< 是否将响应包的信息记日志 */

        /**< 汇报发送包的响应包状态 */
        void (*stat_respond)(ICMP_PKT_STATUS*, void*);

        /**< 该发送包的响应包超时 */
        void (*stat_timeout)(ICMP_PKT_STATUS*, void*);

        /**< 该主机不可达 */
        void (*stat_unreach)(ICMP_PKT_STATUS*, void*);

        /**< 当主机的包发完时的回调函数 */
        void (*stat_finish)(ICMP_HOST*, void*);

        /**< 应用传递的私有参数地址 */
        void *arg;
};

#endif