diff options
author | Michal Mazur <mkm@semihalf.com> | 2021-10-22 15:37:25 +0200 |
---|---|---|
committer | Michal Mazur <mkm@semihalf.com> | 2021-10-22 16:23:40 +0200 |
commit | c487ca1b36dd1aa14cb45e4555fbf3235b7ca784 (patch) | |
tree | 9baa0dbcf1793c5c2f61d883cb94efff82e6981c | |
parent | 9d82d309782c70ed7247db32902f48adebe90669 (diff) |
libmm-glib: add documentation for disable_facility_lock
-rw-r--r-- | libmm-glib/mm-modem-3gpp.c | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/libmm-glib/mm-modem-3gpp.c b/libmm-glib/mm-modem-3gpp.c index 42639e1c..6aac39b4 100644 --- a/libmm-glib/mm-modem-3gpp.c +++ b/libmm-glib/mm-modem-3gpp.c @@ -1159,6 +1159,26 @@ mm_modem_3gpp_set_initial_eps_bearer_settings_sync (MMModem3gpp *self, /*****************************************************************************/ +/** + * mm_modem_3gpp_disable_facility_lock: + * @self: A #MMModem3gpp. + * @facility: Single bit value describing the modem personalization lock to disable. + * @control_key: String with control key required to unlock the personalization. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @callback: A #GAsyncReadyCallback to call when the request is satisfied or + * %NULL. + * @user_data: User data to pass to @callback. + * + * Asynchronously disables the modem personalization lock. + * + * When the operation is finished, @callback will be invoked in the + * <link linkend="g-main-context-push-thread-default">thread-default main loop</link> + * of the thread you are calling this method from. You can then call + * mm_modem_3gpp_disable_facility_lock_finish() to get the result of + * the operation. + * + * Since: 1.20 + */ void mm_modem_3gpp_disable_facility_lock (MMModem3gpp *self, MMModem3gppFacility facility, @@ -1178,6 +1198,19 @@ mm_modem_3gpp_disable_facility_lock (MMModem3gpp *self, g_variant_unref (properties); } +/** + * mm_modem_3gpp_disable_facility_lock_finish: + * @self: A #MMModem3gpp. + * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to + * mm_modem_3gpp_disable_facility_lock(). + * @error: Return location for error or %NULL. + * + * Finishes an operation started with mm_modem_3gpp_disable_facility_lock(). + * + * Returns: %TRUE if the operation was successful, %FALSE if @error is set. + * + * Since: 1.20 + */ gboolean mm_modem_3gpp_disable_facility_lock_finish (MMModem3gpp *self, GAsyncResult *res, @@ -1188,6 +1221,24 @@ mm_modem_3gpp_disable_facility_lock_finish (MMModem3gpp *self, error); } +/** + * mm_modem_3gpp_disable_facility_lock_sync: + * @self: A #MMModem3gpp. + * @facility: Single bit value describing the modem personalization lock to disable. + * @control_key: String with control key required to unlock the personalization. + * @cancellable: (allow-none): A #GCancellable or %NULL. + * @error: Return location for error or %NULL. + * + * Synchronously disables facility lock. + * + * The calling thread is blocked until a reply is received. + * See mm_modem_3gpp_disable_facility_lock() for the asynchronous + * version of this method. + * + * Returns: %TRUE if the operation was successful, %FALSE if @error is set. + * + * Since: 1.20 + */ gboolean mm_modem_3gpp_disable_facility_lock_sync (MMModem3gpp *self, MMModem3gppFacility facility, |