Functions
Eldbus_Proxy *	eldbus_proxy_get (Eldbus_Object obj, const char interface)
	Get a proxy of the following interface name in a Eldbus_Object.
Eldbus_Proxy *	eldbus_proxy_ref (Eldbus_Proxy *proxy)
	Increase proxy reference.
void	eldbus_proxy_unref (Eldbus_Proxy *proxy)
	Decrease proxy reference. If reference == 0 proxy will be freed and all your children.
Eldbus_Object *	eldbus_proxy_object_get (const Eldbus_Proxy *proxy)
	Get the Eldbus_Object associated with a proxy object.
const char *	eldbus_proxy_interface_get (const Eldbus_Proxy *proxy)
	Get the interface name associated with a proxy object.
void	eldbus_proxy_data_set (Eldbus_Proxy proxy, const char key, const void *data)
	Set data to an Eldbus_Proxy object.
void *	eldbus_proxy_data_get (const Eldbus_Proxy proxy, const char key)
	Get data of an Eldbus_Proxy object.
void *	eldbus_proxy_data_del (Eldbus_Proxy proxy, const char key)
	Delete data of an Eldbus_Proxy object.
void	eldbus_proxy_free_cb_add (Eldbus_Proxy proxy, Eldbus_Free_Cb cb, const void data)
	Add a callback function to be called when an event of the type passed occurs.
void	eldbus_proxy_free_cb_del (Eldbus_Proxy proxy, Eldbus_Free_Cb cb, const void data)
	Remove callback registered in eldbus_proxy_free_cb_add().
Eldbus_Message *	eldbus_proxy_method_call_new (Eldbus_Proxy proxy, const char member)
	Constructs a new message to invoke a method on a remote interface.
Eldbus_Pending *	eldbus_proxy_send (Eldbus_Proxy proxy, Eldbus_Message msg, Eldbus_Message_Cb cb, const void *cb_data, double timeout)
	Send a message.
Eldbus_Message *	eldbus_proxy_send_and_block (Eldbus_Proxy proxy, Eldbus_Message msg, double timeout)
	Send a message and block while waiting for the reply.
Eldbus_Pending *	eldbus_proxy_call (Eldbus_Proxy proxy, const char member, Eldbus_Message_Cb cb, const void cb_data, double timeout, const char signature,...)
	Call a method in proxy. Send a method call to interface that proxy belong with data.
Eldbus_Pending *	eldbus_proxy_vcall (Eldbus_Proxy proxy, const char member, Eldbus_Message_Cb cb, const void cb_data, double timeout, const char signature, va_list ap)
	Call a method in proxy. Send a method call to interface that proxy belong with data.
Eldbus_Signal_Handler *	eldbus_proxy_signal_handler_add (Eldbus_Proxy proxy, const char member, Eldbus_Signal_Cb cb, const void *cb_data)
	Add a signal handler.
void	eldbus_proxy_event_callback_add (Eldbus_Proxy proxy, Eldbus_Proxy_Event_Type type, Eldbus_Proxy_Event_Cb cb, const void cb_data)
	Add a callback function to be called when occurs a event of the type passed.
void	eldbus_proxy_event_callback_del (Eldbus_Proxy proxy, Eldbus_Proxy_Event_Type type, Eldbus_Proxy_Event_Cb cb, const void cb_data)
	Remove callback registered in eldbus_proxy_event_callback_add().
Typedefs
typedef struct _Eldbus_Proxy_Event_Property_Changed	Eldbus_Proxy_Event_Property_Changed
typedef struct _Eldbus_Proxy_Event_Property_Loaded	Eldbus_Proxy_Event_Property_Loaded
typedef struct _Eldbus_Proxy_Event_Property_Removed	Eldbus_Proxy_Event_Property_Removed
typedef void(*	Eldbus_Proxy_Event_Cb )(void data, Eldbus_Proxy proxy, void *event_info)

Typedef Documentation

Eldbus_Proxy_Event_Cb

A callback called when an event occurs.

Parameters:

data	The data passed by the caller.
proxy	The Eldbus_Proxy object.
event_info	Information on the event that triggered the callback.

Eldbus_Proxy_Event_Property_Changed

A structure used when ELDBUS_PROXY_EVENT_PROPERTY_CHANGED event is received.

Eldbus_Proxy_Event_Property_Loaded

A structure used when ELDBUS_PROXY_EVENT_PROPERTY_LOADED event is received.

Eldbus_Proxy_Event_Property_Removed

