Product Documentation for Devicescape Secure Wireless Client

API Reference Documentation for Devicescape Secure Wireless Client

eloop.c File Reference

Event loop based on select() loop. More...

Data Structures
struct	eloop_sock
struct	eloop_timeout
struct	eloop_signal
struct	eloop_sock_table
struct	eloop_data
Functions
int	eloop_init (void *user_data)
	Initialize global event loop data.
int	eloop_register_read_sock (int sock, eloop_sock_handler handler, void *eloop_data, void *user_data)
	Register handler for read events.
void	eloop_unregister_read_sock (int sock)
	Unregister handler for read events.
int	eloop_register_sock (int sock, eloop_event_type type, eloop_sock_handler handler, void *eloop_data, void *user_data)
	Register handler for socket events.
void	eloop_unregister_sock (int sock, eloop_event_type type)
	Unregister handler for socket events.
int	eloop_register_timeout (unsigned int secs, unsigned int usecs, eloop_timeout_handler handler, void *eloop_data, void *user_data)
	Register timeout.
int	eloop_cancel_timeout (eloop_timeout_handler handler, void *eloop_data, void *user_data)
	Cancel timeouts.
int	eloop_register_signal (int sig, eloop_signal_handler handler, void *user_data)
	Register handler for signals.
int	eloop_register_signal_terminate (eloop_signal_handler handler, void *user_data)
	Register handler for terminate signals.
int	eloop_register_signal_reconfig (eloop_signal_handler handler, void *user_data)
	Register handler for reconfig signals.
void	eloop_run (void)
	Start the event loop.
void	eloop_terminate (void)
	Terminate event loop.
void	eloop_destroy (void)
	Free any resources allocated for the event loop.
int	eloop_terminated (void)
	Check whether event loop has been terminated.
void	eloop_wait_for_read_sock (int sock)
	Wait for a single reader.
void *	eloop_get_user_data (void)
	Get global user data.

---

Detailed Description

Event loop based on select() loop.

---

Function Documentation

int eloop_cancel_timeout (  eloop_timeout_handler  handler, void *  eloop_data, void *  user_data )

Cancel timeouts. Parameters: handler  Matching callback function eloop_data  Matching eloop_data or ELOOP_ALL_CTX to match all user_data  Matching user_data or ELOOP_ALL_CTX to match all Returns: Number of cancelled timeouts Cancel matching <handler,eloop_data,user_data> timeouts registered with eloop_register_timeout(). ELOOP_ALL_CTX can be used as a wildcard for cancelling all timeouts regardless of eloop_data/user_data.

void eloop_destroy (  void   )

Free any resources allocated for the event loop. After calling eloop_destroy(), other eloop_* functions must not be called before re-running eloop_init().

void* eloop_get_user_data (  void   )

Get global user data. Returns: user_data pointer that was registered with eloop_init()

int eloop_init (  void *  user_data  )

Initialize global event loop data. Parameters: user_data  Pointer to global data passed as eloop_ctx to signal handlers Returns: 0 on success, -1 on failure This function must be called before any other eloop_* function. user_data can be used to configure a global (to the process) pointer that will be passed as eloop_ctx parameter to signal handlers.

int eloop_register_read_sock (  int  sock, eloop_sock_handler  handler, void *  eloop_data, void *  user_data )

Register handler for read events. Parameters: sock  File descriptor number for the socket handler  Callback function to be called when data is available for reading eloop_data  Callback context data (eloop_ctx) user_data  Callback context data (sock_ctx) Returns: 0 on success, -1 on failure Register a read socket notifier for the given file descriptor. The handler function will be called whenever data is available for reading from the socket. The handler function is responsible for clearing the event after having processed it in order to avoid eloop from calling the handler again for the same event.

int eloop_register_signal (  int  sig, eloop_signal_handler  handler, void *  user_data )

Register handler for signals. Parameters: sig  Signal number (e.g., SIGHUP) handler  Callback function to be called when the signal is received user_data  Callback context data (signal_ctx) Returns: 0 on success, -1 on failure Register a callback function that will be called when a signal is received. The callback function is actually called only after the system signal handler has returned. This means that the normal limits for sighandlers (i.e., only "safe functions" allowed) do not apply for the registered callback. Signals are 'global' events and there is no local eloop_data pointer like with other handlers. The global user_data pointer registered with eloop_init() will be used as eloop_ctx for signal handlers.

