version 1.1.2.10, 2006/08/02 07:26:35
|
version 1.19, 2008/12/01 17:49:57
|
|
|
//%2006//////////////////////////////////////////////////////////////////////// |
//%LICENSE//////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// Licensed to The Open Group (TOG) under one or more contributor license |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with |
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
// this work for additional information regarding copyright ownership. |
// IBM Corp.; EMC Corporation, The Open Group. |
// Each contributor licenses this file to you under the OpenPegasus Open |
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
// Source License; you may not use this file except in compliance with the |
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
// License. |
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
// |
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
// Permission is hereby granted, free of charge, to any person obtaining a |
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
// copy of this software and associated documentation files (the "Software"), |
// EMC Corporation; Symantec Corporation; The Open Group. |
// to deal in the Software without restriction, including without limitation |
// |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// Permission is hereby granted, free of charge, to any person obtaining a copy |
// and/or sell copies of the Software, and to permit persons to whom the |
// of this software and associated documentation files (the "Software"), to |
// Software is furnished to do so, subject to the following conditions: |
// deal in the Software without restriction, including without limitation the |
// |
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
// The above copyright notice and this permission notice shall be included |
// sell copies of the Software, and to permit persons to whom the Software is |
// in all copies or substantial portions of the Software. |
// furnished to do so, subject to the following conditions: |
// |
// |
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
// | // |
//============================================================================== |
////////////////////////////////////////////////////////////////////////// |
// |
|
// Author: Mike Brasher (m.brasher@inovadevelopment.com) |
|
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
#define Pegasus_Threads_h | #define Pegasus_Threads_h |
| |
#include <cstring> | #include <cstring> |
|
#include <cstdio> |
|
#include <cstring> |
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
#include <Pegasus/Common/Linkage.h> | #include <Pegasus/Common/Linkage.h> |
| |
// ATTN: can we consolidate these someplace? | // ATTN: can we consolidate these someplace? |
| |
#if defined(PEGASUS_HAVE_PTHREADS) |
#ifdef PEGASUS_OS_ZOS |
# if defined(PEGASUS_PLATFORM_OS400_ISERIES_IBM) |
# include <sched.h> |
# define _MULTI_THREADED // Is this really necessary? |
|
# endif | # endif |
|
#if defined(PEGASUS_HAVE_PTHREADS) |
# include <pthread.h> | # include <pthread.h> |
# include <errno.h> | # include <errno.h> |
# include <sys/time.h> | # include <sys/time.h> |
|
|
# error "<Pegasus/Common/Threads.h>: not implemented" | # error "<Pegasus/Common/Threads.h>: not implemented" |
#endif | #endif |
| |
|
#if defined(PEGASUS_OS_SOLARIS) |
|
# include <string.h> |
|
# include <stdio.h> |
|
#endif |
|
|
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
//============================================================================== | //============================================================================== |
|
|
// | // |
//============================================================================== | //============================================================================== |
| |
#if defined(PEGASUS_PLATFORM_WIN32_IX86_MSVC) |
#if defined(PEGASUS_OS_TYPE_WINDOWS) |
# define PEGASUS_THREAD_CDECL __stdcall | # define PEGASUS_THREAD_CDECL __stdcall |
#else | #else |
# define PEGASUS_THREAD_CDECL /* empty */ | # define PEGASUS_THREAD_CDECL /* empty */ |
|
|
| |
//============================================================================== | //============================================================================== |
// | // |
|
// ThreadId |
|
// |
|
//============================================================================== |
|
|
|
struct ThreadId |
|
{ |
|
// The character representation of a uint64 requires 22 bytes including the |
|
// null terminator. |
|
char buffer[22]; |
|
}; |
|
|
|
//============================================================================== |
|
// |
// ThreadType | // ThreadType |
// | // |
//============================================================================== | //============================================================================== |
|
|
#if defined(PEGASUS_HAVE_PTHREADS) | #if defined(PEGASUS_HAVE_PTHREADS) |
struct ThreadType | struct ThreadType |
{ | { |
public: |
|
|
|
ThreadType() | ThreadType() |
{ | { |
memset(this, 0, sizeof(*this)); |
memset(&thread, 0, sizeof(thread)); |
} | } |
| |
ThreadType(const ThreadType& x) : _thread(x._thread), _id(x._id) |
ThreadType(pthread_t thread_) : thread(thread_) |
{ | { |
} | } |
| |
ThreadType(pthread_t thread, Uint32 id) : _thread(thread), _id(id) |
pthread_t thread; |
{ |
|
} |
|
|
|
ThreadType& operator=(const ThreadType& x) |
|
{ |
|
if (&x != this) |
|
{ |
|
_id = x._id; |
|
_thread = x._thread; |
|
} |
|
return *this; |
|
} |
|
|
|
pthread_t tt_handle() const |
|
{ |
|
return _thread; |
|
} |
|
|
|
void print() const |
|
{ |
|
printf("ThreadType(%lu, %lu)\n", _thread, (unsigned long)_id); |
|
} |
|
|
|
private: |
|
pthread_t _thread; |
|
// An id of zero indicates a null object. 1 indicates the main thread. |
|
Uint32 _id; |
|
friend class Threads; |
|
}; | }; |
#endif /* PEGASUS_HAVE_PTHREADS */ | #endif /* PEGASUS_HAVE_PTHREADS */ |
| |
#if defined(PEGASUS_HAVE_WINDOWS_THREADS) | #if defined(PEGASUS_HAVE_WINDOWS_THREADS) |
struct ThreadType | struct ThreadType |
{ | { |
ThreadType() : handle(NULL) { } |
ThreadType() : handle(NULL) |
|
{ |
|
} |
|
|
HANDLE handle; | HANDLE handle; |
}; | }; |
#endif /* PEGASUS_HAVE_WINDOWS_THREADS */ | #endif /* PEGASUS_HAVE_WINDOWS_THREADS */ |
|
|
| |
static void cleanup_pop(int execute); | static void cleanup_pop(int execute); |
| |
static Uint32 id(const ThreadType& x = Threads::self()); |
static ThreadId id(const ThreadType& x = Threads::self()); |
|
|
|
static bool null(const ThreadType& x = Threads::self()); |
| |
static void clear(ThreadType& x); | static void clear(ThreadType& x); |
}; | }; |
|
|
| |
inline bool Threads::equal(ThreadType x, ThreadType y) | inline bool Threads::equal(ThreadType x, ThreadType y) |
{ | { |
return pthread_equal(x.tt_handle(), y.tt_handle()); |
return pthread_equal(x.thread, y.thread); |
} | } |
| |
inline void Threads::exit(ThreadReturnType rc) | inline void Threads::exit(ThreadReturnType rc) |
{ | { |
|
// NOTE: pthread_exit exhibits unusual behavior on RHEL 3 U2, as |
|
// documented in Bugzilla 3836. Where feasible, it may be advantageous |
|
// to avoid using this function. |
pthread_exit(rc); | pthread_exit(rc); |
} | } |
| |
inline void Threads::cancel(ThreadType th, ThreadReturnType rc) | inline void Threads::cancel(ThreadType th, ThreadReturnType rc) |
{ | { |
pthread_cancel(th.tt_handle()); |
pthread_cancel(th.thread); |
} | } |
| |
inline void Threads::yield() | inline void Threads::yield() |
{ | { |
#if defined(PEGASUS_PLATFORM_AIX_RS_IBMCXX) || \ |
#ifdef PEGASUS_OS_LINUX |
defined(PEGASUS_PLATFORM_HPUX_ACC) || \ |
|
defined(PEGASUS_PLATFORM_OS400_ISERIES_IBM) || \ |
|
defined(PEGASUS_PLATFORM_TRU64_ALPHA_DECCXX) || \ |
|
defined(PEGASUS_OS_VMS) || \ |
|
defined(PEGASUS_OS_ZOS) |
|
sched_yield(); |
|
#else |
|
pthread_yield(); | pthread_yield(); |
|
#else |
|
sched_yield(); |
#endif | #endif |
} | } |
| |
|
|
// ATTN: not implemented. | // ATTN: not implemented. |
} | } |
| |
inline Uint32 Threads::id(const ThreadType& x) |
inline ThreadId Threads::id(const ThreadType& x) |
|
{ |
|
ThreadId tid = { { 0 } }; |
|
|
|
#if defined(PEGASUS_OS_ZOS) |
|
const char* s = x.thread.__; |
|
sprintf(tid.buffer, "%X%X%X%X%X%X%X%X", |
|
s[0], s[1], s[2], s[3], s[4], s[5], s[6], s[7]); |
|
#else |
|
sprintf(tid.buffer, "%" PEGASUS_64BIT_CONVERSION_WIDTH "u", |
|
Uint64(x.thread)); |
|
#endif |
|
|
|
return tid; |
|
} |
|
|
|
inline bool Threads::null(const ThreadType& x) |
{ | { |
return x._id; |
#if defined(PEGASUS_OS_ZOS) |
|
Uint64 tmp; |
|
memcpy(&tmp, x.thread.__, sizeof(Uint64)); |
|
return tmp == 0; |
|
#else |
|
return x.thread == 0; |
|
#endif |
} | } |
| |
inline void Threads::clear(ThreadType& x) | inline void Threads::clear(ThreadType& x) |
|
|
inline ThreadType Threads::self() | inline ThreadType Threads::self() |
{ | { |
ThreadType tt; | ThreadType tt; |
tt.handle = HANDLE(GetCurrentThreadId()); |
tt.handle = GetCurrentThread(); |
return tt; | return tt; |
} | } |
| |
|
|
// ATTN: Not implemented on Windows. | // ATTN: Not implemented on Windows. |
} | } |
| |
inline Uint32 Threads::id(const ThreadType& x) |
inline ThreadId Threads::id(const ThreadType& x) |
|
{ |
|
ThreadId tmp; |
|
|
|
sprintf(tmp.buffer, "%" PEGASUS_64BIT_CONVERSION_WIDTH "u", |
|
Uint64(x.handle)); |
|
|
|
return tmp; |
|
} |
|
|
|
inline bool Threads::null(const ThreadType& x) |
{ | { |
return (Uint32)(long)x.handle; |
return x.handle == NULL; |
} | } |
| |
inline void Threads::clear(ThreadType& x) | inline void Threads::clear(ThreadType& x) |