|  |  |  | libmm-glib Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | ||||
struct MMModemFirmware; const gchar * mm_modem_firmware_get_path (MMModemFirmware *self); gchar * mm_modem_firmware_dup_path (MMModemFirmware *self); void mm_modem_firmware_list (MMModemFirmware *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_modem_firmware_list_finish (MMModemFirmware *self,GAsyncResult *res,MMFirmwareProperties **selected,GList **installed,GError **error); gboolean mm_modem_firmware_list_sync (MMModemFirmware *self,MMFirmwareProperties **selected,GList **installed,GCancellable *cancellable,GError **error); void mm_modem_firmware_select (MMModemFirmware *self,const gchar *unique_id,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_modem_firmware_select_finish (MMModemFirmware *self,GAsyncResult *res,GError **error); gboolean mm_modem_firmware_select_sync (MMModemFirmware *self,const gchar *unique_id,GCancellable *cancellable,GError **error);
MMModemFirmware implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModemFirmware.
The MMModemFirmware is an object providing access to the methods, signals and properties of the Firmware interface.
The Firmware interface is exposed whenever a modem has firmware capabilities.
struct MMModemFirmware;
The MMModemFirmware structure contains private data and should only be accessed using the provided API.
const gchar *       mm_modem_firmware_get_path          (MMModemFirmware *self);
Gets the DBus path of the MMObject which implements this interface.
| 
 | A MMModemFirmware. | 
| Returns : | The DBus path of the MMObject object. [transfer none] | 
gchar *             mm_modem_firmware_dup_path          (MMModemFirmware *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
| 
 | A MMModemFirmware. | 
| Returns : | The DBus path of the MMObject. The returned value should be freed with g_free(). [transfer full] | 
void mm_modem_firmware_list (MMModemFirmware *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously gets the list of available firmware images.
When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_firmware_list_finish() to get the result of the operation.
See mm_modem_firmware_list_sync() for the synchronous, blocking version of this method.
| 
 | A MMModemFirmware. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | A GAsyncReadyCallback to call when the request is satisfied or NULL. | 
| 
 | User data to pass to callback. | 
gboolean mm_modem_firmware_list_finish (MMModemFirmware *self,GAsyncResult *res,MMFirmwareProperties **selected,GList **installed,GError **error);
Finishes an operation started with mm_modem_firmware_list().
| 
 | A MMModemFirmware. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_firmware_list(). | 
| 
 | The selected firmware slot, or NULL if no slot is selected (such as if all slots are empty, or no slots exist). The returned value should be freed with g_object_unref(). [out][allow-none][transfer full] | 
| 
 | A list of MMFirmwareProperties objects specifying the installed images. The returned value should be freed with g_list_free_full()usingg_object_unref()as GDestroyNotify. [out][allow-none][transfer full] | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the list was correctly retrieved,FALSEiferroris set. | 
gboolean mm_modem_firmware_list_sync (MMModemFirmware *self,MMFirmwareProperties **selected,GList **installed,GCancellable *cancellable,GError **error);
Synchronously gets the list of available firmware images.
The calling thread is blocked until a reply is received. See mm_modem_firmware_list()
for the asynchronous version of this method.
| 
 | A MMModemFirmware. | 
| 
 | The selected firmware slot, or NULL if no slot is selected (such as if all slots are empty, or no slots exist). The returned value should be freed with g_object_unref(). [out][allow-none][transfer full] | 
| 
 | A list of MMFirmwareProperties objects specifying the installed images. The returned value should be freed with g_list_free_full()usingg_object_unref()as GDestroyNotify. [out][allow-none][transfer full] | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return firmware for error or NULL. | 
| Returns : | TRUEif the list was correctly retrieved,FALSEiferroris set. | 
void mm_modem_firmware_select (MMModemFirmware *self,const gchar *unique_id,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously selects a firmware image to boot.
When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_firmware_select_finish() to get the result of the operation.
See mm_modem_firmware_select_sync() for the synchronous, blocking version of this method.
| 
 | A MMModemFirmware. | 
| 
 | Unique ID of the firmware image to select. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | A GAsyncReadyCallback to call when the request is satisfied or NULL. | 
| 
 | User data to pass to callback. | 
gboolean mm_modem_firmware_select_finish (MMModemFirmware *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_firmware_select().
| 
 | A MMModemFirmware. | 
| 
 | The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_firmware_select(). | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the selection was successful,FALSEiferroris set. | 
gboolean mm_modem_firmware_select_sync (MMModemFirmware *self,const gchar *unique_id,GCancellable *cancellable,GError **error);
Synchronously selects a firmware image to boot.
The calling thread is blocked until a reply is received. See mm_modem_firmware_select()
for the asynchronous version of this method.
| 
 | A MMModemFirmware. | 
| 
 | Unique ID of the firmware image to select. | 
| 
 | A GCancellable or NULL. [allow-none] | 
| 
 | Return location for error or NULL. | 
| Returns : | TRUEif the selection was successful,FALSEiferroris set. |