eapol/eapol_framework/eapol_common/include/eap_plugin_client_message_if.h
author hgs
Thu, 16 Sep 2010 13:07:04 +0300
changeset 49 43351a4f2da3
parent 26 9abfd4f00d37
permissions -rw-r--r--
201037
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
26
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2001-2006 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of the License "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  EAP-plugin interface message class.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
/*
49
hgs
parents: 26
diff changeset
    19
* %version: 7 %
26
hgs
parents:
diff changeset
    20
*/
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
#if !defined(_EAP_PLUGIN_CLIENT_MESSAGE_IF_H_)
hgs
parents:
diff changeset
    23
#define _EAP_PLUGIN_CLIENT_MESSAGE_IF_H_
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
#include "eap_tools.h"
hgs
parents:
diff changeset
    26
#include "eap_am_export.h"
49
hgs
parents: 26
diff changeset
    27
// Start: added by script change_export_macros.sh.
hgs
parents: 26
diff changeset
    28
#if defined(EAP_NO_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H)
hgs
parents: 26
diff changeset
    29
	#define EAP_CLASS_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_NONSHARABLE 
hgs
parents: 26
diff changeset
    30
	#define EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H 
hgs
parents: 26
diff changeset
    31
	#define EAP_C_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H 
hgs
parents: 26
diff changeset
    32
	#define EAP_FUNC_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H 
hgs
parents: 26
diff changeset
    33
	#define EAP_C_FUNC_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H 
hgs
parents: 26
diff changeset
    34
#elif defined(EAP_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H)
hgs
parents: 26
diff changeset
    35
	#define EAP_CLASS_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_EXPORT 
hgs
parents: 26
diff changeset
    36
	#define EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_FUNC_EXPORT 
hgs
parents: 26
diff changeset
    37
	#define EAP_C_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_C_FUNC_EXPORT 
hgs
parents: 26
diff changeset
    38
	#define EAP_FUNC_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_FUNC_EXPORT 
hgs
parents: 26
diff changeset
    39
	#define EAP_C_FUNC_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_C_FUNC_EXPORT 
hgs
parents: 26
diff changeset
    40
#else
hgs
parents: 26
diff changeset
    41
	#define EAP_CLASS_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_IMPORT 
hgs
parents: 26
diff changeset
    42
	#define EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_FUNC_IMPORT 
hgs
parents: 26
diff changeset
    43
	#define EAP_C_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H EAP_C_FUNC_IMPORT 
hgs
parents: 26
diff changeset
    44
	#define EAP_FUNC_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H 
hgs
parents: 26
diff changeset
    45
	#define EAP_C_FUNC_EXPORT_EAP_PLUGIN_CLIENT_MESSAGE_IF_H 
hgs
parents: 26
diff changeset
    46
#endif
hgs
parents: 26
diff changeset
    47
// End: added by script change_export_macros.sh.
26
hgs
parents:
diff changeset
    48
#include "eap_plugin_message_base.h"
hgs
parents:
diff changeset
    49
#include "abs_eap_am_message_if.h"
hgs
parents:
diff changeset
    50
#include "eap_array.h"
hgs
parents:
diff changeset
    51
#include "eap_process_tlv_message_data.h"
hgs
parents:
diff changeset
    52
hgs
parents:
diff changeset
    53
class eap_method_settings_c;
hgs
parents:
diff changeset
    54
class eap_am_message_if_c;
hgs
parents:
diff changeset
    55
class abs_eap_plugin_message_c;
hgs
parents:
diff changeset
    56
class eap_tlv_header_c;
hgs
parents:
diff changeset
    57
hgs
parents:
diff changeset
    58
/// A eap_plugin_client_message_if_c class implements mapping of EAP authentication sessions.
hgs
parents:
diff changeset
    59
/// Network identity separates parallel EAP authentication sessions.
49
hgs
parents: 26
diff changeset
    60
class EAP_CLASS_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_plugin_client_message_if_c
26
hgs
parents:
diff changeset
    61
