The EAP API provides functions for managing the EAP information.

Required Header

#include <wifi.h>

Overview

The EAP API provides functions for managing the EAP information. You can manage the EAP information using the functions.

Related Features

This API is related with the following features:

http://tizen.org/feature/network.wifi
It is recommended to design applications with regard to features, for reliability.
You can check if a device supports the related features for this API by using System Information, and control your application's actions accordingly.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on using features in your application can be found in the Feature List.

Functions
int	wifi_manager_ap_set_eap_passphrase (wifi_manager_ap_h ap, const char user_name, const char password)
	Sets the passphrase of EAP.
int	wifi_manager_ap_get_eap_passphrase (wifi_manager_ap_h ap, char *user_name, bool is_password_set)
	Gets the passphrase of EAP.
int	wifi_manager_ap_get_eap_ca_cert_file (wifi_manager_ap_h ap, char **file)
	Gets the CA Certificate of EAP.
int	wifi_manager_ap_set_eap_ca_cert_file (wifi_manager_ap_h ap, const char *file)
	Sets the CA Certificate of EAP.
int	wifi_manager_ap_get_eap_client_cert_file (wifi_manager_ap_h ap, char **file)
	Gets the Client Certificate of EAP.
int	wifi_manager_ap_set_eap_client_cert_file (wifi_manager_ap_h ap, const char *file)
	Sets the CA Certificate of EAP.
int	wifi_manager_ap_get_eap_private_key_file (wifi_manager_ap_h ap, char **file)
	Gets the private key file of EAP.
int	wifi_manager_ap_set_eap_private_key_info (wifi_manager_ap_h ap, const char file, const char password)
	Sets the private key information of EAP.
int	wifi_manager_ap_get_eap_type (wifi_manager_ap_h ap, wifi_manager_eap_type_e *type)
	Gets the EAP type of Wi-Fi.
int	wifi_manager_ap_set_eap_type (wifi_manager_ap_h ap, wifi_manager_eap_type_e type)
	Sets the EAP type of Wi-Fi.
int	wifi_manager_ap_get_eap_auth_type (wifi_manager_ap_h ap, wifi_manager_eap_auth_type_e *type)
	Gets the type of EAP phase2 authentication of Wi-Fi.
int	wifi_manager_ap_set_eap_auth_type (wifi_manager_ap_h ap, wifi_manager_eap_auth_type_e type)
	Sets the type of EAP phase2 authentication of Wi-Fi.

Enumeration Type Documentation

enum wifi_manager_eap_auth_type_e

Enumeration for EAP phase2 authentication type.

Since :: 3.0

Enumerator:

WIFI_MANAGER_EAP_AUTH_TYPE_NONE	EAP phase2 authentication none
WIFI_MANAGER_EAP_AUTH_TYPE_PAP	EAP phase2 authentication PAP
WIFI_MANAGER_EAP_AUTH_TYPE_MSCHAP	EAP phase2 authentication MSCHAP
WIFI_MANAGER_EAP_AUTH_TYPE_MSCHAPV2	EAP phase2 authentication MSCHAPv2
WIFI_MANAGER_EAP_AUTH_TYPE_GTC	EAP phase2 authentication GTC
WIFI_MANAGER_EAP_AUTH_TYPE_MD5	EAP phase2 authentication MD5

enum wifi_manager_eap_type_e

Enumeration for EAP type.

Since :: 3.0

Enumerator:

WIFI_MANAGER_EAP_TYPE_PEAP	EAP PEAP type
WIFI_MANAGER_EAP_TYPE_TLS	EAP TLS type
WIFI_MANAGER_EAP_TYPE_TTLS	EAP TTLS type
WIFI_MANAGER_EAP_TYPE_SIM	EAP SIM type
WIFI_MANAGER_EAP_TYPE_AKA	EAP AKA type

Function Documentation

int wifi_manager_ap_get_eap_auth_type	(	wifi_manager_ap_h	ap,
		wifi_manager_eap_auth_type_e *	type
	)

