Ecore Connection SSL Functions

Functions that operate on Ecore connection objects pertaining to SSL. More...

Functions

EAPI int ecore_con_ssl_available_get (void)
 Returns if SSL support is available.
EAPI Eina_Bool ecore_con_ssl_server_cert_add (Ecore_Con_Server *svr, const char *cert)
 Add an ssl certificate for use in ecore_con functions.
EAPI Eina_Bool ecore_con_ssl_server_privkey_add (Ecore_Con_Server *svr, const char *key_file)
 Add an ssl private key for use in ecore_con functions.
EAPI Eina_Bool ecore_con_ssl_server_crl_add (Ecore_Con_Server *svr, const char *crl_file)
 Add an ssl CRL for use in ecore_con functions.
EAPI Eina_Bool ecore_con_ssl_server_cafile_add (Ecore_Con_Server *svr, const char *ca_file)
 Add an ssl CA file for use in ecore_con functions.
EAPI void ecore_con_ssl_server_verify (Ecore_Con_Server *svr)
 Enable certificate verification on a server object.

Detailed Description

Functions that operate on Ecore connection objects pertaining to SSL.


Function Documentation

EAPI int ecore_con_ssl_available_get ( void  )

Returns if SSL support is available.

Returns:
1 if SSL is available and provided by gnutls, 2 if provided by openssl, 0 if it is not available.

Referenced by ecore_ipc_ssl_available_get().

EAPI Eina_Bool ecore_con_ssl_server_cafile_add ( Ecore_Con_Server svr,
const char *  ca_file 
)

Add an ssl CA file for use in ecore_con functions.

Use this function to add a SSL PEM CA file. Simply specify the file here to use it in the server object for connecting or listening. If there is an error loading the CAs, an error will automatically be logged.

Parameters:
ca_fileThe path to the CA file.
Returns:
EINA_FALSE if the file cannot be loaded, otherwise EINA_TRUE.
Examples:
ecore_con_client_example.c.
EAPI Eina_Bool ecore_con_ssl_server_cert_add ( Ecore_Con_Server svr,
const char *  cert 
)

Add an ssl certificate for use in ecore_con functions.

Use this function to add a SSL PEM certificate. Simply specify the cert here to use it in the server object for connecting or listening. If there is an error loading the certificate, an error will automatically be logged.

Parameters:
certThe path to the certificate.
Returns:
EINA_FALSE if the file cannot be loaded, otherwise EINA_TRUE.
Examples:
ecore_con_server_example.c.
EAPI Eina_Bool ecore_con_ssl_server_crl_add ( Ecore_Con_Server svr,
const char *  crl_file 
)

Add an ssl CRL for use in ecore_con functions.

Use this function to add a SSL PEM CRL file Simply specify the CRL file here to use it in the server object for connecting or listening. If there is an error loading the CRL, an error will automatically be logged.

Parameters:
crl_fileThe path to the CRL file.
Returns:
EINA_FALSE if the file cannot be loaded, otherwise EINA_TRUE.
EAPI Eina_Bool ecore_con_ssl_server_privkey_add ( Ecore_Con_Server svr,
const char *  key_file 
)

Add an ssl private key for use in ecore_con functions.

Use this function to add a SSL PEM private key Simply specify the key file here to use it in the server object for connecting or listening. If there is an error loading the key, an error will automatically be logged.

Parameters:
key_fileThe path to the key file.
Returns:
EINA_FALSE if the file cannot be loaded, otherwise EINA_TRUE.
Examples:
ecore_con_server_example.c.

Enable certificate verification on a server object.

Call this function on a server object before main loop has started to enable verification of certificates against loaded certificates.

Parameters:
svrThe server object
Examples:
ecore_con_client_example.c.