[PATCH v2 1/7] introspection: new 'Stats' property in the bearer object

[Aleksander Morgado]

The new property is a dictionary which may include different parameters,
depending on what is actually supported by the underlying modem. For now,
just bytes RX/TX.

Note that this object will expose the stats *as reported by the modem*. These
values may differ from e.g. what is seen in the network interface stats.
---
 .../org.freedesktop.ModemManager1.Bearer.xml       | 31 ++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/introspection/org.freedesktop.ModemManager1.Bearer.xml b/introspection/org.freedesktop.ModemManager1.Bearer.xml
index e1463a5..2c844ab 100644
--- a/introspection/org.freedesktop.ModemManager1.Bearer.xml
+++ b/introspection/org.freedesktop.ModemManager1.Bearer.xml
@@ -242,6 +242,37 @@
     <property name="Ip6Config" type="a{sv}" access="read" />

     <!--
+        Stats:
+
+        If the modem supports it, this property will show statistics of the
+        ongoing connection.
+
+        When the connection is disconnected automatically or explicitly by the
+        user, the values in this property will show the last values cached.
+        The statistics are reset
+
+        The following items may appear in the list of statistics:
+        <variablelist>
+          <varlistentry><term><literal>"rx-bytes"</literal></term>
+            <listitem>
+              Number of bytes received without error, given as an unsigned 64-bit integer value (signature <literal>"t"</literal>).
+            </listitem>
+          </varlistentry>
+          <varlistentry><term><literal>"tx-bytes"</literal></term>
+            <listitem>
+              Number bytes transmitted without error, given as an unsigned 64-bit integer value (signature <literal>"t"</literal>).
+            </listitem>
+            </varlistentry>
+          <varlistentry><term><literal>"duration"</literal></term>
+            <listitem>
+              Duration of the connection, in seconds, given as an unsigned integer value (signature <literal>"u"</literal>).
+            </listitem>
+          </varlistentry>
+        </variablelist>
+    -->
+    <property name="Stats" type="a{sv}" access="read" />
+
+    <!--
         IpTimeout:

         Maximum time to wait for a successful IP establishment, when PPP is used.
--
2.6.2