summaryrefslogtreecommitdiff
path: root/introspection
diff options
context:
space:
mode:
authorDan Winship <danw@gnome.org>2013-07-30 16:31:31 -0400
committerDan Winship <danw@gnome.org>2013-08-28 10:54:08 -0400
commit07521da59115dff6c2394240d5fffade3cded62f (patch)
treea45a32fc4c7113f027501d775c78e08e58dfe9a0 /introspection
parent8732914815ef315cd94ba67ba4b8247d90412b13 (diff)
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.xml53
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>