telepathy-glib API Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
#include <telepathy-glib/telepathy-glib.h> TpDebugClient; TpDebugClientClass; TpProxyPendingCall * tp_cli_debug_call_get_messages (TpDebugClient *proxy
,gint timeout_ms
,tp_cli_debug_callback_for_get_messages callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
); void (*tp_cli_debug_callback_for_get_messages) (TpDebugClient *proxy
,const GPtrArray *out_Messages
,const GError *error
,gpointer user_data
,GObject *weak_object
); TpProxySignalConnection * tp_cli_debug_connect_to_new_debug_message (TpDebugClient *proxy
,tp_cli_debug_signal_callback_new_debug_message callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
,GError **error
); void (*tp_cli_debug_signal_callback_new_debug_message) (TpDebugClient *proxy
,gdouble arg_time
,const gchar *arg_domain
,guint arg_level
,const gchar *arg_message
,gpointer user_data
,GObject *weak_object
); void tp_debug_client_init_known_interfaces (void
); TpDebugClient * tp_debug_client_new (TpDBusDaemon *dbus
,const gchar *unique_name
,GError **error
); void tp_debug_client_set_enabled_async (TpDebugClient *self
,gboolean enabled
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tp_debug_client_set_enabled_finish (TpDebugClient *self
,GAsyncResult *result
,GError **error
); gboolean tp_debug_client_is_enabled (TpDebugClient *self
);
typedef struct _TpDebugClient TpDebugClient;
A proxy object for the debug interface of a Telepathy component.
Since 0.19.0
typedef struct _TpDebugClientClass TpDebugClientClass;
The class of a TpDebugClient.
Since 0.19.0
TpProxyPendingCall * tp_cli_debug_call_get_messages (TpDebugClient *proxy
,gint timeout_ms
,tp_cli_debug_callback_for_get_messages callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
);
Start a GetMessages method call.
Retrieve buffered debug messages. An implementation could have a limit on how many message it keeps and so the array returned from this method should not be assumed to be all of the messages in the lifetime of the service.
|
the TpProxy |
|
the timeout in milliseconds, or -1 to use the default |
|
called when the method call succeeds or fails;
may be NULL to make a "fire and forget" call with no
reply tracking |
|
user-supplied data passed to the callback;
must be NULL if callback is NULL
|
|
called with the user_data as argument, after the
call has succeeded, failed or been cancelled;
must be NULL if callback is NULL
|
|
If not NULL , a GObject which will be
weakly referenced; if it is destroyed, this call
will automatically be cancelled. Must be NULL if
callback is NULL
|
Returns : |
a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid. |
void (*tp_cli_debug_callback_for_get_messages) (TpDebugClient *proxy
,const GPtrArray *out_Messages
,const GError *error
,gpointer user_data
,GObject *weak_object
);
Signature of the callback called when a GetMessages method call succeeds or fails.
|
the proxy on which the call was made |
|
Used to return an 'out' argument if error is NULL : A list of debug messages. |
|
NULL on success, or an error on failure |
|
user-supplied data |
|
user-supplied object |
TpProxySignalConnection * tp_cli_debug_connect_to_new_debug_message (TpDebugClient *proxy
,tp_cli_debug_signal_callback_new_debug_message callback
,gpointer user_data
,GDestroyNotify destroy
,GObject *weak_object
,GError **error
);
Connect a handler to the signal NewDebugMessage.
Emitted when a debug messages is generated if the <tp:member-ref>Enabled</tp:member-ref> property is set to TRUE.
|
A TpDebugClient or subclass |
|
Callback to be called when the signal is received |
|
User-supplied data for the callback |
|
Destructor for the user-supplied data, which
will be called when this signal is disconnected, or
before this function returns NULL
|
|
A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected |
|
If not NULL , used to raise an error if NULL is
returned |
Returns : |
a TpProxySignalConnection containing all of the
above, which can be used to disconnect the signal; or
NULL if the proxy does not have the desired interface
or has become invalid. |
void (*tp_cli_debug_signal_callback_new_debug_message) (TpDebugClient *proxy
,gdouble arg_time
,const gchar *arg_domain
,guint arg_level
,const gchar *arg_message
,gpointer user_data
,GObject *weak_object
);
Represents the signature of a callback for the signal NewDebugMessage.
|
The proxy on which tp_cli_debug_connect_to_new_debug_message()
was called |
|
Timestamp of the debug message. |
|
Domain of the debug message, as described in the Debug_Message struct. |
|
Level of the debug message. (TpDebugLevel) |
|
The text of the debug message. |
|
User-supplied data |
|
User-supplied weakly referenced object |
void tp_debug_client_init_known_interfaces
(void
);
Ensure that the known interfaces for TpDebugClient have been set up.
This is done automatically when necessary, but for correct
overriding of library interfaces by local extensions, you should
call this function before calling
tp_proxy_or_subclass_hook_on_interface_add()
with first argument
TP_TYPE_DEBUG_CLIENT
.
Since 0.19.0
TpDebugClient * tp_debug_client_new (TpDBusDaemon *dbus
,const gchar *unique_name
,GError **error
);
|
a D-Bus daemon; may not be NULL
|
|
the unique name of the process to be debugged; may not be
NULL or a well-known name |
|
used to raise an error if unique_name is not valid |
Returns : |
a new debug client proxy, or NULL on invalid arguments |
Since 0.19.0
void tp_debug_client_set_enabled_async (TpDebugClient *self
,gboolean enabled
,GAsyncReadyCallback callback
,gpointer user_data
);
Enable or disable publishing of debug messages on the bus by the component
owning self
's bus name.
|
a TpDebugClient |
|
TRUE if debug messages should be published on the bus, FALSE
otherwise |
|
a callback to call when the request is satisfied |
|
data to pass to callback
|
Since 0.19.0
gboolean tp_debug_client_set_enabled_finish (TpDebugClient *self
,GAsyncResult *result
,GError **error
);
Finishes tp_debug_client_set_enabled_async()
.
|
a TpDebugClient |
|
a GAsyncResult |
|
a GError to fill |
Returns : |
TRUE , if the operation suceeded, FALSE otherwise |
Since 0.19.0
gboolean tp_debug_client_is_enabled (TpDebugClient *self
);
Return the "enabled" property
|
a TpDebugClient |
Returns : |
the value of "enabled" property |
Since 0.19.0
"new-debug-message"
signalvoid user_function (TpDebugClient *self,
TpDebugMessage *message,
gpointer user_data) : Run Last
Emitted when a TpDebugMessage is generated if the TpDebugMessage:enabled
property is set to TRUE
.
|
a TpDebugClient |
|
a TpDebugMessage |
|
user data set when the signal handler was connected. |
Since 0.19.0