NetworkMonitor

gio.network_monitor.NetworkMonitor provides an easy-to-use cross-platform API for monitoring network connectivity. On Linux, the available implementations are based on the kernel's netlink interface and on NetworkManager.

There is also an implementation for use inside Flatpak sandboxes.

interface NetworkMonitor {

static gio.network_monitor.NetworkMonitor getDefault();

bool canReach(gio.socket_connectable.SocketConnectable connectable, gio.cancellable.Cancellable cancellable);

void canReachAsync(gio.socket_connectable.SocketConnectable connectable, gio.cancellable.Cancellable cancellable, gio.types.AsyncReadyCallback callback);

bool canReachFinish(gio.async_result.AsyncResult result);

gio.types.NetworkConnectivity getConnectivity();

bool getNetworkAvailable();

bool getNetworkMetered();

ulong connectNetworkChanged(T callback, Flag!"After" after);

}

Members

Functions

canReach bool canReach(gio.socket_connectable.SocketConnectable connectable, gio.cancellable.Cancellable cancellable): Attempts to determine whether or not the host pointed to by connectable can be reached, without actually trying to connect to it.
canReachAsync void canReachAsync(gio.socket_connectable.SocketConnectable connectable, gio.cancellable.Cancellable cancellable, gio.types.AsyncReadyCallback callback): Asynchronously attempts to determine whether or not the host pointed to by connectable can be reached, without actually trying to connect to it.
canReachFinish bool canReachFinish(gio.async_result.AsyncResult result): Finishes an async network connectivity test. See gio.network_monitor.NetworkMonitor.canReachAsync.
connectNetworkChanged ulong connectNetworkChanged(T callback, Flag!"After" after): Connect to NetworkChanged signal.
getConnectivity gio.types.NetworkConnectivity getConnectivity(): Gets a more detailed networking state than gio.network_monitor.NetworkMonitor.getNetworkAvailable.
getNetworkAvailable bool getNetworkAvailable(): Checks if the network is available. "Available" here means that the system has a default route available for at least one of IPv4 or IPv6. It does not necessarily imply that the public Internet is reachable. See #GNetworkMonitor:network-available for more details.
getNetworkMetered bool getNetworkMetered(): Checks if the network is metered. See #GNetworkMonitor:network-metered for more details.

Static functions

getDefault gio.network_monitor.NetworkMonitor getDefault(): Gets the default #GNetworkMonitor for the system.

gio network_monitor interfaces

NetworkMonitor