From 8e67d2375c8280235b5125e73ccf1e0973c28319 Mon Sep 17 00:00:00 2001
From: lvmaorui <ZRMaorui.Lu@fibocom.com>
Date: Fri, 26 Mar 2021 16:38:45 +0800
Subject: docs,libmm-glib: add SAR user-level api

---
 libmm-glib/mm-object.c | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

(limited to 'libmm-glib/mm-object.c')

diff --git a/libmm-glib/mm-object.c b/libmm-glib/mm-object.c
index de446942..fd582292 100644
--- a/libmm-glib/mm-object.c
+++ b/libmm-glib/mm-object.c
@@ -595,6 +595,51 @@ mm_object_peek_modem_firmware (MMObject *self)
 
 /*****************************************************************************/
 
+/**
+ * mm_object_get_modem_sar:
+ * @self: A #MMObject.
+ *
+ * Gets the #MMModemSar instance for the D-Bus interface
+ * org.freedesktop.ModemManager1.Modem.Sar on @self, if any.
+ *
+ * Returns: (transfer full): A #MMModemSar that must be freed with
+ * g_object_unref() or %NULL if @self does not implement the interface.
+ *
+ * Since: 1.20
+ */
+MMModemSar *
+mm_object_get_modem_sar (MMObject *self)
+{
+    g_return_val_if_fail (MM_IS_OBJECT (MM_GDBUS_OBJECT (self)), NULL);
+
+    return (MMModemSar *)mm_gdbus_object_get_modem_sar (MM_GDBUS_OBJECT (self));
+}
+
+/**
+ * mm_object_peek_modem_sar: (skip)
+ * @self: A #MMObject.
+ *
+ * Like mm_object_get_modem_sar() but doesn't increase the reference count
+ * on the returned object.
+ *
+ * <warning>It is not safe to use the returned object if you are on another
+ * thread than the one where the #MMManager is running.</warning>
+ *
+ * Returns: (transfer none): A #MMModemSar or %NULL if @self does not
+ * implement the interface. Do not free the returned object, it is owned by
+ * @self.
+ *
+ * Since: 1.20
+ */
+MMModemSar *
+mm_object_peek_modem_sar (MMObject *self)
+{
+    g_return_val_if_fail (MM_IS_OBJECT (MM_GDBUS_OBJECT (self)), NULL);
+
+    return (MMModemSar *)mm_gdbus_object_peek_modem_sar (MM_GDBUS_OBJECT (self));
+}
+/*****************************************************************************/
+
 /**
  * mm_object_get_modem_signal:
  * @self: A #MMObject.
-- 
cgit v1.2.3-70-g09d2