Gets the type of EAP phase2 authentication of Wi-Fi.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[out]	type	The type of EAP phase2 authentication

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_get_eap_ca_cert_file	(	wifi_manager_ap_h	ap,
		char **	file
	)

Gets the CA Certificate of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS. You must release file using free().

Parameters:

[in]	ap	The access point handle
[out]	file	The file path of CA Certificate

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_get_eap_client_cert_file	(	wifi_manager_ap_h	ap,
		char **	file
	)

Gets the Client Certificate of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS. You must release file using free().

Parameters:

[in]	ap	The access point handle
[out]	file	The file path of Client Certificate

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_get_eap_passphrase	(	wifi_manager_ap_h	ap,
		char **	user_name,
		bool *	is_password_set
	)

Gets the passphrase of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_PEAP or WIFI_MANAGER_EAP_TYPE_TTLS. You must release user_name using free().

Parameters:

[in]	ap	The access point handle
[out]	user_name	The user name
[out]	is_password_set	`true` if password is set, otherwise `flase` if password is not set.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_get_eap_private_key_file	(	wifi_manager_ap_h	ap,
		char **	file
	)

Gets the private key file of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS. You must release file using free().

Parameters:

[in]	ap	The access point handle
[out]	file	The file path of private key

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_OUT_OF_MEMORY	Out of memory
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_get_eap_type	(	wifi_manager_ap_h	ap,
		wifi_manager_eap_type_e *	type
	)

Gets the EAP type of Wi-Fi.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[out]	type	The type of EAP

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_OPERATION_FAILED	Operation failed
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_eap_auth_type	(	wifi_manager_ap_h	ap,
		wifi_manager_eap_auth_type_e	type
	)

Sets the type of EAP phase2 authentication of Wi-Fi.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[in]	type	The type of EAP phase2 authentication

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_eap_ca_cert_file	(	wifi_manager_ap_h	ap,
		const char *	file
	)

Sets the CA Certificate of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS.

Parameters:

[in]	ap	The access point handle
[in]	file	The file path of CA Certificate

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_eap_client_cert_file	(	wifi_manager_ap_h	ap,
		const char *	file
	)

Sets the CA Certificate of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS.

Parameters:

[in]	ap	The access point handle
[in]	file	The file path of Client Certificate

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_eap_passphrase	(	wifi_manager_ap_h	ap,
		const char *	user_name,
		const char *	password
	)

Sets the passphrase of EAP.

You can set one of user_name and password as NULL. In this case, the value of a parameter which is set as NULL will be the previous value. But it is not allowed that both user_name and password are set as NULL.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_PEAP or WIFI_MANAGER_EAP_TYPE_TTLS.

Parameters:

[in]	ap	The access point handle
[in]	user_name	The user name This value can be `NULL`.
[in]	password	The password This value can be `NULL`.

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_eap_private_key_info	(	wifi_manager_ap_h	ap,
		const char *	file,
		const char *	password
	)

Sets the private key information of EAP.

Since :: 3.0

Remarks:: This function is valid only if the EAP type is WIFI_MANAGER_EAP_TYPE_TLS.

Parameters:

[in]	ap	The access point handle
[in]	file	The file path of private key
[in]	password	The password

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

int wifi_manager_ap_set_eap_type	(	wifi_manager_ap_h	ap,
		wifi_manager_eap_type_e	type
	)

Sets the EAP type of Wi-Fi.

Since :: 3.0

Parameters:

[in]	ap	The access point handle
[in]	type	The type of EAP

Returns:: 0 on success, otherwise negative error value

Return values:

WIFI_MANAGER_ERROR_NONE	Successful
WIFI_MANAGER_ERROR_INVALID_PARAMETER	Invalid parameter
WIFI_MANAGER_ERROR_INVALID_OPERATION	Invalid operation
WIFI_MANAGER_ERROR_NOT_SUPPORTED	Not supported

Required Header

Overview

Related Features

Functions

Enumeration Type Documentation

Function Documentation