Functions
Eldbus_Signal_Handler *	eldbus_signal_handler_add (Eldbus_Connection conn, const char sender, const char path, const char interface, const char member, Eldbus_Signal_Cb cb, const void cb_data)
	Add a signal handler.
Eldbus_Signal_Handler *	eldbus_signal_handler_ref (Eldbus_Signal_Handler *handler)
	Increase signal handler reference.
void	eldbus_signal_handler_unref (Eldbus_Signal_Handler *handler)
	Decrease signal handler reference. If reference == 0 signal handler will be freed.
void	eldbus_signal_handler_del (Eldbus_Signal_Handler *handler)
	Decrease signal handler reference like eldbus_signal_handler_unref() but if reference > 0 this signal handler will stop listening to signals. In other words it will be canceled but memory will not be freed.
Eina_Bool	eldbus_signal_handler_match_extra_set (Eldbus_Signal_Handler *sh,...) EINA_SENTINEL
	Add extra argument in match of signal handler to obtain specifics signals.
Eina_Bool	eldbus_signal_handler_match_extra_vset (Eldbus_Signal_Handler *sh, va_list ap)
	Add extra argument in match of signal handler to obtain specifics signals.
void	eldbus_signal_handler_free_cb_add (Eldbus_Signal_Handler handler, Eldbus_Free_Cb cb, const void data)
	Add a callback function to be called when signal handler will be freed.
void	eldbus_signal_handler_free_cb_del (Eldbus_Signal_Handler handler, Eldbus_Free_Cb cb, const void data)
	Remove callback registered in eldbus_signal_handler_free_cb_add().

Function Documentation

Eldbus_Signal_Handler* eldbus_signal_handler_add	(	Eldbus_Connection *	conn,
		const char *	sender,
		const char *	path,
		const char *	interface,
		const char *	member,
		Eldbus_Signal_Cb	cb,
		const void *	cb_data
	)

Add a signal handler.

Parameters:

conn	connection where the signal is emitted
sender	bus name or unique id of where the signal is emitted
path	path of remote object
interface	that signal belongs
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

Since :: 3.0

Examples:: banshee.c.

void eldbus_signal_handler_del ( Eldbus_Signal_Handler * handler )

Decrease signal handler reference like eldbus_signal_handler_unref() but if reference > 0 this signal handler will stop listening to signals. In other words it will be canceled but memory will not be freed.

Since :: 3.0

void eldbus_signal_handler_free_cb_add	(	Eldbus_Signal_Handler *	handler,
		Eldbus_Free_Cb	cb,
		const void *	data
	)

Add a callback function to be called when signal handler will be freed.

Since :: 3.0

void eldbus_signal_handler_free_cb_del	(	Eldbus_Signal_Handler *	handler,
		Eldbus_Free_Cb	cb,
		const void *	data
	)

Remove callback registered in eldbus_signal_handler_free_cb_add().

Since :: 3.0

Eina_Bool eldbus_signal_handler_match_extra_set	(	Eldbus_Signal_Handler *	sh,
			...
	)

Add extra argument in match of signal handler to obtain specifics signals.

Example: eldbus_signal_handler_match_extra_set(sh, "arg0", "org.bansheeproject.Banshee", "arg1", "", NULL); With this extra arguments this signal handler callback only will be called when Banshee is started.

Note:: For now only argX is supported.

Parameters:

sh	signal handler
...	variadic of key and value and must be ended with a NULL

Note:: For more information: http://dbus.freedesktop.org/doc/dbus-specification.html#message-bus-routing-match-rules

Since :: 3.0

Examples:: banshee.c.

Eina_Bool eldbus_signal_handler_match_extra_vset	(	Eldbus_Signal_Handler *	sh,
		va_list	ap
	)

Add extra argument in match of signal handler to obtain specifics signals.

Example: eldbus_signal_handler_match_extra_set(sh, "arg0", "org.bansheeproject.Banshee", "arg1", "", NULL); With this extra arguments this signal handler callback only will be called when Banshee is started.

Note:: For now is only supported argX.

Parameters:

sh	signal handler
ap	va_list with the keys and values, must be ended with a NULL

Note:: To information: http://dbus.freedesktop.org/doc/dbus-specification.html#message-bus-routing-match-rules

Since :: 3.0

Eldbus_Signal_Handler* eldbus_signal_handler_ref ( Eldbus_Signal_Handler * handler )

Increase signal handler reference.

Since :: 3.0

void eldbus_signal_handler_unref ( Eldbus_Signal_Handler * handler )

Decrease signal handler reference. If reference == 0 signal handler will be freed.

Since :: 3.0

Examples:: banshee.c.

Functions

Function Documentation