(file) Return to Thread.h CVS log (file) (dir) Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/Thread.h between version 1.1.2.16 and 1.27

version 1.1.2.16, 2001/10/29 11:25:22 version 1.27, 2003/06/14 19:25:38
Line 1 
Line 1 
 //%///////////-*-c++-*-//////////////////////////////////////////////////////  //%/-*-c++-*-////////////////////////////////////////////////////////////////////////////
 // //
 // Copyright (c) 2000, 2001 The Open group, BMC Software, Tivoli Systems, IBM  // Copyright (c) 2000, 2001, 2002 BMC Software, Hewlett-Packard Company, IBM,
   // The Open Group, Tivoli Systems
 // //
 // Permission is hereby granted, free of charge, to any person obtaining a copy // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to // of this software and associated documentation files (the "Software"), to
Line 26 
Line 27 
 // //
 //%///////////////////////////////////////////////////////////////////////////// //%/////////////////////////////////////////////////////////////////////////////
  
   
 #ifndef Pegasus_Thread_h #ifndef Pegasus_Thread_h
 #define Pegasus_Thread_h #define Pegasus_Thread_h
 #include <Pegasus/Common/IPC.h>  
   #include <cstring>
 #include <Pegasus/Common/Config.h> #include <Pegasus/Common/Config.h>
 #include <Pegasus/Common/Exception.h>  #include <Pegasus/Common/IPC.h>
   #include <Pegasus/Common/InternalException.h>
 #include <Pegasus/Common/DQueue.h> #include <Pegasus/Common/DQueue.h>
   #include <Pegasus/Common/Linkage.h>
  
 PEGASUS_NAMESPACE_BEGIN PEGASUS_NAMESPACE_BEGIN
  
