netx

type PingResult struct {
	// Source IP = remote host
	Src net.IP

	// Destination IP = localhost IP
	Dst net.IP

	// Type of Service
	TOS int

	// Time to live (# of hops, really)
	TTL int

	// ICMP Type: Type of Message
	// http://en.wikipedia.org/wiki/Internet_Control_Message_Protocol#Control_messages
	Type icmp.Type

	// ICMP Subtype
	// http://en.wikipedia.org/wiki/Internet_Control_Message_Protocol#Control_messages
	Code int

	// Message ID
	ID int

	// Message sequence number
	Seq int

	// Payload size
	Size int

	// Round trip time
	RTT time.Duration

	// Any errors encountered
	Err error
}

type Pinger struct {

	// Interval is the amount of time to wait between sending each ICMP packet.
	// Realistically this shouldn't be less than 25 or 50ms as the process of the
	// ECHO_REPLY packets will take some time. So if the ECHO_REQUEST packets are
	// sent too fast, then the round trip time will be skewed.
	//
	// Default 100ms.
	Interval time.Duration

	// MaxRTT is the maximum round trip time a response is to be expected.
	// Default 100ms.
	MaxRTT time.Duration

	// ICMP payload size, in bytes. Minimum 8 bytes.
	Size int

	// Copied from `man ping` on CentOS
	// Set  Quality of Service -related bits in ICMP datagrams. Traditionally (RFC1349),
	// these have been interpreted as: 0 for reserved (currently being redefined as
	// congestion  control),  1-4  for  Type  of Service and 5-7 for Precedence.
	// Possible settings for Type of Service are: minimal cost: 0x02, reliability: 0x04,
	// throughput: 0x08, low delay: 0x10.  Multiple TOS bits should not be set
	// simultaneously.   Possible  settings  for special Precedence range from priority
	// (0x20) to net control (0xe0).  You must be root (CAP_NET_ADMIN capability) to
	// use Critical or higher precedence value.  You cannot set  bit  0x01 (reserved)
	// unless  ECN  has been enabled in the kernel.  In RFC2474, these fields has been
	// redefined as 8-bit Differentiated Services (DS), consisting of: bits 0-1 of
	// separate data (ECN will be used, here), and bits  2-7 of Differentiated
	// Services Codepoint (DSCP).
	//
	// Default 0
	TOS int

	// Time to live for outgoing ECHO_REQUEST packets.
	//
	// Default 32.
	TTL int

	// Don't Fragment.
	//
	// Default false.
	DF bool
	// contains filtered or unexported fields
}