/**
 @page event Event module

 @section Overview
Event module provides encapsulated IPC mechanism.<br>
Event which is sent from UI to engine, is based on socket, and Noti which is sent from engine to UI, is based on Inotify.<br>

 @image html overview_event.png "Software architecture of Event module"

In order to enable customizing, external Event/Noti spec files are used,<br>
and path of the spec files in Target device should be specified in Framework configuration XML.<br>
Sync-agent Framework parses the spec files and performs requested IPC operation as defined in the spec files.

Following example of spec file contents.
- eventconfig<br>
1, 1, 0, 30, addprofile<br>
2, 1, 0, 30, editprofile<br>
3, 1, 0, 30, deleteprofile<br>
4, 1, 0, 30, requestsync<br>
5, 1, 0, 30, cancelsync<br>

- noticonfig<br>
1, 0, 0, 30, sessionprocess<br>
2, 0, 0, 30, processupdate<br>

First column specifies unique index number,<br>
second column specifies type (sync or async, currently uses only sync type(1)),<br>
third column specifies related event/noti index (currently not in use(0)),<br>
fourth column specifies pending time (currently not in use, use any number),<br>
fifth column specifies description just for human readability.<br>

For each Event and Noti, user should register callback function which will be invoked on reception.<br>
Those registration should be done before using IPC.

In brief, user may go through next steps to activate Framework IPC system.<br>
-# Compose Event/Noti spec files. (Environment)
-# Register Event/Noti callback for each event. (Code)
-# Run Event/Noti listener. (Code)

Sync-agent Framework provides standard IPC API set for OMA DM and OMA DS. (Refer to oma_xx_api.h)

Event module has following sub implementations with each corresponding roles.<br>
	- <b>Spec Manager</b><br>
	Parses and loads event/noti spec files specified.<br>

	- <b>Event Accessor</b><br>
	Provides APIs to access Event/Noti instance exchanging between UI and engine.<br>
	Using those APIs, user can get/set data in Event/Noti instance.<br>

	- <b>Event Handler</b><br>
	Creates Event listener and handles received Event as specified in spec files.<br>
	Provides API for user to register Event callback executed on reception.<br>
	Engine can dispatch Noti to UI through this module.<br>

	- <b>UI API</b><br>
	Creates Noti listener and handles received Noti as specified in spec files.<br>
	Provides API for user to register Noti callback executed on reception.<br>
	UI can dispatch Event to engine through this module.<br>
*/