Ecore Connection Events Functions

The Ecore Con events can be categorized into Server side events and Client side events. More...

Data Structures

struct  _Ecore_Con_Event_Client_Add
 Used as the data param for the ECORE_CON_EVENT_CLIENT_ADD event. More...
struct  _Ecore_Con_Event_Client_Upgrade
 Used as the data param for the ECORE_CON_EVENT_CLIENT_UPGRADE event. More...
struct  _Ecore_Con_Event_Client_Del
 Used as the data param for the ECORE_CON_EVENT_CLIENT_DEL event. More...
struct  _Ecore_Con_Event_Client_Error
 Used as the data param for the ECORE_CON_EVENT_CLIENT_ERROR event. More...
struct  _Ecore_Con_Event_Server_Add
 Used as the data param for the ECORE_CON_EVENT_SERVER_ADD event. More...
struct  _Ecore_Con_Event_Server_Upgrade
 Used as the data param for the ECORE_CON_EVENT_SERVER_UPGRADE event. More...
struct  _Ecore_Con_Event_Server_Del
 Used as the data param for the ECORE_CON_EVENT_SERVER_DEL event. More...
struct  _Ecore_Con_Event_Server_Error
 Used as the data param for the ECORE_CON_EVENT_SERVER_ERROR event. More...
struct  _Ecore_Con_Event_Client_Data
 Used as the data param for the ECORE_CON_EVENT_CLIENT_DATA event. More...
struct  _Ecore_Con_Event_Server_Data
 Used as the data param for the ECORE_CON_EVENT_SERVER_DATA event. More...
struct  _Ecore_Con_Event_Client_Write
 Used as the data param for the ECORE_CON_EVENT_CLIENT_WRITE event. More...
struct  _Ecore_Con_Event_Server_Write
 Used as the data param for the ECORE_CON_EVENT_SERVER_WRITE event. More...
struct  _Ecore_Con_Event_Proxy_Bind
 Used as the data param for the ECORE_CON_EVENT_PROXY_BIND event. More...
struct  _Ecore_Con_Event_Url_Data
 Used as the data param for the ECORE_CON_EVENT_URL_DATA event. More...
struct  _Ecore_Con_Event_Url_Complete
 Used as the data param for the ECORE_CON_EVENT_URL_COMPLETE event. More...
struct  _Ecore_Con_Event_Url_Progress
 Used as the data param for the ECORE_CON_EVENT_URL_PROGRESS event. More...
struct  _Ecore_Con_Event_Url_Progress::[struct].down
struct  _Ecore_Con_Event_Url_Progress::[struct].up

Typedefs

typedef struct _Ecore_Con_Event_Client_Add Ecore_Con_Event_Client_Add
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Client_Upgrade Ecore_Con_Event_Client_Upgrade
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Client_Del Ecore_Con_Event_Client_Del
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Client_Error Ecore_Con_Event_Client_Error
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Server_Add Ecore_Con_Event_Server_Add
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Server_Upgrade Ecore_Con_Event_Server_Upgrade
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Server_Del Ecore_Con_Event_Server_Del
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Server_Error Ecore_Con_Event_Server_Error
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Client_Data Ecore_Con_Event_Client_Data
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Server_Data Ecore_Con_Event_Server_Data
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Client_Write Ecore_Con_Event_Client_Write
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Server_Write Ecore_Con_Event_Server_Write
 Used as the data param for the corresponding event.
typedef struct _Ecore_Con_Event_Proxy_Bind Ecore_Con_Event_Proxy_Bind
 Used as the data param for the corresponding event.

Variables

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_ADD
 A client has connected to the server.
ECORE_CON_API int ECORE_CON_EVENT_CLIENT_DEL
 A client has disconnected from the server.
ECORE_CON_API int ECORE_CON_EVENT_CLIENT_ERROR
 A client experienced an error.
ECORE_CON_API int ECORE_CON_EVENT_CLIENT_UPGRADE
 A client connection has been upgraded to SSL.
ECORE_CON_API int ECORE_CON_EVENT_SERVER_ADD
 A server was created.
ECORE_CON_API int ECORE_CON_EVENT_SERVER_DEL
 A server connection was lost.
ECORE_CON_API int ECORE_CON_EVENT_SERVER_ERROR
 A server experienced an error.
ECORE_CON_API int ECORE_CON_EVENT_SERVER_UPGRADE
 A server connection has been upgraded to SSL.