: public eap_plugin_message_base_c
hgs
parents:
diff changeset
    62
, public abs_eap_am_message_if_c
hgs
parents:
diff changeset
    63
{
hgs
parents:
diff changeset
    64
private:
hgs
parents:
diff changeset
    65
	//--------------------------------------------------
hgs
parents:
diff changeset
    66
hgs
parents:
diff changeset
    67
	/// This is pointer to the tools class.
hgs
parents:
diff changeset
    68
	abs_eap_am_tools_c * const m_am_tools;
hgs
parents:
diff changeset
    69
hgs
parents:
diff changeset
    70
	/// eap_plugin_client_message_if_c deletes m_client_if in destructor.
hgs
parents:
diff changeset
    71
	eap_am_message_if_c * m_client_if;
hgs
parents:
diff changeset
    72
hgs
parents:
diff changeset
    73
	/// This is back pointer to object which created this object.
hgs
parents:
diff changeset
    74
	/// Packets are sent to the partner.
hgs
parents:
diff changeset
    75
	abs_eap_plugin_message_c * const m_partner;
hgs
parents:
diff changeset
    76
hgs
parents:
diff changeset
    77
	/// This indicates whether this object was generated successfully.
hgs
parents:
diff changeset
    78
	bool m_is_valid;
hgs
parents:
diff changeset
    79
hgs
parents:
diff changeset
    80
	eap_status_e m_error_code;
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
	eap_tlv_message_type_function_e m_error_function;
hgs
parents:
diff changeset
    83
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
	eap_status_e complete_get_configuration(
hgs
parents:
diff changeset
    86
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    87
hgs
parents:
diff changeset
    88
	eap_status_e complete_set_configuration(
hgs
parents:
diff changeset
    89
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
	eap_status_e complete_delete_configuration(
hgs
parents:
diff changeset
    92
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    93
hgs
parents:
diff changeset
    94
	eap_status_e complete_copy_configuration(
hgs
parents:
diff changeset
    95
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    96
hgs
parents:
diff changeset
    97
	eap_status_e complete_set_index(
hgs
parents:
diff changeset
    98
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
    99
hgs
parents:
diff changeset
   100
	eap_status_e complete_get_type_info(
hgs
parents:
diff changeset
   101
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
   102
hgs
parents:
diff changeset
   103
	eap_status_e complete_invoke_ui(
hgs
parents:
diff changeset
   104
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
   105
hgs
parents:
diff changeset
   106
hgs
parents:
diff changeset
   107
	eap_status_e process_message_type_error(
hgs
parents:
diff changeset
   108
		EAP_TEMPLATE_CONST eap_array_c<eap_tlv_header_c> * const parameters);
hgs
parents:
diff changeset
   109
hgs
parents:
diff changeset
   110
	//--------------------------------------------------
hgs
parents:
diff changeset
   111
protected:
hgs
parents:
diff changeset
   112
	//--------------------------------------------------
hgs
parents:
diff changeset
   113
hgs
parents:
diff changeset
   114
	//--------------------------------------------------
hgs
parents:
diff changeset
   115
public:
hgs
parents:
diff changeset
   116
	//--------------------------------------------------
hgs
parents:
diff changeset
   117
hgs
parents:
diff changeset
   118
	/**
hgs
parents:
diff changeset
   119
	 * The destructor of the eap_core class does nothing special.
hgs
parents:
diff changeset
   120
	 */
49
hgs
parents: 26
diff changeset
   121
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H virtual ~eap_plugin_client_message_if_c();
26
hgs
parents:
diff changeset
   122
hgs
parents:
diff changeset
   123
	/**
hgs
parents:
diff changeset
   124
	 * The constructor initializes member attributes using parameters passed to it.
hgs
parents:
diff changeset
   125
	 * @param tools is pointer to the tools class. @see abs_eap_am_tools_c.
hgs
parents:
diff changeset
   126
	 * @param partner is back pointer to object which created this object.
hgs
parents:
diff changeset
   127
	 * @param is_client_when_true indicates whether the network entity should act
hgs
parents:
diff changeset
   128
	 * as a client (true) or server (false), in terms of EAP-protocol
hgs
parents:
diff changeset
   129
	 * whether this network entity is EAP-supplicant (true) or EAP-authenticator (false).
hgs
parents:
diff changeset
   130
	 */
49
hgs
parents: 26
diff changeset
   131
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_plugin_client_message_if_c(
26
hgs
parents:
diff changeset
   132
		abs_eap_am_tools_c * const tools,
hgs
parents:
diff changeset
   133
		eap_am_message_if_c * const client_if,
hgs
parents:
diff changeset
   134
		abs_eap_plugin_message_c * const partner);
hgs
parents:
diff changeset
   135
hgs
parents:
diff changeset
   136
	/**
hgs
parents:
diff changeset
   137
	 * This function must reset the state of object to same as 
hgs
parents:
diff changeset
   138
	 * state was after the configure() function call.
hgs
parents:
diff changeset
   139
	 * If object reset succeeds this function must return eap_status_ok.
hgs
parents:
diff changeset
   140
	 * If object reset fails this function must return corresponding error status.
hgs
parents:
diff changeset
   141
	 * @return This function returns the status of reset operation.
hgs
parents:
diff changeset
   142
	 */
49
hgs
parents: 26
diff changeset
   143
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e reset();
26
hgs
parents:
diff changeset
   144
hgs
parents:
diff changeset
   145
	// This is documented in abs_eap_stack_interface_c::configure().
49
hgs
parents: 26
diff changeset
   146
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e configure();
26
hgs
parents:
diff changeset
   147
hgs
parents:
diff changeset
   148
	// This is documented in abs_eap_stack_interface_c::shutdown().
49
hgs
parents: 26
diff changeset
   149
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e shutdown();
26
hgs
parents:
diff changeset
   150
hgs
parents:
diff changeset
   151
	// This is documented in abs_eap_stack_interface_c::get_is_valid().
49
hgs
parents: 26
diff changeset
   152
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H bool get_is_valid();
26
hgs
parents:
diff changeset
   153
49
hgs
parents: 26
diff changeset
   154
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e process_message(eap_process_tlv_message_data_c * const message);
26
hgs
parents:
diff changeset
   155
49
hgs
parents: 26
diff changeset
   156
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e get_configuration(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   157
49
hgs
parents: 26
diff changeset
   158
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e set_configuration(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   159
49
hgs
parents: 26
diff changeset
   160
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e copy_configuration(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   161
49
hgs
parents: 26
diff changeset
   162
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e delete_configuration(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   163
49
hgs
parents: 26
diff changeset
   164
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e set_index(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   165
49
hgs
parents: 26
diff changeset
   166
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e get_type_info(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   167
49
hgs
parents: 26
diff changeset
   168
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e invoke_ui(const eap_method_settings_c * const internal_settings);
26
hgs
parents:
diff changeset
   169
49
hgs
parents: 26
diff changeset
   170
	EAP_FUNC_VISIBILITY_EAP_PLUGIN_CLIENT_MESSAGE_IF_H eap_status_e send_data(const void * const data, const u32_t length);
26
hgs
parents:
diff changeset
   171
hgs
parents:
diff changeset
   172
	//--------------------------------------------------
hgs
parents:
diff changeset
   173
}; // class eap_plugin_client_message_if_c
hgs
parents:
diff changeset
   174
hgs
parents:
diff changeset
   175
//--------------------------------------------------
hgs
parents:
diff changeset
   176
hgs
parents:
diff changeset
   177
#endif //#if !defined(_EAP_PLUGIN_CLIENT_MESSAGE_IF_H_)
hgs
parents:
diff changeset
   178
hgs
parents:
diff changeset
   179
//--------------------------------------------------
hgs
parents:
diff changeset
   180
hgs
parents:
diff changeset
   181
hgs
parents:
diff changeset
   182
hgs
parents:
diff changeset
   183
// End.