A structure used when ELDBUS_PROXY_EVENT_PROPERTY_REMOVED event is received.

Enumeration Type Documentation

enum Eldbus_Proxy_Event_Type

An enumeration containing proxy event types.

Enumerator:

ELDBUS_PROXY_EVENT_PROPERTY_CHANGED	a property has changed
ELDBUS_PROXY_EVENT_PROPERTY_REMOVED	a property was removed
ELDBUS_PROXY_EVENT_LAST	sentinel, not a real event type

Function Documentation

Eldbus_Pending* eldbus_proxy_call	(	Eldbus_Proxy *	proxy,
		const char *	member,
		Eldbus_Message_Cb	cb,
		const void *	cb_data,
		double	timeout,
		const char *	signature,
			...
	)

Call a method in proxy. Send a method call to interface that proxy belong with data.

Parameters:

proxy
member	method name
cb	if msg is a method call a callback should be passed to be execute when response arrive
cb_data	data passed to callback
timeout	timeout in milliseconds, -1 to default internal value or ELDBUS_TIMEOUT_INFINITE for no timeout
signature	of data that will be send
...	data value

Returns:: A Eldbus_Pending object on the sent message.

Note:: This function only support basic type to complex types use eldbus_message_iter_* functions.

Since :: 3.0

Examples:: banshee.c, client.c, complex-types-client-eina-value.c, complex-types.c, connman-list-services.c, and ofono-dial.c.

void* eldbus_proxy_data_del	(	Eldbus_Proxy *	proxy,
		const char *	key
	)

Delete data of an Eldbus_Proxy object.

Parameters:

proxy	The Eldbus_Proxy on which to delete the data.
key	The string to which the data is associated.

Since :: 3.0

void* eldbus_proxy_data_get	(	const Eldbus_Proxy *	proxy,
		const char *	key
	)

Get data of an Eldbus_Proxy object.

Parameters:

proxy	The Eldbus_Proxy on which to get the data.
key	The string to which the data is associated.

Returns:: The data set to the proxy object associated with the provided key.

Since :: 3.0

void eldbus_proxy_data_set	(	Eldbus_Proxy *	proxy,
		const char *	key,
		const void *	data
	)

Set data to an Eldbus_Proxy object.

Parameters:

proxy	The Eldbus_Proxy on which to set the data.
key	A string to which the data will be associated.
data	The data to set to the proxy object.

Since :: 3.0

void eldbus_proxy_event_callback_add	(	Eldbus_Proxy *	proxy,
		Eldbus_Proxy_Event_Type	type,
		Eldbus_Proxy_Event_Cb	cb,
		const void *	cb_data
	)

Add a callback function to be called when occurs a event of the type passed.

Parameters:

proxy	The Eldbus_Proxy object.
type	The type of the event to register an callback on.
cb	The callback function to register.
cb_data	The data to pass to the callback.

Since :: 3.0

Examples:: complex-types-client-eina-value.c.

void eldbus_proxy_event_callback_del	(	Eldbus_Proxy *	proxy,
		Eldbus_Proxy_Event_Type	type,
		Eldbus_Proxy_Event_Cb	cb,
		const void *	cb_data
	)

Remove callback registered in eldbus_proxy_event_callback_add().

Parameters:

proxy	The Eldbus_Proxy object.
type	The type of the event the callback was registered on.
cb	The callback function to delete.
cb_data	The data passed to the callback.

Since :: 3.0

Examples:: complex-types-client-eina-value.c.

void eldbus_proxy_free_cb_add	(	Eldbus_Proxy *	proxy,
		Eldbus_Free_Cb	cb,
		const void *	data
	)

Add a callback function to be called when an event of the type passed occurs.

Parameters:

proxy	The Eldbus_Proxy on which to add the callback.
cb	The callback to add.
data	The data to pass to the callback.

Since :: 3.0

void eldbus_proxy_free_cb_del	(	Eldbus_Proxy *	proxy,
		Eldbus_Free_Cb	cb,
		const void *	data
	)

Remove callback registered in eldbus_proxy_free_cb_add().

Parameters:

proxy	The Eldbus_Proxy on which to delete the callback.
cb	The callback to delete.
data	The data passed to the callback.

Since :: 3.0

Eldbus_Proxy* eldbus_proxy_get	(	Eldbus_Object *	obj,
		const char *	interface
	)

Get a proxy of the following interface name in a Eldbus_Object.

Parameters:

