NetworkMonitor
GNetworkMonitor
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.
Since
2.32
Inheritors
Types
The NetworkMonitorImpl type represents a native instance of the NetworkMonitor interface.
Properties
More detailed information about the host's network connectivity. See g_network_monitor_get_connectivity() and #GNetworkConnectivity for more details.
Whether the network is considered available. That is, whether the system has a default route for at least one of IPv4 or IPv6.
Whether the network is considered metered.
Functions
Attempts to determine whether or not the host pointed to by
Asynchronously attempts to determine whether or not the host pointed to by @connectable can be reached, without actually trying to connect to it.
Finishes an async network connectivity test. See g_network_monitor_can_reach_async().
Given @connection to communicate with a proxy (eg, a #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload.
Asynchronous version of g_proxy_connect().
See g_proxy_connect().
Gets a more detailed networking state than g_network_monitor_get_network_available().
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.
Checks if the network is metered. See #GNetworkMonitor:network-metered for more details.
Initializes the object implementing the interface.
Emitted when the network configuration changes.
Some proxy protocols expect to be passed a hostname, which they will resolve to an IP address themselves. Others, like SOCKS4, do not allow this. This function will return false if @proxy is implementing such a protocol. When false is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async().