---

ThreadContext.hpp

#if !defined(__THREADCONTEXT_HPP)
#define __THREADCONTEXT_HPP

/*
  CoreLinux++ 
  Copyright (C) 1999,2000 CoreLinux Consortium
  
   The CoreLinux++ Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   The CoreLinux++ Library Library is distributed in the hope that it will 
   be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with the GNU C Library; see the file COPYING.LIB.  If not,
   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.  
*/

#if   !defined(__COMMON_HPP)
#include <Common.hpp>
#endif

#if   !defined(__THREADEXCEPTION_HPP)
#include <ThreadException.hpp>
#endif

namespace corelinux
{


   enum  ThreadState
   {

      THREAD_WAITING_TO_START = 0,


      THREAD_STARTING,


      THREAD_RUNNING,


      THREAD_NORMAL_EXIT,


      THREAD_START_EXCEPTION,


      THREAD_EXCEPTION,


      THREAD_START_FAILED

   };


   DECLARE_CLASS( ThreadContext );

   typedef  int (*CallerFunctionPtr)(ThreadContextPtr);  

   typedef  Int (*ThreadFrameFunctionPtr)( ThreadContextPtr );

   typedef  ThreadContextPtr (*ThreadContextCreatePtr)( ThreadContextRef );

   typedef  void  (*ThreadContextDestroyPtr)( ThreadContextPtr );

   typedef  BytePtr (*ThreadStackCreatePtr)( ThreadContextPtr );

   typedef  void  (*ThreadStackDestroyPtr)( BytePtr );

   class ThreadContext : public Synchronized
   {

   public:

      //
      // Constructors and destructor
      //

                        ThreadContext( CallerFunctionPtr )
                           throw ( Assertion );

                        ThreadContext( CallerFunctionPtr, Size )
                           throw ( Assertion );

                        ThreadContext( ThreadContextCref )
  //                         throw ( ThreadNotWaitingException, Assertion );
                           throw ( Assertion );


      virtual           ~ThreadContext( void );

      //
      // Operator overloads
      //

               ThreadContextRef  operator=( ThreadContextCref )
                  throw( Assertion );

               bool  operator==( ThreadContextCref ) const;

               bool  operator==( ThreadIdentifierCref ) const;

               bool  operator==( CallerFunctionPtr ) const;

                     operator ThreadIdentifierCref( void ) const;
      //
      // Accessors
      //

               const ThreadState &  getState( void ) const;

               Size     getStackSize( void ) const;

               Int      getShareMask( void ) const;

               Int      getReturnCode( void ) const;

               ThreadIdentifierCref getIdentifier( void ) const;

      virtual  ThreadFrameFunctionPtr  getFramePointer( void );


               BytePtr  getStack( void );


               BytePtr  *getStackTop( void );

      //
      // Mutators
      //

               void  setShareMask( Int );

               void setFrameFunction( ThreadFrameFunctionPtr );

               void  setContextFunctions
                  (
                     ThreadContextCreatePtr ,
                     ThreadContextDestroyPtr 
                  );

               void  setStackFunctions
                  (
                     ThreadStackCreatePtr ,
                     ThreadStackDestroyPtr 
                  );


               void  setReturnCode( Int );

               void  setThreadState( ThreadState );

      static   Int   cloneFrameFunction( ThreadContextPtr );

      //
      // Factory invocations
      //

               ThreadContextPtr  createContext( void ) 
                  throw ( ThreadException );

               void  destroyContext( ThreadContextPtr ) throw ( Assertion );

   protected:

      //
      // Constructors
      //

                        ThreadContext( void ) throw ( Assertion );

      //
      // Operator overloads
      //

               ThreadContextRef  operator=( ThreadIdentifier );

      //
      // Accessors
      //

               CallerFunctionPtr    getCallerFunction( void );

   private:

      //
      // Mutators
      //

      static   Int   defaultFrameFunction( ThreadContextPtr );

      //
      // Factory methods
      //

      static   ThreadContextPtr  defaultContextCreate( ThreadContextRef );

      static   void  defaultContextDestroy( ThreadContextPtr );

      static   BytePtr  defaultStackCreate( ThreadContextPtr );

      static   void     defaultStackDestroy( BytePtr );


   private:


      static   ThreadFrameFunctionPtr  theDefaultFrameFunction;


      static   ThreadContextCreatePtr  theDefaultContextCreator;


      static   ThreadContextDestroyPtr theDefaultContextDestroyer;


      static   ThreadStackCreatePtr    theDefaultStackCreator;


      static   ThreadStackDestroyPtr   theDefaultStackDestroyer;


               ThreadFrameFunctionPtr  theFrameFunction;
         
         
               ThreadContextCreatePtr  theContextCreator;
         
         
               ThreadContextDestroyPtr theContextDestroyer;
         
         
               ThreadStackCreatePtr    theStackCreator;
         
         
               ThreadStackDestroyPtr   theStackDestroyer;


               BytePtr              theStack;      


               Size                 theStackSize;


               Int                  theShareMask;


               ThreadIdentifier     theThreadIdentifier;


               CallerFunctionPtr    theCallersFunction;


               ThreadState          theThreadState;


               Int                  theReturnCode;
   };

}

#endif // if !defined(__THREADCONTEXT_HPP)

/*
   Common rcs information do not modify
   $Author: prudhomm $
   $Revision: 1.1 $
   $Date: 2000/04/23 20:43:13 $
   $Locker:  $
*/

---

This is the CoreLinux++ reference manual
Provided by The CoreLinux Consortium