#include <NetworkUtils.h>

Public Member Functions
MacAddress	getMacAddress (IPv4Address ipAddr, PcapLiveDevice *device, double &arpResponseTimeMS, MacAddress sourceMac=MacAddress::Zero, IPv4Address sourceIP=IPv4Address::Zero, int arpTimeout=-1) const

IPv4Address	getIPv4Address (std::string hostname, PcapLiveDevice *device, double &dnsResponseTimeMS, uint32_t &dnsTTL, int dnsTimeout=-1, IPv4Address dnsServerIP=IPv4Address::Zero, IPv4Address gatewayIP=IPv4Address::Zero) const

Static Public Member Functions
static NetworkUtils &	getInstance ()

Static Public Attributes
static const int	DefaultTimeout

Detailed Description

This class bundles several network utilities that are very common and useful. These utilities use Pcap++ and Packet++ packet crafting and processing capabilities. This class is a singleton and can be access by getInstance() only

Member Function Documentation

◆ getInstance()

static NetworkUtils& pcpp::NetworkUtils::getInstance ( )

inlinestatic

The access method to the singleton

Returns: The singleton instance of this class

◆ getIPv4Address()

IPv4Address pcpp::NetworkUtils::getIPv4Address	(	std::string	hostname,
		PcapLiveDevice *	device,
		double &	dnsResponseTimeMS,
		uint32_t &	dnsTTL,
		int	dnsTimeout = `-1`,
		IPv4Address	dnsServerIP = `IPv4Address::Zero`,
		IPv4Address	gatewayIP = `IPv4Address::Zero`
	)		const

Resolve an IPv4 address for a given hostname. Resolving is done in multiple phases: first resolving the LAN gateway MAC address (or default gateway if a gateway isn't provided) using ARP protocol (by using NetworkUtils::getMacAddress() ). Then a DNS request is sent to a DNS server (if specified) or to the LAN gateway (if DNS server is not specified). The DNS response is decoded and the IPv4 address is determined. In addition the method outputs the time it took the DNS response to arrive and the DNS TTL written on the DNS response. If DNS response doesn't contain an IPv4 address resolving an IPv4Address::Zero will be returned.

Parameters

[in]	hostname	The hostname to resolve
[in]	device	The interface to send and receive packets on
[out]	dnsResponseTimeMS	When method returns successfully will contain the time it took to receive the DNS response (in milli-seconds)
[out]	dnsTTL	When method returns successfully will contain The DNS TTL written in the DNS response
[in]	dnsTimeout	An optional parameter to specify the timeout to wait for a DNS response. If not specified the default timeout is 5 sec
[in]	dnsServerIP	An optional parameter to specify the DNS server IP to send the DNS request to. If not specified or specified with IPv4Address::Zero the DNS request will be sent to the default DNS server configured in the system
[in]	gatewayIP	An optional parameter to specify the LAN gateway to send the DNS request through. If not specified or specified with IPv4Address::Zero the interface's default gateway will be used

Returns: The resolved IPv4 address or IPv4Address::Zero if something went wrong (in this case an error will be printed to log)

◆ getMacAddress()

MacAddress pcpp::NetworkUtils::getMacAddress	(	IPv4Address	ipAddr,
		PcapLiveDevice *	device,
		double &	arpResponseTimeMS,
		MacAddress	sourceMac = `MacAddress::Zero`,
		IPv4Address	sourceIP = `IPv4Address::Zero`,
		int	arpTimeout = `-1`
	)		const

Resolve the MAC address for a given IPv4 address. It's done using the ARP protocol: send an ARP request and interpret the response

Parameters

[in]	ipAddr	The IPv4 address to resolve MAC address to
[in]	device	The interface to send and receive the ARP packets on
[out]	arpResponseTimeMS	An output parameter that will contain the time in milliseconds that took the ARP response to arrive
[in]	sourceMac	An optional parameter to set the source MAC address that will be sent with the ARP request if this parameter isn't set or set with MacAddress::Zero the MAC address of the interface will be used
[in]	sourceIP	An optional parameter to set the source IPv4 address that will be sent with the ARP request if this parameter isn't set or set with IPv4Address::Zero the default IPv4 address of the interface will be used
[in]	arpTimeout	An optional parameter to set the timeout to wait for the ARP response to return. If this parameter isn't set or set with a number smaller than 0, a default timeout of 5 seconds will be set

Returns: The resolved MAC address or MacAddress::Zero if an error occurred or address could not be resolved. Errors will be printed to log

Member Data Documentation

◆ DefaultTimeout

const int pcpp::NetworkUtils::DefaultTimeout

static

Default timeout used for several utilities. Currently set to 5 seconds

Public Member Functions

Static Public Member Functions