Line 65 
Line 68 
  
 /////////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////////
  
 class PEGASUS_COMMON_LINKAGE SimpleThread  
 {  
   
    public:  
       SimpleThread( PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *start )(void *),  
                     void *parameter, Boolean detached );  
   
       ~SimpleThread();  
   
       void run(void);  
   
       Uint32 threadId(void);  
   
       // get the user parameter  
       void *get_parm(void);  
   
       // cancellation must be deferred (not asynchronous)  
       // for user-level threads the thread itself can decide  
       // when it should die.  
       void cancel(void);  
   
       void kill(int signum);  
   
       // cancel if there is a pending cancellation request  
       void test_cancel(void);  
   
       // for user-level threads  - put the calling thread  
       // to sleep and jump to the thread scheduler.  
       // platforms with preemptive scheduling and native threads  
       // can define this to be a no-op.  
       // platforms without preemptive scheduling like NetWare  
       // or gnu portable threads will have an existing  
       // routine that can be mapped to this method  
   
       void thread_switch(void);  
   
       // suspend this thread  
       void suspend(void) ;  
   
       // resume this thread  
       void resume(void) ;  
   
       void sleep(Uint32 msec) ;  
   
       // block the calling thread until this thread terminates  
       void join( PEGASUS_THREAD_RETURN *ret_val);  
   
   
       // stack of functions to be called when thread terminates  
       // will be called last in first out (LIFO)  
       void cleanup_push( void (*routine) (void *), void *parm );  
       void cleanup_pop(Boolean execute) ;  
   
       PEGASUS_THREAD_TYPE self(void) ;  
   
    private:  
       SimpleThread();  
   
       PEGASUS_THREAD_HANDLE _handle;  
       Boolean _is_detached;  
       Boolean _cancel_enabled;  
       Boolean _cancelled;  
   
       //PEGASUS_SEM_HANDLE _suspend_count;  
       Semaphore _suspend;  
   
       // always pass this * as the void * parameter to the thread  
       // store the user parameter in _thread_parm  
   
       PEGASUS_THREAD_RETURN  ( PEGASUS_THREAD_CDECL *_start)(void *) ;  
   
       void *_thread_parm;  
 } ;  
   
 ///////////////////////////////////////////////////////////////////////////////  
   
   
  
 class  PEGASUS_COMMON_LINKAGE thread_data class  PEGASUS_COMMON_LINKAGE thread_data
 { {
Line 149 
Line 75 
    public:    public:
       static void default_delete(void *data);       static void default_delete(void *data);
  
       thread_data( Sint8 *key ) : _delete_func(NULL) , _data(NULL), _size(0)        thread_data( const Sint8 *key ) : _delete_func(NULL) , _data(NULL), _size(0)
       {       {
          PEGASUS_ASSERT(key != NULL);          PEGASUS_ASSERT(key != NULL);
          size_t keysize = strlen(key);          size_t keysize = strlen(key);
Line 159 
Line 85 
  
       }       }
  
       thread_data(Sint8 *key, size_t size) : _delete_func(default_delete), _size(size)        thread_data(const Sint8 *key, size_t size) : _delete_func(default_delete), _size(size)
       {       {
          PEGASUS_ASSERT(key != NULL);          PEGASUS_ASSERT(key != NULL);
          size_t keysize = strlen(key);          size_t keysize = strlen(key);
Line 170 
Line 96 
  
       }       }
  
       thread_data(Sint8 *key, size_t size, void *data) : _delete_func(default_delete), _size(size)        thread_data(const Sint8 *key, size_t size, void *data) : _delete_func(default_delete), _size(size)
       {       {
          PEGASUS_ASSERT(key != NULL);          PEGASUS_ASSERT(key != NULL);
          PEGASUS_ASSERT(data != NULL);          PEGASUS_ASSERT(data != NULL);
Line 187 
Line 113 
       {       {
          if( _data != NULL)          if( _data != NULL)
             if(_delete_func != NULL)             if(_delete_func != NULL)
               {
                _delete_func( _data );                _delete_func( _data );
               }
          if( _key != NULL )          if( _key != NULL )
             delete [] _key;             delete [] _key;
       }       }
Line 217 
Line 145 
  
       }       }
  
       void copy_data(void **buf, size_t *size) throw(BufferTooSmall, NullPointer)        void copy_data(void **buf, size_t *size) throw(NullPointer)
       {       {
          if((buf == NULL) || (size == NULL))          if((buf == NULL) || (size == NULL))
             throw NullPointer() ;             throw NullPointer() ;
Line 233 
Line 161 
             return(true);             return(true);
          return(false);          return(false);
       }       }
   
       inline Boolean operator==(const thread_data& b) const       inline Boolean operator==(const thread_data& b) const
       {       {
          return(operator==((const void *)b._key));          return(operator==((const void *)b._key));
Line 279 
Line 208 
       // cancel if there is a pending cancellation request       // cancel if there is a pending cancellation request
       void test_cancel(void);       void test_cancel(void);
  
         Boolean is_cancelled(void);
   
       // for user-level threads  - put the calling thread       // for user-level threads  - put the calling thread
       // to sleep and jump to the thread scheduler.       // to sleep and jump to the thread scheduler.
       // platforms with preemptive scheduling and native threads       // platforms with preemptive scheduling and native threads
Line 289 
Line 220 
  
       void thread_switch(void);       void thread_switch(void);
  
 #ifdef PEGASUS_PLATFORM_LINUX_IX86_GNU  #if defined(PEGASUS_PLATFORM_LINUX_GENERIC_GNU)
       // suspend this thread       // suspend this thread
       void suspend(void) ;       void suspend(void) ;
  
Line 297 
Line 228 
       void resume(void) ;       void resume(void) ;
 #endif #endif
  
       void sleep(Uint32 msec) ;        static void sleep(Uint32 msec) ;
  
       // block the calling thread until this thread terminates       // block the calling thread until this thread terminates
       void join( void );       void join( void );
Line 313 
Line 244 
       void cleanup_pop(Boolean execute = true) throw(IPCException);       void cleanup_pop(Boolean execute = true) throw(IPCException);
  
       // create and initialize a tsd       // create and initialize a tsd
       inline void create_tsd(Sint8 *key, int size, void *buffer) throw(IPCException)        inline void create_tsd(const Sint8 *key, int size, void *buffer) throw(IPCException)
       {       {
          thread_data *tsd = new thread_data(key, size, buffer);          thread_data *tsd = new thread_data(key, size, buffer);
          try { _tsd.insert_first(tsd); }          try { _tsd.insert_first(tsd); }
Line 322 
Line 253 
  
       // get the buffer associated with the key       // get the buffer associated with the key
       // NOTE: this call leaves the tsd LOCKED !!!!       // NOTE: this call leaves the tsd LOCKED !!!!
       inline void *reference_tsd(Sint8 *key) throw(IPCException)        inline void *reference_tsd(const Sint8 *key) throw(IPCException)
       {       {
          _tsd.lock();          _tsd.lock();
          thread_data *tsd = _tsd.reference((void *)key);           thread_data *tsd = _tsd.reference((const void *)key);
          if(tsd != NULL)          if(tsd != NULL)
             return( (void *)(tsd->_data) );             return( (void *)(tsd->_data) );
          else          else
             return(NULL);             return(NULL);
       }       }
  
       inline void *try_reference_tsd(Sint8 *key) throw(IPCException)        inline void *try_reference_tsd(const Sint8 *key) throw(IPCException)
       {       {
          _tsd.try_lock();          _tsd.try_lock();
          thread_data *tsd = _tsd.reference((void *)key);           thread_data *tsd = _tsd.reference((const void *)key);
          if(tsd != NULL)          if(tsd != NULL)
             return((void *)(tsd->_data) );             return((void *)(tsd->_data) );
          else          else
Line 351 
Line 282 
       }       }
  
       // delete the tsd associated with the key       // delete the tsd associated with the key
       inline void delete_tsd(Sint8 *key) throw(IPCException)        inline void delete_tsd(const Sint8 *key) throw(IPCException)
       {       {
          thread_data *tsd = _tsd.remove((void *)key);           thread_data *tsd = _tsd.remove((const void *)key);
          if(tsd != NULL)          if(tsd != NULL)
             delete tsd;             delete tsd;
       }       }
  
       inline void *remove_tsd(Sint8 *key) throw(IPCException)        // Note: Caller must delete the thread_data object returned (if not null)
         inline void *remove_tsd(const Sint8 *key) throw(IPCException)
       {       {
          return(_tsd.remove((void *)key));           return(_tsd.remove((const void *)key));
       }       }
  
       inline void empty_tsd(void) throw(IPCException)       inline void empty_tsd(void) throw(IPCException)
       {       {
          _tsd.empty_list();           thread_data* tsd;
            while (0 != (tsd = _tsd.remove_first()))
            {
               delete tsd;
            }
            //_tsd.empty_list();
       }       }
  
       // create or re-initialize tsd associated with the key       // create or re-initialize tsd associated with the key
       // if the tsd already exists, return the existing buffer        // if the tsd already exists, delete the existing buffer
       thread_data *put_tsd(Sint8 *key, void (*delete_func)(void *), Uint32 size, void *value)        void put_tsd(const Sint8 *key, void (*delete_func)(void *), Uint32 size, void *value)
          throw(IPCException)          throw(IPCException)
  
       {       {
          PEGASUS_ASSERT(key != NULL);          PEGASUS_ASSERT(key != NULL);
          PEGASUS_ASSERT(delete_func != NULL);  
          thread_data *tsd ;          thread_data *tsd ;
          tsd = _tsd.remove((void *)key);  // may throw an IPC exception           tsd = _tsd.remove((const void *)key);  // may throw an IPC exception
            delete tsd;
          thread_data *ntsd = new thread_data(key);          thread_data *ntsd = new thread_data(key);
          ntsd->put_data(delete_func, size, value);          ntsd->put_data(delete_func, size, value);
          try { _tsd.insert_first(ntsd); }          try { _tsd.insert_first(ntsd); }
          catch(IPCException& e) { e = e; delete ntsd; throw; }          catch(IPCException& e) { e = e; delete ntsd; throw; }
          return(tsd);  
       }       }
       inline PEGASUS_THREAD_RETURN get_exit(void) { return _exit_code; }       inline PEGASUS_THREAD_RETURN get_exit(void) { return _exit_code; }
       inline PEGASUS_THREAD_TYPE self(void) {return pegasus_thread_self(); }       inline PEGASUS_THREAD_TYPE self(void) {return pegasus_thread_self(); }
Line 400 
Line 336 
          return(operator==((const void *)&b ));          return(operator==((const void *)&b ));
       }       }
  
         void detach(void);
   
    private:    private:
       Thread();       Thread();
       inline void create_tsd(Sint8 *key ) throw(IPCException)        inline void create_tsd(const Sint8 *key ) throw(IPCException)
       {       {
          thread_data *tsd = new thread_data(key);          thread_data *tsd = new thread_data(key);
          try { _tsd.insert_first(tsd); }          try { _tsd.insert_first(tsd); }
Line 434 
Line 372 
    public:    public:
  
       ThreadPool(Sint16 initial_size,       ThreadPool(Sint16 initial_size,
                  Sint16 max,                   const Sint8 *key,
                  Sint16 min,                  Sint16 min,
                  Sint8 *key);                   Sint16 max,
                    struct timeval & alloc_wait,
                    struct timeval & dealloc_wait,
                    struct timeval & deadlock_detect);
  
       ~ThreadPool(void);       ~ThreadPool(void);
   
       void allocate_and_awaken(void *parm,       void allocate_and_awaken(void *parm,
                                PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *work)(void *))                                 PEGASUS_THREAD_RETURN (PEGASUS_THREAD_CDECL *work)(void *),
                                  Semaphore *blocking = 0)
            throw(IPCException);
   
   
         Uint32 kill_dead_threads( void )
          throw(IPCException);          throw(IPCException);
  
       void get_key(Sint8 *buf, int bufsize);       void get_key(Sint8 *buf, int bufsize);
  
       // accessors for min, max, wait        inline Boolean operator==(const void *key) const
         {
            if ( ! strncmp( reinterpret_cast<Sint8 *>(const_cast<void *>(key)), _key, 16  ))
               return(true);
            return(false);
         }
         inline Boolean operator==(const ThreadPool & b) const
         {
            return(operator==((const void *) b._key ));
         }
   
         inline void set_min_threads(Sint16 min)
         {
            _min_threads = min;
         }
   
         inline Sint16 get_min_threads(void) const
         {
            return _min_threads;
         }
   
         inline void set_max_threads(Sint16 max)
         {
            _max_threads = max;
         }
   
         inline Sint16 get_max_threads(void) const
         {
            return _max_threads;
         }
   
         inline void set_allocate_wait(const struct timeval & alloc_wait)
         {
            _allocate_wait.tv_sec = alloc_wait.tv_sec;
            _allocate_wait.tv_usec = alloc_wait.tv_usec;
         }
   
         inline struct timeval *get_allocate_wait(struct timeval *buffer) const
         {
            if(buffer == 0)
               throw NullPointer();
            buffer->tv_sec = _allocate_wait.tv_sec;
            buffer->tv_usec = _allocate_wait.tv_usec;
            return buffer;
         }
   
         inline void set_deallocate_wait(const struct timeval & dealloc_wait)
         {
            _deallocate_wait.tv_sec = dealloc_wait.tv_sec;
            _deallocate_wait.tv_usec = dealloc_wait.tv_usec;
         }
   
         inline struct timeval *get_deallocate_wait(struct timeval *buffer) const
         {
            if(buffer == 0)
               throw NullPointer();
            buffer->tv_sec = _deallocate_wait.tv_sec;
            buffer->tv_usec = _deallocate_wait.tv_usec;
            return buffer;
         }
   
         inline void set_deadlock_detect(const struct timeval & deadlock)
         {
            _deadlock_detect.tv_sec = deadlock.tv_sec;
            _deadlock_detect.tv_usec = deadlock.tv_usec;
         }
   
         inline struct timeval * get_deadlock_detect(struct timeval *buffer) const
         {
            if(buffer == 0)
               throw NullPointer();
            buffer->tv_sec = _deadlock_detect.tv_sec;
            buffer->tv_usec = _deadlock_detect.tv_usec;
            return buffer;
         }
   
         inline Uint32 running_count(void)
         {
            return _running.count();
         }
   
         inline Uint32 pool_count(void)
           {
             return _pool.count();
           }
         inline Uint32 dead_count(void)
           {
             return _dead.count();
           }
   
   
         static Boolean check_time(struct timeval *start, struct timeval *interval);
   
         Boolean operator ==(const ThreadPool & p)
         {
            return operator==((const void *)&p);
         }
   
         Boolean operator ==(const void *p)
         {
            if((void *)this == p)
               return true;
            return false;
         }
   
         static void kill_idle_threads(void);
  
    private:    private:
       ThreadPool(void);       ThreadPool(void);
Line 456 
Line 508 
       struct timeval _deallocate_wait;       struct timeval _deallocate_wait;
       struct timeval _deadlock_detect;       struct timeval _deadlock_detect;
       static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL _loop(void *);       static PEGASUS_THREAD_RETURN PEGASUS_THREAD_CDECL _loop(void *);
       Semaphore _waiters;  
       Sint8 _key[17];       Sint8 _key[17];
       Semaphore _pool_sem;  
       DQueue<Thread>_pool;       DQueue<Thread>_pool;
       DQueue<Thread>_running;       DQueue<Thread>_running;
         DQueue<Thread> _dead;
       AtomicInt _dying;       AtomicInt _dying;
   
       void _kill_dead_threads(DQueue<Thread> *q, Boolean (*check)(struct timeval *))  
          throw(IPCException);  
       static void _sleep_sem_del(void *p);       static void _sleep_sem_del(void *p);
       static Boolean _check_time(struct timeval *start, struct timeval *interval);  
       void _check_deadlock(struct timeval *start) throw(Deadlock);       void _check_deadlock(struct timeval *start) throw(Deadlock);
       Boolean _check_deadlock_no_throw(struct timeval *start);       Boolean _check_deadlock_no_throw(struct timeval *start);
       Boolean _check_dealloc(struct timeval *start);       Boolean _check_dealloc(struct timeval *start);
       Thread *_init_thread(void) throw(IPCException);       Thread *_init_thread(void) throw(IPCException);
       void _link_pool(Thread *th) throw(IPCException);       void _link_pool(Thread *th) throw(IPCException);
         static PEGASUS_THREAD_RETURN  _undertaker(void *);
         static DQueue<ThreadPool> _pools;
 }; };
  
   
   
   
   #if defined(PEGASUS_OS_TYPE_WINDOWS)
   # include "ThreadWindows_inline.h"
   #elif defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM)
   # include "ThreadzOS_inline.h"
   #elif defined(PEGASUS_OS_TYPE_UNIX)
   # include "ThreadUnix_inline.h"
   #endif
   
 PEGASUS_NAMESPACE_END PEGASUS_NAMESPACE_END
  
 #endif // Pegasus_Thread_h #endif // Pegasus_Thread_h

Legend:
Removed from v.1.1.2.16  
changed lines
  Added in v.1.27
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2