networkinterfacemonitor.h

Go to the documentation of this file.

 
#pragma once
 
 
#include <promeki/config.h>
#if PROMEKI_ENABLE_NETWORK
#include <promeki/objectbase.h>
#include <promeki/error.h>
#include <promeki/networkinterface.h>
#include <promeki/ipv4address.h>
#include <promeki/ipv6address.h>
 
PROMEKI_NAMESPACE_BEGIN
 
class NetworkInterfaceMonitor : public ObjectBase {
                PROMEKI_OBJECT(NetworkInterfaceMonitor, ObjectBase)
        public:
                static constexpr unsigned int DefaultDebounceMs = 50;
 
                explicit NetworkInterfaceMonitor(ObjectBase *parent = nullptr);
 
                ~NetworkInterfaceMonitor() override;
 
                Error start();
 
                void stop();
 
                bool isRunning() const { return _running; }
 
                void setDebounceMs(unsigned int ms) { _debounceMs = ms; }
 
                unsigned int debounceMs() const { return _debounceMs; }
 
                void testForceRescan();
 
                static NetworkInterfaceMonitor *anyRunning();
 
                PROMEKI_SIGNAL(interfaceAdded, NetworkInterface);
                PROMEKI_SIGNAL(interfaceRemoved, NetworkInterface);
                PROMEKI_SIGNAL(linkUp, NetworkInterface);
                PROMEKI_SIGNAL(linkDown, NetworkInterface);
                PROMEKI_SIGNAL(addressAddedIpv4, NetworkInterface, Ipv4Address);
                PROMEKI_SIGNAL(addressRemovedIpv4, NetworkInterface, Ipv4Address);
                PROMEKI_SIGNAL(addressAddedIpv6, NetworkInterface, Ipv6Address);
                PROMEKI_SIGNAL(addressRemovedIpv6, NetworkInterface, Ipv6Address);
                PROMEKI_SIGNAL(interfacesChanged);
 
                void kickDebounce();
 
        private:
                // Runs the diff cycle synchronously on the monitor's
                // affinity thread.  Called by the debounce timer or
                // @ref testForceRescan.
                void runDiff();
 
                bool         _running     = false;
                int          _debounceTimer = -1;
                unsigned int _debounceMs  = DefaultDebounceMs;
 
                struct PreviousEntry {
                        NetworkInterfaceImplPtr impl;
                        NetworkInterfaceData    data;
                };
                // Keyed by raw impl pointer (const because SharedPtr
                // exposes only @c const access) — Stage 1 stabilises
                // impl identity so the pointer is a stable per-iface
                // key.  The @c PreviousEntry holds a SharedPtr too, so
                // the impl outlives a registry-driven eviction
                // mid-cycle.
                struct Private;
                Private *_priv;
};
 
Error networkInterfaceMonitorPlatformOpen(NetworkInterfaceMonitor *m);
 
void networkInterfaceMonitorPlatformClose(NetworkInterfaceMonitor *m);
 
PROMEKI_NAMESPACE_END
 
#endif // PROMEKI_ENABLE_NETWORK