ECORE_CON_API int ECORE_CON_EVENT_CLIENT_WRITE
 A server connection has sent data to its client.
ECORE_CON_API int ECORE_CON_EVENT_SERVER_WRITE
 A server connection object has sent data.
ECORE_CON_API int ECORE_CON_EVENT_CLIENT_DATA
 A client connected to the server has sent data.
ECORE_CON_API int ECORE_CON_EVENT_SERVER_DATA
 A server connection object has data.
ECORE_CON_API int ECORE_CON_EVENT_PROXY_BIND
 A server connection has successfully negotiated an ip:port binding.
ECORE_CON_API int ECORE_CON_EVENT_URL_DATA
 A URL object has data.
ECORE_CON_API int ECORE_CON_EVENT_URL_COMPLETE
 A URL object has completed its transfer to and from the server and can be reused.
ECORE_CON_API int ECORE_CON_EVENT_URL_PROGRESS
 A URL object has made progress in its transfer.

Detailed Description

The Ecore Con events can be categorized into Server side events and Client side events.

Server side events:

  • ECORE_CON_CLIENT_ADD: Whenever a client connection is made to an Ecore_Con_Server, an event of this type is emitted, allowing the retrieval of the client's ip with ecore_con_client_ip_get and associating data with the client using ecore_con_client_data_set.
  • ECORE_CON_EVENT_CLIENT_DEL: Whenever a client connection to an Ecore_Con_Server is destroyed, an event of this type is emitted. The contents of the data with this event are variable, but if the client object in the data is non-null, it must be freed with ecore_con_client_del.
  • ECORE_CON_EVENT_CLIENT_DATA: Whenever a server object receives data, then an event of this type is emitted. The data will contain the size and contents of the message sent by the client. It should be noted that data within this object is transient, so it must be duplicated in order to be retained. This event will continue to occur until the client has stopped sending its message, so a good option for storing this data is an Eina_Strbuf. Once the message has been received in full, the client object must be freed with ecore_con_client_free.

Client side events:

  • ECORE_CON_EVENT_SERVER_ADD: Whenever a server object is created with ecore_con_server_connect, an event of this type is emitted, allowing for data to be serialized and sent to the server using ecore_con_server_send. At this point, the http handshake has occurred.
  • ECORE_CON_EVENT_SERVER_DEL: Whenever a server object is destroyed, usually by the server connection being refused or dropped, an event of this type is emitted. The contents of the data with this event are variable, but if the server object in the data is non-null, it must be freed with ecore_con_server_del.
  • ECORE_CON_EVENT_SERVER_DATA: Whenever client object receives data from the server, an event of this type is emitted. The data will contain both the size and contents of the message sent by the server. It should be noted that data within this object is transient, so it must be duplicated in order to be retained. This event will continue to occur until the server has stopped sending its message, so a good option for storing this data is an Eina_Strbuf. Once the message has been received in full, the server object must be freed with ecore_con_server_free.

Typedef Documentation

◆ Ecore_Con_Event_Client_Add

Used as the data param for the corresponding event.

Examples
ecore_con_server_example.c, and ecore_con_server_simple_example.c.

◆ Ecore_Con_Event_Client_Upgrade

Used as the data param for the corresponding event.

Since
1.1
Examples
ecore_con_server_example.c.

◆ Ecore_Con_Event_Client_Del

Used as the data param for the corresponding event.

Examples
ecore_con_server_example.c, and ecore_con_server_simple_example.c.

◆ Ecore_Con_Event_Client_Error

Used as the data param for the corresponding event.

Since
1.1
Examples
ecore_con_server_example.c.

◆ Ecore_Con_Event_Server_Add

Used as the data param for the corresponding event.

Examples
ecore_con_client_example.c, and ecore_con_client_simple_example.c.

◆ Ecore_Con_Event_Server_Upgrade

Used as the data param for the corresponding event.

Since
1.1
Examples
ecore_con_client_example.c.

◆ Ecore_Con_Event_Server_Del

Used as the data param for the corresponding event.

Examples
ecore_con_client_example.c, and ecore_con_client_simple_example.c.

◆ Ecore_Con_Event_Server_Error

Used as the data param for the corresponding event.

Since
1.1
Examples
ecore_con_client_example.c.

◆ Ecore_Con_Event_Client_Data

Used as the data param for the corresponding event.

Examples
ecore_con_server_example.c, and ecore_con_server_simple_example.c.

