wifi: expose the last_seen property for a NMAccessPoint
authorMathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com>
Tue, 21 Apr 2015 15:48:26 +0000 (11:48 -0400)
committerThomas Haller <thaller@redhat.com>
Wed, 29 Apr 2015 05:49:23 +0000 (07:49 +0200)
https://mail.gnome.org/archives/networkmanager-list/2015-April/msg00053.html

introspection/nm-access-point.xml
libnm-glib/libnm-glib.ver
libnm-glib/nm-access-point.c
libnm-glib/nm-access-point.h
src/devices/wifi/nm-wifi-ap.c
src/devices/wifi/nm-wifi-ap.h

index 21f238f..ef5af6a 100644 (file)
     <property name="Strength" type="y" access="read">
       <tp:docstring>The current signal quality of the access point, in percent.</tp:docstring>
     </property>
+    <property name="LastSeen" type="i" access="read">
+      <tp:docstring>
+        The timestamp (in CLOCK_BOOTTIME seconds) for the last time the access
+        point was found in scan results.  A value of -1 means the access point
+        has never been found in scan results.
+      </tp:docstring>
+    </property>
 
     <signal name="PropertiesChanged">
         <arg name="properties" type="a{sv}" tp:type="String_Variant_Map">
index 9219c4a..dc982e5 100644 (file)
@@ -11,6 +11,7 @@ global:
        nm_access_point_get_flags;
        nm_access_point_get_frequency;
        nm_access_point_get_hw_address;
+       nm_access_point_get_last_seen;
        nm_access_point_get_max_bitrate;
        nm_access_point_get_mode;
        nm_access_point_get_rsn_flags;
index abf61cc..c6b7c9c 100644 (file)
@@ -53,6 +53,7 @@ typedef struct {
        NM80211Mode mode;
        guint32 max_bitrate;
        guint8 strength;
+       gint last_seen;
 } NMAccessPointPrivate;
 
 enum {
@@ -67,6 +68,7 @@ enum {
        PROP_MAX_BITRATE,
        PROP_STRENGTH,
        PROP_BSSID,
+       PROP_LAST_SEEN,
 
        LAST_PROP
 };
@@ -265,6 +267,27 @@ nm_access_point_get_strength (NMAccessPoint *ap)
        return NM_ACCESS_POINT_GET_PRIVATE (ap)->strength;
 }
 
+/**
+ * nm_access_point_get_last_seen:
+ * @ap: a #NMAccessPoint
+ *
+ * Returns the timestamp (in CLOCK_BOOTTIME seconds) for the last time the
+ * access point was found in scan results.  A value of -1 means the access
+ * point has not been found in a scan.
+ *
+ * Returns: the last seen time in seconds
+ *
+ * Since: 1.2
+ **/
+gint
+nm_access_point_get_last_seen (NMAccessPoint *ap)
+{
+       g_return_val_if_fail (NM_IS_ACCESS_POINT (ap), -1);
+
+       _nm_object_ensure_inited (NM_OBJECT (ap));
+       return NM_ACCESS_POINT_GET_PRIVATE (ap)->last_seen;
+}
+
 /**
  * nm_access_point_connection_valid:
  * @ap: an #NMAccessPoint to validate @connection against
@@ -416,6 +439,7 @@ nm_access_point_filter_connections (NMAccessPoint *ap, const GSList *connections
 static void
 nm_access_point_init (NMAccessPoint *ap)
 {
+       NM_ACCESS_POINT_GET_PRIVATE (ap)->last_seen = -1;
 }
 
 static void
@@ -482,6 +506,9 @@ get_property (GObject *object,
        case PROP_STRENGTH:
                g_value_set_uchar (value, nm_access_point_get_strength (ap));
                break;
+       case PROP_LAST_SEEN:
+               g_value_set_int (value, nm_access_point_get_last_seen (ap));
+               break;
        default:
                G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
                break;
@@ -512,6 +539,7 @@ register_properties (NMAccessPoint *ap)
                { NM_ACCESS_POINT_MODE,        &priv->mode },
                { NM_ACCESS_POINT_MAX_BITRATE, &priv->max_bitrate },
                { NM_ACCESS_POINT_STRENGTH,    &priv->strength },
+               { NM_ACCESS_POINT_LAST_SEEN,   &priv->last_seen },
                { NULL },
        };
 
@@ -671,4 +699,20 @@ nm_access_point_class_init (NMAccessPointClass *ap_class)
                                     0, G_MAXUINT8, 0,
                                     G_PARAM_READABLE |
                                     G_PARAM_STATIC_STRINGS));
+
+       /**
+        * NMAccessPoint:last-seen:
+        *
+        * The timestamp (in CLOCK_BOOTTIME seconds) for the last time the
+        * access point was found in scan results.  A value of -1 means the
+        * access point has not been found in a scan.
+        *
+        * Since: 1.2
+        **/
+       g_object_class_install_property
+               (object_class, PROP_LAST_SEEN,
+                g_param_spec_int (NM_ACCESS_POINT_LAST_SEEN, "", "",
+                                  -1, G_MAXINT, -1,
+                                  G_PARAM_READABLE |
+                                  G_PARAM_STATIC_STRINGS));
 }