obj	The Eldbus_Object on which to do the query.
interface	The interface name of the proxy.

Returns:: The corresponding Eldbus_Proxy object.

Since :: 3.0

Examples:: banshee.c, client.c, complex-types-client-eina-value.c, complex-types.c, connman-list-services.c, and ofono-dial.c.

const char* eldbus_proxy_interface_get ( const Eldbus_Proxy * proxy )

Get the interface name associated with a proxy object.

Parameters:

proxy The Eldbus_Proxy on which to do the query.

Returns:: The string corresponding to the interface name.

Since :: 3.0

Eldbus_Message* eldbus_proxy_method_call_new	(	Eldbus_Proxy *	proxy,
		const char *	member
	)

Constructs a new message to invoke a method on a remote interface.

Parameters:

proxy	The Eldbus_Proxy on which to call the method.
member	The name of the method to invoke.

Returns:: An Eldbus_Message object.

Since :: 3.0

Examples:: complex-types-client-eina-value.c, and complex-types.c.

Eldbus_Object* eldbus_proxy_object_get ( const Eldbus_Proxy * proxy )

Get the Eldbus_Object associated with a proxy object.

Parameters:

proxy The Eldbus_Proxy on which to do the query.

Returns:: The corresponding Eldbus_Object.

Since :: 3.0

Eldbus_Proxy* eldbus_proxy_ref ( Eldbus_Proxy * proxy )

Increase proxy reference.

Parameters:

proxy The Eldbus_Proxy on which to increase the refcount.

Returns:: The Eldbus_Proxy with an increased refcount.

Since :: 3.0

Eldbus_Pending* eldbus_proxy_send	(	Eldbus_Proxy *	proxy,
		Eldbus_Message *	msg,
		Eldbus_Message_Cb	cb,
		const void *	cb_data,
		double	timeout
	)

Send a message.

Parameters:

proxy	the msg will be send in connection that proxy belongs
msg	message that will be send
cb	if msg is a method call a callback should be passed
cb_data	data passed to callback
timeout	timeout in milliseconds, -1 to default internal value or ELDBUS_TIMEOUT_INFINITE for no timeout

Returns:: A Eldbus_Pending object on the sent message.

Since :: 3.0

Examples:: complex-types-client-eina-value.c, and complex-types.c.

Eldbus_Message* eldbus_proxy_send_and_block	(	Eldbus_Proxy *	proxy,
		Eldbus_Message *	msg,
		double	timeout
	)

Send a message and block while waiting for the reply.

Parameters:

proxy	the msg will be send in connection that proxy belongs
msg	message that will be send
timeout	timeout in milliseconds, -1 to default internal value or ELDBUS_TIMEOUT_INFINITE for no timeout

Returns:: The reply message, error message or NULL. The returned Eldbus_Message need to be unref after read.

Since (EFL) :: 1.13

Since :: 3.0

Eldbus_Signal_Handler* eldbus_proxy_signal_handler_add	(	Eldbus_Proxy *	proxy,
		const char *	member,
		Eldbus_Signal_Cb	cb,
		const void *	cb_data
	)

Add a signal handler.

Parameters:

proxy	interface where the signal is emitted
member	name of the signal
cb	callback that will be called when this signal is received
cb_data	data that will be passed to callback

Returns:: A listener to the desired signal.

Since :: 3.0

Examples:: banshee.c, and client.c.

void eldbus_proxy_unref ( Eldbus_Proxy * proxy )

Decrease proxy reference. If reference == 0 proxy will be freed and all your children.

Parameters:

proxy The Eldbus_Proxy on which to decrease the refcount.

Since :: 3.0

Examples:: connman-list-services.c, and ofono-dial.c.

Eldbus_Pending* eldbus_proxy_vcall	(	Eldbus_Proxy *	proxy,
		const char *	member,
		Eldbus_Message_Cb	cb,
		const void *	cb_data,
		double	timeout,
		const char *	signature,
		va_list	ap
	)

Call a method in proxy. Send a method call to interface that proxy belong with data.

Parameters:

proxy
member	method name
cb	callback that will be called when response arrive.
cb_data	data passed to callback
timeout	timeout in milliseconds, -1 to default internal value or ELDBUS_TIMEOUT_INFINITE for no timeout
signature	of data that will be send
ap	va_list of data value

Returns:: A Eldbus_Pending object on the sent message.

Note:: This function only support basic type to complex types use eldbus_message_iter_* functions.

Since :: 3.0

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation