Interface

GioNetworkMonitor

since: 2.32

Description [src] 

interface Gio.NetworkMonitor : Gio.Initable

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.

Available since: 2.32

Prerequisite

In order to implement NetworkMonitor, your type must inherit fromGInitable.

Functions

g_network_monitor_get_default

Gets the default GNetworkMonitor for the system.

since: 2.32

Instance methods

g_network_monitor_can_reach

Attempts to determine whether or not the host pointed to by connectable can be reached, without actually trying to connect to it.

since: 2.32

g_network_monitor_can_reach_async

Asynchronously attempts to determine whether or not the host pointed to by connectable can be reached, without actually trying to connect to it.

g_network_monitor_can_reach_finish

Finishes an async network connectivity test. See g_network_monitor_can_reach_async().

g_network_monitor_get_connectivity

Gets a more detailed networking state than g_network_monitor_get_network_available().

since: 2.44

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.

since: 2.32

g_network_monitor_get_network_metered

Checks if the network is metered. See GNetworkMonitor:network-metered for more details.

since: 2.46

Properties

Gio.NetworkMonitor:connectivity

More detailed information about the host’s network connectivity. See g_network_monitor_get_connectivity() and GNetworkConnectivity for more details.

since: 2.44

Gio.NetworkMonitor:network-available

Whether the network is considered available. That is, whether the system has a default route for at least one of IPv4 or IPv6.

since: 2.32

Gio.NetworkMonitor:network-metered

Whether the network is considered metered.

since: 2.46

Signals

Gio.NetworkMonitor::network-changed

Emitted when the network configuration changes.

since: 2.32

Interface structure 

struct GioNetworkMonitorInterface {
  GTypeInterface g_iface;
  void (* network_changed) (
    GNetworkMonitor* monitor,
    gboolean network_available
  );
  gboolean (* can_reach) (
    GNetworkMonitor* monitor,
    GSocketConnectable* connectable,
    GCancellable* cancellable,
    GError** error
  );
  void (* can_reach_async) (
    GNetworkMonitor* monitor,
    GSocketConnectable* connectable,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* can_reach_finish) (
    GNetworkMonitor* monitor,
    GAsyncResult* result,
    GError** error
  );
  
}

The virtual function table for GNetworkMonitor.

Interface members
g_iface 
GTypeInterface
 

The parent interface.
network_changed 
void (* network_changed) (
    GNetworkMonitor* monitor,
    gboolean network_available
  )
 

The virtual function pointer for the GNetworkMonitor::network-changed signal.
can_reach 
gboolean (* can_reach) (
    GNetworkMonitor* monitor,
    GSocketConnectable* connectable,
    GCancellable* cancellable,
    GError** error
  )
 

The virtual function pointer for g_network_monitor_can_reach().
can_reach_async 
void (* can_reach_async) (
    GNetworkMonitor* monitor,
    GSocketConnectable* connectable,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  )
 

The virtual function pointer for g_network_monitor_can_reach_async().
can_reach_finish 
gboolean (* can_reach_finish) (
    GNetworkMonitor* monitor,
    GAsyncResult* result,
    GError** error
  )
 

The virtual function pointer for g_network_monitor_can_reach_finish().

Virtual methods

Gio.NetworkMonitor.can_reach

Attempts to determine whether or not the host pointed to by connectable can be reached, without actually trying to connect to it.

since: 2.32

Gio.NetworkMonitor.can_reach_async

Asynchronously attempts to determine whether or not the host pointed to by connectable can be reached, without actually trying to connect to it.

Gio.NetworkMonitor.can_reach_finish

Finishes an async network connectivity test. See g_network_monitor_can_reach_async().

Gio.NetworkMonitor.network_changed

The virtual function pointer for the GNetworkMonitor::network-changed signal.