Top |
The MMManager is the object allowing access to the Manager interface.
This object is also a GDBusObjectManagerClient, and therefore it allows to use the standard ObjectManager interface to list and handle the managed modem objects.
GDBusProxy *
mm_manager_peek_proxy (MMManager *manager
);
Gets the GDBusProxy interface of the manager
.
The GDBusProxy interface of manager
, or NULL if none. Do not free the returned object, it is owned by manager
.
[transfer none]
GDBusProxy *
mm_manager_get_proxy (MMManager *manager
);
Gets the GDBusProxy interface of the manager
.
The GDBusProxy interface of manager
, or NULL if none. The returned object must be freed with g_object_unref()
.
[transfer full]
void mm_manager_new (GDBusConnection *connection
,GDBusObjectManagerClientFlags flags
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously creates a MMManager.
When the operation is finished, callback
will be invoked in the
of the thread you are calling this method from.
You can then call mm_manager_new_finish()
to get the result of the operation.
See mm_manager_new_sync()
for the synchronous, blocking version of this constructor.
connection |
||
flags |
Flags from the GDBusObjectManagerClientFlags enumeration. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied. |
|
user_data |
User data to pass to |
MMManager * mm_manager_new_finish (GAsyncResult *res
,GError **error
);
Finishes an operation started with mm_manager_new()
.
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
The constructed object manager client or NULL
if error
is set.
[transfer full][type MMManager]
MMManager * mm_manager_new_sync (GDBusConnection *connection
,GDBusObjectManagerClientFlags flags
,GCancellable *cancellable
,GError **error
);
Synchronously creates a MMManager.
The calling thread is blocked until a reply is received.
See mm_manager_new()
for the asynchronous version of this constructor.
connection |
||
flags |
Flags from the GDBusObjectManagerClientFlags enumeration. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
The constructed object manager client or NULL
if error
is set.
[transfer full][type MMManager]
const gchar *
mm_manager_get_version (MMManager *manager
);
Gets the ModemManager version, as reported by the daemon.
It is safe to assume this value never changes during runtime.
The version, or NULL
if none available. Do not free the returned value, it belongs to self
.
[transfer none]
void mm_manager_scan_devices (MMManager *manager
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously requests to scan looking for devices.
When the operation is finished, callback
will be invoked in the
of the thread you are calling this method from. You can then call
mm_manager_scan_devices_finish()
to get the result of the operation.
See mm_manager_scan_devices_sync()
for the synchronous, blocking version of this method.
manager |
A MMManager. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_manager_scan_devices_finish (MMManager *manager
,GAsyncResult *res
,GError **error
);
Finishes an operation started with mm_manager_scan_devices()
.
manager |
A MMManager. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_manager_scan_devices_sync (MMManager *manager
,GCancellable *cancellable
,GError **error
);
Synchronously requests to scan looking for devices.
The calling thread is blocked until a reply is received.
See mm_manager_scan_devices()
for the asynchronous version of this method.
manager |
A MMManager. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
void mm_manager_inhibit_device (MMManager *manager
,const gchar *uid
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously requests to add an inhibition on the device identified by uid
.
The uid
must be the unique ID retrieved from an existing MMModem using
mm_modem_get_device()
. The caller should keep track of this uid
and use it
in the mm_manager_uninhibit_device()
call when the inhibition is no longer required.
The inhibition added with this method may also be automatically removed when
the caller program disappears from the bus (e.g. if the program ends before
having called mm_manager_uninhibit_device()
explicitly).
When the operation is finished, callback
will be invoked in the
of the thread you are calling this method from. You can then call
mm_manager_inhibit_device_finish()
to get the result of the operation.
See mm_manager_inhibit_device_sync()
for the synchronous, blocking version of this method.
manager |
A MMManager. |
|
uid |
the unique ID of the physical device. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_manager_inhibit_device_finish (MMManager *manager
,GAsyncResult *res
,GError **error
);
Finishes an operation started with mm_manager_inhibit_device()
.
manager |
A MMManager. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_manager_inhibit_device_sync (MMManager *manager
,const gchar *uid
,GCancellable *cancellable
,GError **error
);
Synchronously requests to add an inhibition on the device identified by uid
.
The uid
must be the unique ID retrieved from an existing MMModem using
mm_modem_get_device()
. The caller should keep track of this uid
and use it
in the mm_manager_uninhibit_device_sync()
call when the inhibition is no longer required.
The inhibition added with this method may also be automatically removed when
the caller program disappears from the bus (e.g. if the program ends before
having called mm_manager_uninhibit_device_sync()
explicitly).
See mm_manager_inhibit_device()
for the asynchronous version of this method.
manager |
A MMManager. |
|
uid |
the unique ID of the physical device. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
void mm_manager_uninhibit_device (MMManager *manager
,const gchar *uid
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously requests to remove an inhibition on the device identified by uid
.
The uid
must be the same unique ID that was sent in the inhibition request.
Only the same program that placed an inhibition on a given device is able to remove the inhibition.
When the operation is finished, callback
will be invoked in the
of the thread you are calling this method from. You can then call
mm_manager_uninhibit_device_finish()
to get the result of the operation.
See mm_manager_uninhibit_device_sync()
for the synchronous, blocking version of this method.
manager |
A MMManager. |
|
uid |
the unique ID of the physical device. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_manager_uninhibit_device_finish (MMManager *manager
,GAsyncResult *res
,GError **error
);
Finishes an operation started with mm_manager_uninhibit_device()
.
manager |
A MMManager. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_manager_uninhibit_device_sync (MMManager *manager
,const gchar *uid
,GCancellable *cancellable
,GError **error
);
Synchronously requests to remove an inhibition on the device identified by uid
.
The uid
must be the same unique ID that was sent in the inhibition request.
Only the same program that placed an inhibition on a given device is able to remove the inhibition.
See mm_manager_uninhibit_device()
for the asynchronous version of this method.
manager |
A MMManager. |
|
uid |
the unique ID of the physical device. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
void mm_manager_set_logging (MMManager *manager
,const gchar *level
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously requests to set the specified logging level in the daemon.
When the operation is finished, callback
will be invoked in the
of the thread you are calling this method from. You can then call
mm_manager_set_logging_finish()
to get the result of the operation.
See mm_manager_set_logging_sync()
for the synchronous, blocking version of this method.
manager |
A MMManager. |
|
level |
the login level to set. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_manager_set_logging_finish (MMManager *manager
,GAsyncResult *res
,GError **error
);
Finishes an operation started with mm_manager_set_logging()
.
manager |
A MMManager. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_manager_set_logging_sync (MMManager *manager
,const gchar *level
,GCancellable *cancellable
,GError **error
);
Synchronously requests to set the specified logging level in the daemon..
The calling thread is blocked until a reply is received.
See mm_manager_set_logging()
for the asynchronous version of this method.
manager |
A MMManager. |
|
level |
the login level to set. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
void mm_manager_report_kernel_event (MMManager *manager
,MMKernelEventProperties *properties
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Asynchronously report kernel event.
When the operation is finished, callback
will be invoked in the
of the thread you are calling this method from. You can then call
mm_manager_report_kernel_event_finish()
to get the result of the operation.
See mm_manager_report_kernel_event_sync()
for the synchronous, blocking version of this method.
manager |
A MMManager. |
|
properties |
the properties of the kernel event. |
|
cancellable |
A GCancellable or |
[allow-none] |
callback |
A GAsyncReadyCallback to call when the request is satisfied or |
|
user_data |
User data to pass to |
gboolean mm_manager_report_kernel_event_finish (MMManager *manager
,GAsyncResult *res
,GError **error
);
Finishes an operation started with mm_manager_report_kernel_event()
.
manager |
A MMManager. |
|
res |
The GAsyncResult obtained from the GAsyncReadyCallback passed to |
|
error |
Return location for error or |
gboolean mm_manager_report_kernel_event_sync (MMManager *manager
,MMKernelEventProperties *properties
,GCancellable *cancellable
,GError **error
);
Synchronously report kernel event.
The calling thread is blocked until a reply is received.
See mm_manager_report_kernel_event()
for the asynchronous version of this method.
manager |
A MMManager. |
|
properties |
the properties of the kernel event. |
|
cancellable |
A GCancellable or |
[allow-none] |
error |
Return location for error or |
struct MMManager;
The MMManager structure contains private data and should only be accessed using the provided API.