◆ Ecore_Con_Event_Server_Data

Used as the data param for the corresponding event.

Examples
ecore_con_client_example.c, and ecore_con_client_simple_example.c.

◆ Ecore_Con_Event_Client_Write

Used as the data param for the corresponding event.

Since
1.1
Examples
ecore_con_server_example.c.

◆ Ecore_Con_Event_Server_Write

Used as the data param for the corresponding event.

Since
1.1
Examples
ecore_con_client_example.c.

◆ Ecore_Con_Event_Proxy_Bind

Used as the data param for the corresponding event.

Since
1.2

Variable Documentation

◆ ECORE_CON_EVENT_CLIENT_ADD

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_ADD
extern

A client has connected to the server.

Examples
ecore_con_server_example.c, and ecore_con_server_simple_example.c.

◆ ECORE_CON_EVENT_CLIENT_DEL

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_DEL
extern

A client has disconnected from the server.

Examples
ecore_con_server_example.c, and ecore_con_server_simple_example.c.

◆ ECORE_CON_EVENT_CLIENT_ERROR

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_ERROR
extern

A client experienced an error.

Since
1.1
Examples
ecore_con_server_example.c.

◆ ECORE_CON_EVENT_CLIENT_UPGRADE

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_UPGRADE
extern

A client connection has been upgraded to SSL.

Since
1.1
Examples
ecore_con_server_example.c.

◆ ECORE_CON_EVENT_SERVER_ADD

ECORE_CON_API int ECORE_CON_EVENT_SERVER_ADD
extern

◆ ECORE_CON_EVENT_SERVER_DEL

ECORE_CON_API int ECORE_CON_EVENT_SERVER_DEL
extern

A server connection was lost.

Examples
ecore_con_client_example.c, and ecore_con_client_simple_example.c.

◆ ECORE_CON_EVENT_SERVER_ERROR

ECORE_CON_API int ECORE_CON_EVENT_SERVER_ERROR
extern

A server experienced an error.

Since
1.1
Examples
ecore_con_client_example.c.

◆ ECORE_CON_EVENT_SERVER_UPGRADE

ECORE_CON_API int ECORE_CON_EVENT_SERVER_UPGRADE
extern

A server connection has been upgraded to SSL.

Since
1.1
Examples
ecore_con_client_example.c.

◆ ECORE_CON_EVENT_CLIENT_WRITE

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_WRITE
extern

A server connection has sent data to its client.

Since
1.1
Examples
ecore_con_server_example.c.

◆ ECORE_CON_EVENT_SERVER_WRITE

ECORE_CON_API int ECORE_CON_EVENT_SERVER_WRITE
extern

A server connection object has sent data.

Since
1.1
Examples
ecore_con_client_example.c.

◆ ECORE_CON_EVENT_CLIENT_DATA

ECORE_CON_API int ECORE_CON_EVENT_CLIENT_DATA
extern

A client connected to the server has sent data.

Examples
ecore_con_server_example.c, and ecore_con_server_simple_example.c.

◆ ECORE_CON_EVENT_SERVER_DATA

ECORE_CON_API int ECORE_CON_EVENT_SERVER_DATA
extern

A server connection object has data.

Examples
ecore_con_client_example.c, and ecore_con_client_simple_example.c.

◆ ECORE_CON_EVENT_PROXY_BIND

ECORE_CON_API int ECORE_CON_EVENT_PROXY_BIND
extern

A server connection has successfully negotiated an ip:port binding.

Since
1.2

◆ ECORE_CON_EVENT_URL_DATA

ECORE_CON_API int ECORE_CON_EVENT_URL_DATA
extern

◆ ECORE_CON_EVENT_URL_COMPLETE

ECORE_CON_API int ECORE_CON_EVENT_URL_COMPLETE
extern

A URL object has completed its transfer to and from the server and can be reused.

Examples
ecore_con_url_cookies_example.c, ecore_con_url_download_example.c, and ecore_con_url_headers_example.c.

Referenced by ecore_con_url_init(), and ecore_con_url_shutdown().

◆ ECORE_CON_EVENT_URL_PROGRESS

ECORE_CON_API int ECORE_CON_EVENT_URL_PROGRESS
extern

A URL object has made progress in its transfer.

Examples
ecore_con_url_download_example.c.

Referenced by ecore_con_url_init(), and ecore_con_url_shutdown().