#ifndef PCAPP_PCAP_REMOTE_DEVICE_LIST
#define PCAPP_PCAP_REMOTE_DEVICE_LIST
#if defined(_WIN32)
#include "IpAddress.h"
#include "PcapRemoteDevice.h"
/// @file
/**
* \namespace pcpp
* \brief The main namespace for the PcapPlusPlus lib
*/
namespace pcpp
{
/**
* @class PcapRemoteDeviceList
* A class that creates, stores and provides access to all instances of PcapRemoteDevice for a certain remote machine. To get an instance
* of this class use one of the static methods of getRemoteDeviceList(). These methods creates a PcapRemoteDeviceList instance for the
* certain remote machine which holds a list of PcapRemoteDevice instances, one for each remote network interface. Note there is
* not a public constructor for this class, so the only way to get an instance of it is through getRemoteDeviceList(). After getting
* this object, this class provides ways to access the PcapRemoteDevice instances: either through IP address of the remote network interface or
* by iterating the PcapRemoteDevice instances (through the PcapRemoteDeviceList#RemoteDeviceListIterator iterator)
* Since Remote Capture is supported in WinPcap and Npcap only, this class is available in Windows only
*/
class PcapRemoteDeviceList
{
private:
std::vector m_RemoteDeviceList;
IPAddress m_RemoteMachineIpAddress;
uint16_t m_RemoteMachinePort;
PcapRemoteAuthentication* m_RemoteAuthentication;
// private c'tor. User should create the list via static methods PcapRemoteDeviceList::getRemoteDeviceList()
PcapRemoteDeviceList() : m_RemoteMachinePort(0), m_RemoteAuthentication(NULL) {}
// private copy c'tor
PcapRemoteDeviceList(const PcapRemoteDeviceList& other);
PcapRemoteDeviceList& operator=(const PcapRemoteDeviceList& other);
void setRemoteMachineIpAddress(const IPAddress& ipAddress);
void setRemoteMachinePort(uint16_t port);
void setRemoteAuthentication(const PcapRemoteAuthentication* remoteAuth);
public:
/**
* Iterator object that can be used for iterating all PcapRemoteDevice in list
*/
typedef typename std::vector::iterator RemoteDeviceListIterator;
/**
* Const iterator object that can be used for iterating all PcapRemoteDevice in a constant list
*/
typedef typename std::vector::const_iterator ConstRemoteDeviceListIterator;
~PcapRemoteDeviceList();
/**
* A static method for creating a PcapRemoteDeviceList instance for a certain remote machine. This methods creates the instance, and also
* creates a list of PcapRemoteDevice instances stored in it, one for each remote network interface. Notice this method allocates
* the PcapRemoteDeviceList instance and returns a pointer to it. It's the user responsibility to free it when done using it
* This method overload is for remote daemons which don't require authentication for accessing them. For daemons which do require authentication
* use the other method overload
* @param[in] ipAddress The IP address of the remote machine through which clients can connect to the rpcapd daemon
* @param[in] port The port of the remote machine through which clients can connect to the rpcapd daemon
* @return A pointer to the newly created PcapRemoteDeviceList, or NULL if (an appropriate error will be printed to log in each case):
* - IP address provided is NULL or not valid
* - WinPcap/Npcap encountered an error in creating the remote connection string
* - WinPcap/Npcap encountered an error connecting to the rpcapd daemon on the remote machine or retrieving devices on the remote machine
*/
static PcapRemoteDeviceList* getRemoteDeviceList(const IPAddress& ipAddress, uint16_t port);
/**
* An overload of the previous getRemoteDeviceList() method but with authentication support. This method is suitable for connecting to
* remote daemons which require authentication for accessing them
* @param[in] ipAddress The IP address of the remote machine through which clients can connect to the rpcapd daemon
* @param[in] port The port of the remote machine through which clients can connect to the rpcapd daemon
* @param[in] remoteAuth A pointer to the authentication object which contains the username and password for connecting to the remote
* daemon
* @return A pointer to the newly created PcapRemoteDeviceList, or NULL if (an appropriate error will be printed to log in each case):
* - IP address provided is NULL or not valid
* - WinPcap/Npcap encountered an error in creating the remote connection string
* - WinPcap/Npcap encountered an error connecting to the rpcapd daemon on the remote machine or retrieving devices on the remote machine
*/
static PcapRemoteDeviceList* getRemoteDeviceList(const IPAddress& ipAddress, uint16_t port, PcapRemoteAuthentication* remoteAuth);
/**
* @return The IP address of the remote machine
*/
IPAddress getRemoteMachineIpAddress() const { return m_RemoteMachineIpAddress; }
/**
* @return The port of the remote machine where packets are transmitted from the remote machine to the client machine
*/
uint16_t getRemoteMachinePort() const { return m_RemoteMachinePort; }
/**
* Search a PcapRemoteDevice in the list by its IPv4 address
* @param[in] ip4Addr The IPv4 address
* @return The PcapRemoteDevice if found, NULL otherwise
*/
PcapRemoteDevice* getRemoteDeviceByIP(const IPv4Address& ip4Addr) const;
/**
* Search a PcapRemoteDevice in the list by its IPv6 address
* @param[in] ip6Addr The IPv6 address
* @return The PcapRemoteDevice if found, NULL otherwise
*/
PcapRemoteDevice* getRemoteDeviceByIP(const IPv6Address& ip6Addr) const;
/**
* Search a PcapRemoteDevice in the list by its IP address (IPv4 or IPv6)
* @param[in] ipAddr The IP address
* @return The PcapRemoteDevice if found, NULL otherwise
*/
PcapRemoteDevice* getRemoteDeviceByIP(const IPAddress& ipAddr) const;
/**
* Search a PcapRemoteDevice in the list by its IP address
* @param[in] ipAddrAsString The IP address in string format
* @return The PcapRemoteDevice if found, NULL otherwise
*/
PcapRemoteDevice* getRemoteDeviceByIP(const std::string& ipAddrAsString) const;
/**
* @return An iterator object pointing to the first PcapRemoteDevice in list
*/
RemoteDeviceListIterator begin() { return m_RemoteDeviceList.begin(); }
/**
* @return A const iterator object pointing to the first PcapRemoteDevice in list
*/
ConstRemoteDeviceListIterator begin() const { return m_RemoteDeviceList.begin(); }
/**
* @return An iterator object pointing to the last PcapRemoteDevice in list
*/
RemoteDeviceListIterator end() { return m_RemoteDeviceList.end(); }
/**
* @return A const iterator object pointing to the last PcapRemoteDevice in list
*/
ConstRemoteDeviceListIterator end() const { return m_RemoteDeviceList.end(); }
};
} // namespace pcpp
#endif // _WIN32
#endif /* PCAPP_PCAP_REMOTE_DEVICE_LIST */