diff options
Diffstat (limited to 'libmm-glib/mm-modem.c')
-rw-r--r-- | libmm-glib/mm-modem.c | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/libmm-glib/mm-modem.c b/libmm-glib/mm-modem.c index 6b9357a0..b575a300 100644 --- a/libmm-glib/mm-modem.c +++ b/libmm-glib/mm-modem.c @@ -538,6 +538,47 @@ mm_modem_dup_plugin (MMModem *self) /*****************************************************************************/ /** + * mm_modem_get_primary_port: + * @self: A #MMModem. + * + * Gets the name of the primary port controlling this #MMModem. + * + * <warning>The returned value is only valid until the property changes so + * it is only safe to use this function on the thread where + * @self was constructed. Use mm_modem_dup_primary_port() if on another + * thread.</warning> + * + * Returns: (transfer none): The name of the primary port. Do not free the returned value, it belongs to @self. + */ +const gchar * +mm_modem_get_primary_port (MMModem *self) +{ + g_return_val_if_fail (MM_IS_MODEM (self), NULL); + + RETURN_NON_EMPTY_CONSTANT_STRING ( + mm_gdbus_modem_get_primary_port (MM_GDBUS_MODEM (self))); +} + +/** + * mm_modem_dup_primary_port: + * @self: A #MMModem. + * + * Gets a copy of the name of the primary port controlling this #MMModem. + * + * Returns: (transfer full): The name of the primary port. The returned value should be freed with g_free(). + */ +gchar * +mm_modem_dup_primary_port (MMModem *self) +{ + g_return_val_if_fail (MM_IS_MODEM (self), NULL); + + RETURN_NON_EMPTY_STRING ( + mm_gdbus_modem_dup_primary_port (MM_GDBUS_MODEM (self))); +} + +/*****************************************************************************/ + +/** * mm_modem_get_equipment_identifier: * @self: A #MMModem. * |