/*
* 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: %
*/
#if !defined( _ABS_EAP_AM_SEMAPHORE_H_ )
#define _ABS_EAP_AM_SEMAPHORE_H_
#include "eap_am_types.h"
#include "eap_variable_data.h"
#include "eap_am_export.h"
// Start: added by script change_export_macros.sh.
#if defined(EAP_NO_EXPORT_ABS_EAP_AM_SEMAPHORE_H)
#define EAP_CLASS_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_NONSHARABLE
#define EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H
#define EAP_C_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H
#define EAP_FUNC_EXPORT_ABS_EAP_AM_SEMAPHORE_H
#define EAP_C_FUNC_EXPORT_ABS_EAP_AM_SEMAPHORE_H
#elif defined(EAP_EXPORT_ABS_EAP_AM_SEMAPHORE_H)
#define EAP_CLASS_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_EXPORT
#define EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_FUNC_EXPORT
#define EAP_C_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_C_FUNC_EXPORT
#define EAP_FUNC_EXPORT_ABS_EAP_AM_SEMAPHORE_H EAP_FUNC_EXPORT
#define EAP_C_FUNC_EXPORT_ABS_EAP_AM_SEMAPHORE_H EAP_C_FUNC_EXPORT
#else
#define EAP_CLASS_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_IMPORT
#define EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_FUNC_IMPORT
#define EAP_C_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H EAP_C_FUNC_IMPORT
#define EAP_FUNC_EXPORT_ABS_EAP_AM_SEMAPHORE_H
#define EAP_C_FUNC_EXPORT_ABS_EAP_AM_SEMAPHORE_H
#endif
// End: added by script change_export_macros.sh.
class eap_am_semaphore_reference_c;
// ---------------------------------------------
/// This class is interface to semaphore.
class EAP_CLASS_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H abs_eap_am_semaphore_c
{
private:
public:
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual ~abs_eap_am_semaphore_c();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H abs_eap_am_semaphore_c();
// - - - - - - - - - - - - - - - - - - - - - - - -
/**
* This function reserves the semaphore. Thread will block until the semaphore is released
* by other owner of the semaphore.
*/
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual eap_status_e semaphore_reserve() = 0;
/**
* This function releases the semaphore. Other blocking thread will continue execution.
*/
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual eap_status_e semaphore_release() = 0;
/**
* The semaphore handle must be dublicated in Symbian operating system for each thread.
*/
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual abs_eap_am_semaphore_c * dublicate_semaphore() = 0;
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual u32_t get_count() const = 0;
/**
* Returns the validity of the semaphore.
*/
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual bool get_is_valid() const = 0;
#if defined(USE_EAPOL_MUTEX_SEMAPHORE_TRACES)
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual eap_am_semaphore_reference_c * get_reference() const = 0;
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual void set_am_tools(abs_eap_am_tools_c * const tools) = 0;
#endif //#if defined(USE_EAPOL_MUTEX_SEMAPHORE_TRACES)
// - - - - - - - - - - - - - - - - - - - - - - - -
};
// ---------------------------------------------
/// This class defines a reference counter of a semaphore.
class EAP_CLASS_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H eap_am_semaphore_reference_c
{
private:
/// This is the reference count to the semaphore.
u32_t m_reference_count;
public:
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual ~eap_am_semaphore_reference_c();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H eap_am_semaphore_reference_c();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H void add_reference();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H void remove_reference();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H u32_t get_reference_count();
};
// ---------------------------------------------
/// This class is base of the semaphore.
class EAP_CLASS_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H eap_am_semaphore_base_c
{
private:
eap_am_semaphore_reference_c * m_reference;
bool m_is_valid;
public:
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H virtual ~eap_am_semaphore_base_c();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H eap_am_semaphore_base_c();
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H eap_am_semaphore_base_c(const eap_am_semaphore_base_c * const owner);
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H eap_am_semaphore_reference_c * get_reference() const;
// - - - - - - - - - - - - - - - - - - - - - - - -
/// Returns the validity of the semaphore.
EAP_FUNC_VISIBILITY_ABS_EAP_AM_SEMAPHORE_H bool get_is_valid() const;
// - - - - - - - - - - - - - - - - - - - - - - - -
};
// ---------------------------------------------
#endif //#if !defined( _ABS_EAP_AM_SEMAPHORE_H_ )
// End.