index d3150f8..fc43cba 100644 (file)
@@ -46,6 +46,7 @@ G_BEGIN_DECLS
 #define NM_ACCESS_POINT_MODE        "mode"
 #define NM_ACCESS_POINT_MAX_BITRATE "max-bitrate"
 #define NM_ACCESS_POINT_STRENGTH    "strength"
+#define NM_ACCESS_POINT_LAST_SEEN   "last-seen"
 
 /* DEPRECATED */
 #define NM_ACCESS_POINT_HW_ADDRESS  "hw-address"
@@ -80,6 +81,7 @@ guint32                nm_access_point_get_frequency    (NMAccessPoint *ap);
 NM80211Mode            nm_access_point_get_mode         (NMAccessPoint *ap);
 guint32                nm_access_point_get_max_bitrate  (NMAccessPoint *ap);
 guint8                 nm_access_point_get_strength     (NMAccessPoint *ap);
+gint                   nm_access_point_get_last_seen    (NMAccessPoint *ap);
 
 GSList *               nm_access_point_filter_connections (NMAccessPoint *ap,
                                                            const GSList *connections);
index c891fc7..56d7cbf 100644 (file)
@@ -80,6 +80,7 @@ enum {
        PROP_MODE,
        PROP_MAX_BITRATE,
        PROP_STRENGTH,
+       PROP_LAST_SEEN,
        LAST_PROP
 };
 
@@ -195,6 +196,12 @@ get_property (GObject *object, guint prop_id,
        case PROP_STRENGTH:
                g_value_set_schar (value, priv->strength);
                break;
+       case PROP_LAST_SEEN:
+               g_value_set_int (value,
+                                priv->last_seen > 0
+                                    ? (gint) nm_utils_monotonic_timestamp_as_boottime (priv->last_seen, NM_UTILS_NS_PER_SECOND)
+                                    : -1);
+               break;
        default:
                G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
                break;
@@ -294,6 +301,13 @@ nm_ap_class_init (NMAccessPointClass *ap_class)
                                    G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY |
                                    G_PARAM_STATIC_STRINGS));
 
+       g_object_class_install_property
+               (object_class, PROP_LAST_SEEN,
+                g_param_spec_int (NM_AP_LAST_SEEN, "", "",
+                                  -1, G_MAXINT, -1,
+                                   G_PARAM_READABLE |
+                                   G_PARAM_STATIC_STRINGS));
+
        nm_dbus_manager_register_exported_type (nm_dbus_manager_get (),
                                                G_TYPE_FROM_CLASS (ap_class),
                                                &dbus_glib_nm_access_point_object_info);
@@ -1055,7 +1069,7 @@ void nm_ap_set_fake (NMAccessPoint *ap, gboolean fake)
 gint32
 nm_ap_get_last_seen (const NMAccessPoint *ap)
 {
-       g_return_val_if_fail (NM_IS_AP (ap), FALSE);
+       g_return_val_if_fail (NM_IS_AP (ap), 0);
 
        return NM_AP_GET_PRIVATE (ap)->last_seen;
 }
@@ -1063,9 +1077,16 @@ nm_ap_get_last_seen (const NMAccessPoint *ap)
 void
 nm_ap_set_last_seen (NMAccessPoint *ap, gint32 last_seen)
 {
+       NMAccessPointPrivate *priv;
+
        g_return_if_fail (NM_IS_AP (ap));
 
-       NM_AP_GET_PRIVATE (ap)->last_seen = last_seen;
+       priv = NM_AP_GET_PRIVATE (ap);
+
+       if (priv->last_seen != last_seen) {
+               priv->last_seen = last_seen;
+               g_object_notify (G_OBJECT (ap), NM_AP_LAST_SEEN);
+       }
 }
 
 static guint
index bcbf7ee..2bdb023 100644 (file)
@@ -43,6 +43,7 @@
 #define NM_AP_MODE "mode"
 #define NM_AP_MAX_BITRATE "max-bitrate"
 #define NM_AP_STRENGTH "strength"
+#define NM_AP_LAST_SEEN "last-seen"
 
 typedef struct {
        GObject parent;