#ifndef CYGONCE_KERNEL_SEMA_HXX
|
#ifndef CYGONCE_KERNEL_SEMA_HXX
|
#define CYGONCE_KERNEL_SEMA_HXX
|
#define CYGONCE_KERNEL_SEMA_HXX
|
|
|
//==========================================================================
|
//==========================================================================
|
//
|
//
|
// sema.hxx
|
// sema.hxx
|
//
|
//
|
// Semaphore class declarations
|
// Semaphore class declarations
|
//
|
//
|
//==========================================================================
|
//==========================================================================
|
//####ECOSGPLCOPYRIGHTBEGIN####
|
//####ECOSGPLCOPYRIGHTBEGIN####
|
// -------------------------------------------
|
// -------------------------------------------
|
// This file is part of eCos, the Embedded Configurable Operating System.
|
// This file is part of eCos, the Embedded Configurable Operating System.
|
// Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
|
// Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
|
//
|
//
|
// eCos is free software; you can redistribute it and/or modify it under
|
// eCos is free software; you can redistribute it and/or modify it under
|
// the terms of the GNU General Public License as published by the Free
|
// the terms of the GNU General Public License as published by the Free
|
// Software Foundation; either version 2 or (at your option) any later version.
|
// Software Foundation; either version 2 or (at your option) any later version.
|
//
|
//
|
// eCos is distributed in the hope that it will be useful, but WITHOUT ANY
|
// eCos is distributed in the hope that it will be useful, but WITHOUT ANY
|
// WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
// WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
// for more details.
|
// for more details.
|
//
|
//
|
// You should have received a copy of the GNU General Public License along
|
// You should have received a copy of the GNU General Public License along
|
// with eCos; if not, write to the Free Software Foundation, Inc.,
|
// with eCos; if not, write to the Free Software Foundation, Inc.,
|
// 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
|
// 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
|
//
|
//
|
// As a special exception, if other files instantiate templates or use macros
|
// As a special exception, if other files instantiate templates or use macros
|
// or inline functions from this file, or you compile this file and link it
|
// or inline functions from this file, or you compile this file and link it
|
// with other works to produce a work based on this file, this file does not
|
// with other works to produce a work based on this file, this file does not
|
// by itself cause the resulting work to be covered by the GNU General Public
|
// by itself cause the resulting work to be covered by the GNU General Public
|
// License. However the source code for this file must still be made available
|
// License. However the source code for this file must still be made available
|
// in accordance with section (3) of the GNU General Public License.
|
// in accordance with section (3) of the GNU General Public License.
|
//
|
//
|
// This exception does not invalidate any other reasons why a work based on
|
// This exception does not invalidate any other reasons why a work based on
|
// this file might be covered by the GNU General Public License.
|
// this file might be covered by the GNU General Public License.
|
//
|
//
|
// Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
|
// Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
|
// at http://sources.redhat.com/ecos/ecos-license/
|
// at http://sources.redhat.com/ecos/ecos-license/
|
// -------------------------------------------
|
// -------------------------------------------
|
//####ECOSGPLCOPYRIGHTEND####
|
//####ECOSGPLCOPYRIGHTEND####
|
//==========================================================================
|
//==========================================================================
|
//#####DESCRIPTIONBEGIN####
|
//#####DESCRIPTIONBEGIN####
|
//
|
//
|
// Author(s): nickg
|
// Author(s): nickg
|
// Contributors: nickg
|
// Contributors: nickg
|
// Date: 1997-09-09
|
// Date: 1997-09-09
|
// Purpose: Define Semaphore class interfaces
|
// Purpose: Define Semaphore class interfaces
|
// Description: The classes defined here provide the APIs for binary
|
// Description: The classes defined here provide the APIs for binary
|
// and counting semaphores.
|
// and counting semaphores.
|
// Usage: #include
|
// Usage: #include
|
//
|
//
|
//
|
//
|
//####DESCRIPTIONEND####
|
//####DESCRIPTIONEND####
|
//
|
//
|
//==========================================================================
|
//==========================================================================
|
|
|
#include
|
#include
|
#include // assertion macros
|
#include // assertion macros
|
#include // thread inlines
|
#include // thread inlines
|
|
|
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
// Binary semaphore. This has only two states: posted and not-posted.
|
// Binary semaphore. This has only two states: posted and not-posted.
|
|
|
class Cyg_Binary_Semaphore
|
class Cyg_Binary_Semaphore
|
{
|
{
|
cyg_bool state; // The binary semaphore state
|
cyg_bool state; // The binary semaphore state
|
|
|
Cyg_ThreadQueue queue; // Queue of waiting threads
|
Cyg_ThreadQueue queue; // Queue of waiting threads
|
|
|
public:
|
public:
|
|
|
CYGDBG_DEFINE_CHECK_THIS
|
CYGDBG_DEFINE_CHECK_THIS
|
|
|
Cyg_Binary_Semaphore( // Constructor
|
Cyg_Binary_Semaphore( // Constructor
|
cyg_bool init_state = false // Initial state value
|
cyg_bool init_state = false // Initial state value
|
);
|
);
|
|
|
~Cyg_Binary_Semaphore(); // Destructor
|
~Cyg_Binary_Semaphore(); // Destructor
|
|
|
cyg_bool wait(); // Wait until state == true
|
cyg_bool wait(); // Wait until state == true
|
|
|
cyg_bool trywait(); // Set state false if possible
|
cyg_bool trywait(); // Set state false if possible
|
|
|
void post(); // Increment count
|
void post(); // Increment count
|
|
|
cyg_bool posted(); // Get current state
|
cyg_bool posted(); // Get current state
|
|
|
};
|
};
|
|
|
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
// Counting semaphore. This implements the usual counter based semaphore.
|
// Counting semaphore. This implements the usual counter based semaphore.
|
|
|
class Cyg_Counting_Semaphore
|
class Cyg_Counting_Semaphore
|
{
|
{
|
cyg_count32 count; // The semaphore count
|
cyg_count32 count; // The semaphore count
|
|
|
Cyg_ThreadQueue queue; // Queue of waiting threads
|
Cyg_ThreadQueue queue; // Queue of waiting threads
|
|
|
public:
|
public:
|
|
|
CYGDBG_DEFINE_CHECK_THIS
|
CYGDBG_DEFINE_CHECK_THIS
|
|
|
Cyg_Counting_Semaphore( // Constructor
|
Cyg_Counting_Semaphore( // Constructor
|
cyg_count32 init_count = 0 // Initial count value
|
cyg_count32 init_count = 0 // Initial count value
|
);
|
);
|
|
|
~Cyg_Counting_Semaphore(); // Destructor
|
~Cyg_Counting_Semaphore(); // Destructor
|
|
|
cyg_bool wait(); // Wait until decrement
|
cyg_bool wait(); // Wait until decrement
|
|
|
#ifdef CYGFUN_KERNEL_THREADS_TIMER
|
#ifdef CYGFUN_KERNEL_THREADS_TIMER
|
cyg_bool wait( cyg_tick_count timeout );
|
cyg_bool wait( cyg_tick_count timeout );
|
#endif // Wait until decrement or timeout
|
#endif // Wait until decrement or timeout
|
|
|
cyg_bool trywait(); // Try to decrement
|
cyg_bool trywait(); // Try to decrement
|
|
|
void post(); // Increment count
|
void post(); // Increment count
|
|
|
cyg_count32 peek() const; // Get current count value
|
cyg_count32 peek() const; // Get current count value
|
|
|
inline
|
inline
|
cyg_bool waiting() // Is anyone waiting?
|
cyg_bool waiting() // Is anyone waiting?
|
{
|
{
|
return !queue.empty();
|
return !queue.empty();
|
}
|
}
|
|
|
};
|
};
|
|
|
// -------------------------------------------------------------------------
|
// -------------------------------------------------------------------------
|
#endif // ifndef CYGONCE_KERNEL_SEMA_HXX
|
#endif // ifndef CYGONCE_KERNEL_SEMA_HXX
|
// EOF sema.hxx
|
// EOF sema.hxx
|
|
|