ext_signal
[service]

Collaboration diagram for ext_signal:

---

Detailed Description

Module for manage external signal handling

TO COMPLETE

Service Meta Information

Contact:

Daniele Rondina aka Ge@@ru <geaaru@gmail.com>

Status:

EasyDbus Core Library

License:

GPL

Contributor(s):

• Daniele Rondina aka Ge@@ru <geaaru@gmail.com>

Data Structures
struct	EasyDbus_ext_signal
	EasyDbus_ext_signal object. More...
Functions
int	easydbus_ext_signal_add_to_service (EasyDbus_conn *data, EasyDbus_ext_signal *signal)
	Add EasyDbus_ext_signal object for handled external signal.
EasyDbus_ext_signal *	easydbus_ext_signal_create (char *signal, char *path, char *interface, char *sender, char *destination, easydbus_ext_signal_callback_f signal_callback)
	Create EasyDbus_ext_signal object.
void	easydbus_ext_signal_free_skeleton (EasyDbus_ext_signal *signal)
	Free EasyDbus_ext_signal object.

---

Function Documentation

int easydbus_ext_signal_add_to_service	(	EasyDbus_conn *	data,
		EasyDbus_ext_signal *	signal
	)

Add EasyDbus_ext_signal object for handled external signal.

Parameters:

	data	pointer to EasyDbus_conn object.
	signal	pointer to EasyDbus_ext_signal object.

Returns:

-1 on error

0 ok

Definition at line 57 of file register_ext_signal.c.

References EasyDbus_core::handled_ext_signals, EasyDbus_core::handled_signal, EasyDbus_ext_signal::next, EasyDbus_ext_signal::signal, and EasyDbus_ext_signal::signal_callback.

{
   struct EasyDbus_core *core = (struct EasyDbus_core *) data;
   EasyDbus_ext_signal *el = NULL;

   if (!data || !signal || !signal->signal || 
        !signal->signal_callback)
      return -1;

   el = core->handled_ext_signals;

   if (el) {
      while (el->next != NULL)
         el = el->next;
      el->next = signal;
   }
   else {
      core->handled_signal = 1;
      core->handled_ext_signals = signal;
   }

   return 0;
}

EasyDbus_ext_signal* easydbus_ext_signal_create	(	char *	signal,
		char *	path,
		char *	interface,
		char *	sender,
		char *	destination,
		easydbus_ext_signal_callback_f	signal_callback
	)

Create EasyDbus_ext_signal object.

Precondition:

signal != NULL signal_callback != NULL

Parameters:

	signal	signal name
	path	path of signal (can be equal to NULL).
	interface	interface of signal (can be equal to NULL).
	sender	sender of signal. (can be equal to NULL).
	destination	destination of signal (can be equal to NULL).
	signal_callback	callback called when signal is handled.

Returns:

NULL error

pointer to struct EasyDbus_ext_signal.

Definition at line 125 of file register_ext_signal.c.

References EasyDbus_ext_signal::destination, easydbus_ext_signal_free_skeleton(), EASYDBUS_MEMCOPY, EasyDbus_ext_signal::interface, EasyDbus_ext_signal::next, EasyDbus_ext_signal::path, EasyDbus_ext_signal::sender, EasyDbus_ext_signal::signal, and EasyDbus_ext_signal::signal_callback.

{
   struct EasyDbus_ext_signal *ext_signal = NULL;
   int string_len;

   if (!signal || !signal_callback)
      return NULL;

   ext_signal = (struct EasyDbus_ext_signal *)
      malloc (sizeof (struct EasyDbus_ext_signal));

   if (!ext_signal)
      return NULL;

   memset (ext_signal, 0, sizeof (struct EasyDbus_ext_signal));

   ext_signal->signal = ext_signal->path =
      ext_signal->interface = ext_signal->sender = NULL;
   ext_signal->signal_callback = NULL;
   ext_signal->next = NULL;

   /* save signal string name */
   string_len = strlen (signal) + 1;
   ext_signal->signal = (char *) malloc (string_len);
   if (!ext_signal->signal)
      goto out_of_memory;
   EASYDBUS_MEMCOPY (ext_signal->signal, signal, string_len);

   /* save signal path string */
   if (path) {
      string_len = strlen (path) + 1;
      ext_signal->path = (char *) malloc (string_len);
      if (!ext_signal->path)
         goto out_of_memory;
      EASYDBUS_MEMCOPY (ext_signal->path, path, string_len);
   }

   /* save signal interface string */
   if (interface) {
      string_len = strlen (interface) + 1;
      ext_signal->interface = (char *) malloc (string_len);
      if (!ext_signal->interface)
         goto out_of_memory;
      EASYDBUS_MEMCOPY (ext_signal->interface, interface,
                        string_len);
   }

   /* save signal sender string */
   if (sender) {
      string_len = strlen (sender) + 1;
      ext_signal->sender = (char *) malloc (string_len);
      if (!ext_signal->sender)
         goto out_of_memory;
      EASYDBUS_MEMCOPY (ext_signal->sender, sender, string_len);
   }

   if (destination) {
      string_len = strlen (destination) + 1;
      ext_signal->destination = (char *) malloc (string_len);
      if (!ext_signal->destination)
         goto out_of_memory;
      EASYDBUS_MEMCOPY (ext_signal->destination, destination,
                        string_len);
   }

   ext_signal->signal_callback = signal_callback;

   return ext_signal;

 out_of_memory:
   if (ext_signal)
      easydbus_ext_signal_free_skeleton (ext_signal);

   return NULL;
}

Here is the call graph for this function:

void easydbus_ext_signal_free_skeleton

(

EasyDbus_ext_signal *

signal

)

Free EasyDbus_ext_signal object.

Parameters:

signal

EasyDbus_ext_signal to free.

Definition at line 87 of file register_ext_signal.c.

References EasyDbus_ext_signal::destination, EasyDbus_ext_signal::interface, EasyDbus_ext_signal::path, EasyDbus_ext_signal::sender, and EasyDbus_ext_signal::signal.

Referenced by easydbus_conn_destroy(), and easydbus_ext_signal_create().

{
   if (!signal)
      return;

   if (signal->signal)
      free (signal->signal);

   if (signal->path)
      free (signal->path);

   if (signal->interface)
      free (signal->interface);

   if (signal->sender)
      free (signal->sender);

   if (signal->destination)
      free (signal->destination);

   free (signal);
}

---