int eloop_register_signal_reconfig (  eloop_signal_handler  handler, void *  user_data )

Register handler for reconfig signals. Parameters: handler  Callback function to be called when the signal is received user_data  Callback context data (signal_ctx) Returns: 0 on success, -1 on failure Register a callback function that will be called when a reconfiguration / hangup signal is received. The callback function is actually called only after the system signal handler has returned. This means that the normal limits for sighandlers (i.e., only "safe functions" allowed) do not apply for the registered callback. Signals are 'global' events and there is no local eloop_data pointer like with other handlers. The global user_data pointer registered with eloop_init() will be used as eloop_ctx for signal handlers. This function is a more portable version of eloop_register_signal() since the knowledge of exact details of the signals is hidden in eloop implementation. In case of operating systems using signal(), this function registers a handler for SIGHUP.

int eloop_register_signal_terminate (  eloop_signal_handler  handler, void *  user_data )

Register handler for terminate signals. Parameters: handler  Callback function to be called when the signal is received user_data  Callback context data (signal_ctx) Returns: 0 on success, -1 on failure Register a callback function that will be called when a process termination signal is received. The callback function is actually called only after the system signal handler has returned. This means that the normal limits for sighandlers (i.e., only "safe functions" allowed) do not apply for the registered callback. Signals are 'global' events and there is no local eloop_data pointer like with other handlers. The global user_data pointer registered with eloop_init() will be used as eloop_ctx for signal handlers. This function is a more portable version of eloop_register_signal() since the knowledge of exact details of the signals is hidden in eloop implementation. In case of operating systems using signal(), this function registers handlers for SIGINT and SIGTERM.

int eloop_register_sock (  int  sock, eloop_event_type  type, eloop_sock_handler  handler, void *  eloop_data, void *  user_data )

Register handler for socket events. Parameters: sock  File descriptor number for the socket type  Type of event to wait for handler  Callback function to be called when the event is triggered eloop_data  Callback context data (eloop_ctx) user_data  Callback context data (sock_ctx) Returns: 0 on success, -1 on failure Register an event notifier for the given socket's file descriptor. The handler function will be called whenever the that event is triggered for the socket. The handler function is responsible for clearing the event after having processed it in order to avoid eloop from calling the handler again for the same event.

int eloop_register_timeout (  unsigned int  secs, unsigned int  usecs, eloop_timeout_handler  handler, void *  eloop_data, void *  user_data )

Register timeout. Parameters: secs  Number of seconds to the timeout usecs  Number of microseconds to the timeout handler  Callback function to be called when timeout occurs eloop_data  Callback context data (eloop_ctx) user_data  Callback context data (sock_ctx) Returns: 0 on success, -1 on failure Register a timeout that will cause the handler function to be called after given time.

void eloop_run (  void   )

Start the event loop. Start the event loop and continue running as long as there are any registered event handlers. This function is run after event loop has been initialized with event_init() and one or more events have been registered.

void eloop_terminate (  void   )

Terminate event loop. Terminate event loop even if there are registered events. This can be used to request the program to be terminated cleanly.

int eloop_terminated (  void   )

Check whether event loop has been terminated. Returns: 1 = event loop terminate, 0 = event loop still running This function can be used to check whether eloop_terminate() has been called to request termination of the event loop. This is normally used to abort operations that may still be queued to be run when eloop_terminate() was called.

void eloop_unregister_read_sock (  int  sock  )

Unregister handler for read events. Parameters: sock  File descriptor number for the socket Unregister a read socket notifier that was previously registered with eloop_register_read_sock().

void eloop_unregister_sock (  int  sock, eloop_event_type  type )

Unregister handler for socket events. Parameters: sock  File descriptor number for the socket type  Type of event for which sock was registered Unregister a socket event notifier that was previously registered with eloop_register_sock().

void eloop_wait_for_read_sock (  int  sock  )

Wait for a single reader. Parameters: sock  File descriptor number for the socket Do a blocking wait for a single read socket.

 

---

© 2005 Devicescape Software, Inc. All Rights Reserved.