eapol/eapol_framework/eapol_common/type/diameter/include/eap_diameter_payloads.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:23:57 +0100
branchRCL_3
changeset 46 c74b3d9f6b9e
parent 45 bad0cc58d154
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201029 Kit: 201035

/*
* Copyright (c) 2001-2006 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  EAP and WLAN authentication protocols.
*
*/

/*
* %version: 13 %
*/

#if !defined(_EAP_DIAMETER_RESULT_H_)
#define _EAP_DIAMETER_RESULT_H_

#include "eap_variable_data.h"
#include "eap_am_export.h"
#include "eap_diameter_avp_header.h"
#include "eap_diameter_avp_code.h"
#include "eap_core_map.h"
#include "eap_array.h"


class EAP_EXPORT eap_diameter_variable_data_c
{
private:
	//--------------------------------------------------

	abs_eap_am_tools_c * const m_am_tools;

	eap_variable_data_c m_data;

	eap_diameter_avp_code_c m_payload_code;

	bool m_is_mandatory;

	//--------------------------------------------------
protected:
	//--------------------------------------------------

	//--------------------------------------------------
public:
	//--------------------------------------------------

	EAP_FUNC_IMPORT virtual ~eap_diameter_variable_data_c();

	EAP_FUNC_IMPORT eap_diameter_variable_data_c(abs_eap_am_tools_c * const tools);

	EAP_FUNC_IMPORT eap_status_e set_buffer(
		const eap_diameter_avp_code_c current_payload_code,
		const bool is_mandatory,
		const u8_t * const buffer,
		const u32_t buffer_length,
		const bool free_buffer,
		const bool is_writable);

	EAP_FUNC_IMPORT eap_status_e add_data(
		const u8_t * const buffer,
		const u32_t buffer_length);

	EAP_FUNC_IMPORT u32_t get_data_length() const;

	EAP_FUNC_IMPORT u8_t * get_data(const u32_t data_length) const;

	EAP_FUNC_IMPORT eap_variable_data_c * get_payload_buffer();

	EAP_FUNC_IMPORT eap_diameter_avp_code_c get_payload_code() const;

	EAP_FUNC_IMPORT bool get_is_mandatory() const;

	EAP_FUNC_IMPORT void set_payload_code(const eap_diameter_avp_code_c code);

	EAP_FUNC_IMPORT eap_diameter_variable_data_c * copy() const;

	EAP_FUNC_IMPORT  void object_increase_reference_count();

	//--------------------------------------------------
}; // class eap_diameter_variable_data_c


//--------------------------------------------------


// 
class EAP_EXPORT eap_diameter_payloads_c
: public abs_eap_core_map_c
{
private:
	//--------------------------------------------------

	abs_eap_am_tools_c * const m_am_tools;

	/// This stores the eap_diameter_variable_data_c objects using eap_variable_data selector.
	eap_core_map_c<eap_diameter_variable_data_c, abs_eap_core_map_c, eap_variable_data_c> m_payload_map;

	/// This stores the same eap_diameter_variable_data_c objects to array.
	/// This is to speed the sequential check of all payloads.
	eap_array_c<eap_diameter_variable_data_c> m_read_payloads;

	bool m_is_valid;

	//--------------------------------------------------
protected:
	//--------------------------------------------------

	//--------------------------------------------------
public:
	//--------------------------------------------------

	EAP_FUNC_IMPORT virtual ~eap_diameter_payloads_c();

	EAP_FUNC_IMPORT eap_diameter_payloads_c(
		abs_eap_am_tools_c * const tools);

	EAP_FUNC_IMPORT eap_diameter_variable_data_c * get_payload(
		const eap_diameter_avp_code_c current_payload);

	EAP_FUNC_IMPORT eap_status_e add_payload(
		const eap_diameter_avp_code_c current_payload,
		const bool is_mandatory,
		const u8_t * const data,
		const u32_t data_length,
		const bool free_buffer,
		const bool is_writable,
		const bool fragments_allowed);

	/**
	 * This function parses the payloads starting from specified payload (p_payload).
	 * Function parses all payloads from the buffer.
	 * Payloads are stored to p_radius_payloads.
	 * @return If the length of the buffer and sum of the length of all payloads does not match
	 * function returns eap_status_header_corrupted.
	 * Also error is returned when illegal payload attribute is recognised.
	 */
	EAP_FUNC_IMPORT eap_status_e parse_diameter_payloads(
		const eap_diameter_avp_header_c * const p_payload, ///< This is the start of the buffer and the first parsed payload.
		u32_t * const buffer_length ///< This is the length of the buffer. This must match with the length of all payloads.
		);

	/**
	 * This function parses each payload attributes.
	 * @return If payload attribute is illegal function returns eap_status_header_corrupted.
	 * If payload attribute is unknown function returns eap_status_unsupported_payload.
	 */
	EAP_FUNC_IMPORT eap_status_e parse_generic_payload(
		const eap_diameter_avp_code_c current_payload, ///< This is the type of current payload attribute.
		const eap_diameter_avp_header_c * const payload ///< This is the current parsed payload.
		);

	/**
	 * This function checks all mandatory AVPs are used.
	 */
	EAP_FUNC_IMPORT eap_status_e check_mandatory_payloads(
		EAP_TEMPLATE_CONST eap_array_c<eap_diameter_avp_code_c> * const used_payloads);

	/**
	 * This function checks all required AVPs are received.
	 */
	EAP_FUNC_IMPORT eap_status_e check_payloads_existense(
		EAP_TEMPLATE_CONST eap_array_c<eap_diameter_avp_code_c> * const needed_payloads);

	EAP_FUNC_IMPORT bool get_is_valid() const;

	EAP_FUNC_IMPORT eap_status_e reset();

	//--------------------------------------------------
}; // class eap_diameter_payloads_c


#endif //#if !defined(_EAP_DIAMETER_RESULT_H_)

//--------------------------------------------------



// End.