Signal Handler

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().
const char *	eldbus_signal_handler_sender_get (const Eldbus_Signal_Handler *handler)
const char *	eldbus_signal_handler_path_get (const Eldbus_Signal_Handler *handler)
const char *	eldbus_signal_handler_interface_get (const Eldbus_Signal_Handler *handler)
const char *	eldbus_signal_handler_member_get (const Eldbus_Signal_Handler *handler)
const char *	eldbus_signal_handler_match_get (const Eldbus_Signal_Handler *handler)
Eldbus_Connection *	eldbus_signal_handler_connection_get (const Eldbus_Signal_Handler *handler)

---

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.

Deprecated:

Deprecated since 4.0.

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

Eldbus_Connection* eldbus_signal_handler_connection_get

(

const Eldbus_Signal_Handler *

handler

)

eldbus_signal_handler_connection_get

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.

Deprecated:

Deprecated since 4.0.

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.

Deprecated:

Deprecated since 4.0.

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().

Deprecated:

Deprecated since 4.0.

Since :

3.0

const char* eldbus_signal_handler_interface_get

(

const Eldbus_Signal_Handler *

handler

)

Deprecated:

Deprecated since 4.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.

Deprecated:

Deprecated since 4.0.

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

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.

Deprecated:

Deprecated since 4.0.

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

const char* eldbus_signal_handler_match_get

(

const Eldbus_Signal_Handler *

handler

)

Deprecated:

Deprecated since 4.0.

const char* eldbus_signal_handler_member_get

(

const Eldbus_Signal_Handler *

handler

)

Deprecated:

Deprecated since 4.0.

const char* eldbus_signal_handler_path_get

(

const Eldbus_Signal_Handler *

handler

)

Deprecated:

Deprecated since 4.0.

Eldbus_Signal_Handler* eldbus_signal_handler_ref

(

Eldbus_Signal_Handler *

handler

)

Increase signal handler reference.

Deprecated:

Deprecated since 4.0.

Since :

3.0

const char* eldbus_signal_handler_sender_get

(

const Eldbus_Signal_Handler *

handler

)

Deprecated:

Deprecated since 4.0.

void eldbus_signal_handler_unref

(

Eldbus_Signal_Handler *

handler

)

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

Deprecated:

Deprecated since 4.0.

Since :

3.0