diff options
author | Dan Winship <danw@gnome.org> | 2013-07-30 16:31:31 -0400 |
---|---|---|
committer | Dan Winship <danw@gnome.org> | 2013-08-28 10:54:08 -0400 |
commit | 07521da59115dff6c2394240d5fffade3cded62f (patch) | |
tree | a45a32fc4c7113f027501d775c78e08e58dfe9a0 /introspection | |
parent | 8732914815ef315cd94ba67ba4b8247d90412b13 (diff) | |
download | NetworkManager-07521da59115dff6c2394240d5fffade3cded62f.tar.gz |
core: provide additional network connectivity information
NM_STATE_CONNECTED_SITE doesn't distinguish between "behind a captive
portal" and "limited network connectivity" (ie, connected to a router
that has lost its upstream connection). Add a new NMManager
:connectivity property to provide this information.
Also add a CheckConnectivity method, which can be used to force NM to
re-check the connectivity state, which could be called by a client
after it completed a portal login, or fixed a network problem.
Diffstat (limited to 'introspection')
-rw-r--r-- | introspection/nm-manager.xml | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/introspection/nm-manager.xml b/introspection/nm-manager.xml index d9f6a7c3d2..4fc7692cc4 100644 --- a/introspection/nm-manager.xml +++ b/introspection/nm-manager.xml @@ -244,6 +244,19 @@ </arg> </method> + <method name="CheckConnectivity"> + <annotation name="org.freedesktop.DBus.GLib.CSymbol" value="impl_manager_check_connectivity"/> + <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> + <tp:docstring> + Re-check the network connectivity state. + </tp:docstring> + <arg name="connectivity" type="u" tp:type="NM_CONNECTIVITY" direction="out"> + <tp:docstring> + The current connectivity state. + </tp:docstring> + </arg> + </method> + <method name="state"> <tp:docstring> The overall networking state as determined by the NetworkManager daemon, @@ -333,6 +346,12 @@ </arg> </signal> + <property name="Connectivity" type="u" access="read" tp:type="NM_CONNECTIVITY"> + <tp:docstring> + The network connectivity state. + </tp:docstring> + </property> + <signal name="PropertiesChanged"> <tp:docstring> NetworkManager's properties changed. @@ -413,5 +432,39 @@ </tp:enumvalue> </tp:enum> + <tp:enum name="NM_CONNECTIVITY" type="u"> + <tp:docstring> + Describes the network-connectivity state. + </tp:docstring> + <tp:enumvalue suffix="UNKNOWN" value="0"> + <tp:docstring> + Network connectivity is unknown. + </tp:docstring> + </tp:enumvalue> + <tp:enumvalue suffix="NONE" value="1"> + <tp:docstring> + The host is not connected to any network. + </tp:docstring> + </tp:enumvalue> + <tp:enumvalue suffix="PORTAL" value="2"> + <tp:docstring> + The host is behind a captive portal and cannot reach the + full Internet. + </tp:docstring> + </tp:enumvalue> + <tp:enumvalue suffix="LIMITED" value="3"> + <tp:docstring> + The host is connected to a network, but does not appear to + be able to reach the full Internet. + </tp:docstring> + </tp:enumvalue> + <tp:enumvalue suffix="FULL" value="4"> + <tp:docstring> + The host is connected to a network, and appears to be able + to reach the full Internet + </tp:docstring> + </tp:enumvalue> + </tp:enum> + </interface> </node> |