version 1.1.2.1, 2001/07/30 12:06:14
|
version 1.90.2.9, 2006/07/29 15:54:07
|
|
|
//%///////////////////////////////////////////////////////////////////////////// |
//%2006//////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001 The Open group, BMC Software, Tivoli Systems, IBM |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
|
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
|
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation, The Open Group. |
|
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
// | // |
// 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 |
|
|
// | // |
//============================================================================== | //============================================================================== |
// | // |
// Author: Markus Mueller (sedgewick_de@yahoo.de) |
// Author: Mike Day (mdday@us.ibm.com) |
// | // |
// Modified By: Mike Day (mdday@us.ibm.com) |
// Modified By: Rudy Schuet (rudy.schuet@compaq.com) 11/12/01 |
|
// added nsk platform support |
|
// Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com) |
|
// Amit K Arora, IBM (amita@in.ibm.com) for PEP#101 |
|
// Sean Keenan, Hewlett-Packard Company (sean.keenan@hp.com) |
|
// David Dillard, VERITAS Software Corp. |
|
// (david.dillard@veritas.com) |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
#include "Thread.h" | #include "Thread.h" |
|
#include <exception> |
|
#include <Pegasus/Common/Tracer.h> |
|
#include "Time.h" |
|
|
|
PEGASUS_USING_STD; |
|
|
|
PEGASUS_NAMESPACE_BEGIN |
|
|
|
//============================================================================== |
|
// |
|
// POSIX Threads Implementation: |
|
// |
|
//============================================================================== |
|
|
|
#if defined(PEGASUS_HAVE_PTHREADS) |
|
|
|
struct StartWrapperArg |
|
{ |
|
void *(PEGASUS_THREAD_CDECL * start) (void *); |
|
void *arg; |
|
}; |
|
|
|
extern "C" void *_start_wrapper(void *arg_) |
|
{ |
|
StartWrapperArg *arg = (StartWrapperArg *) arg_; |
|
|
|
void *return_value = (*arg->start) (arg->arg); |
|
delete arg; |
| |
#if defined(PEGASUS_OS_TYPE_WINDOWS) |
return return_value; |
# include "ThreadWindows.cpp" |
} |
#elif defined(PEGASUS_OS_TYPE_UNIX) |
|
# include "ThreadUnix.cpp" |
void Thread::cancel() |
|
{ |
|
_cancelled = true; |
|
pthread_cancel(_handle.thid.tt_handle()); |
|
} |
|
|
|
void Thread::test_cancel() |
|
{ |
|
#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM) |
|
pthread_testintr(); |
#else | #else |
# error "Unsupported platform" |
pthread_testcancel(); |
#endif | #endif |
|
} |
| |
PEGASUS_NAMESPACE_BEGIN |
Boolean Thread::is_cancelled(void) |
|
{ |
|
return _cancelled; |
|
} |
|
|
|
void Thread::thread_switch() |
|
{ |
|
#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM) |
|
pthread_yield(NULL); |
|
#else |
|
sched_yield(); |
|
#endif |
|
} |
|
|
|
/* |
|
ATTN: why are these missing on other platforms? |
|
*/ |
|
#if defined(PEGASUS_PLATFORM_LINUX_GENERIC_GNU) |
|
void Thread::suspend() |
|
{ |
|
pthread_kill(_handle.thid.tt_handle(), SIGSTOP); |
|
} |
|
|
|
void Thread::resume() |
|
{ |
|
pthread_kill(_handle.thid.tt_handle(), SIGCONT); |
|
} |
|
#endif |
|
|
|
void Thread::sleep(Uint32 msec) |
|
{ |
|
Threads::sleep(msec); |
|
} |
|
|
|
void Thread::join(void) |
|
{ |
|
if (!_is_detached && Threads::id(_handle.thid) != 0) |
|
pthread_join(_handle.thid.tt_handle(), &_exit_code); |
|
|
|
Threads::clear(_handle.thid); |
|
} |
|
|
|
void Thread::thread_init(void) |
|
{ |
|
#if defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM) |
|
pthread_setintr(PTHREAD_INTR_ENABLE); |
|
pthread_setintrtype(PTHREAD_INTR_ASYNCHRONOUS); |
|
#else |
|
pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL); |
|
pthread_setcanceltype(PTHREAD_CANCEL_DEFERRED, NULL); |
|
#endif |
|
_cancel_enabled = true; |
|
} |
|
|
|
void Thread::detach(void) |
|
{ |
|
_is_detached = true; |
|
pthread_detach(_handle.thid.tt_handle()); |
|
} |
|
|
|
ThreadStatus Thread::run() |
|
{ |
|
StartWrapperArg *arg = new StartWrapperArg; |
|
arg->start = _start; |
|
arg->arg = this; |
|
|
|
Threads::Type type = _is_detached ? Threads::DETACHED : Threads::JOINABLE; |
|
int rc = Threads::create(_handle.thid, type, _start_wrapper, arg); |
|
|
|
// On Linux distributions released prior 2005, the implementation of |
|
// Native POSIX Thread Library returns ENOMEM instead of EAGAIN when |
|
// there |
|
// are no insufficient memory. Hence we are checking for both. See bug |
|
// 386. |
|
|
|
if ((rc == EAGAIN) || (rc == ENOMEM)) |
|
{ |
|
Threads::clear(_handle.thid); |
|
delete arg; |
|
return PEGASUS_THREAD_INSUFFICIENT_RESOURCES; |
|
} |
|
else if (rc != 0) |
|
{ |
|
Threads::clear(_handle.thid); |
|
delete arg; |
|
return PEGASUS_THREAD_SETUP_FAILURE; |
|
} |
|
return PEGASUS_THREAD_OK; |
|
} |
|
|
|
static sigset_t *block_signal_mask(sigset_t * sig) |
|
{ |
|
sigemptyset(sig); |
|
// should not be used for main() |
|
sigaddset(sig, SIGHUP); |
|
sigaddset(sig, SIGINT); |
|
// maybe useless, since KILL can't be blocked according to POSIX |
|
sigaddset(sig, SIGKILL); |
|
|
|
sigaddset(sig, SIGABRT); |
|
sigaddset(sig, SIGALRM); |
|
sigaddset(sig, SIGPIPE); |
|
|
|
|
|
// Note: older versions of the linux pthreads library use SIGUSR1 and SIGUSR2 |
|
// internally to stop and start threads that are blocking, the newer ones |
|
// implement this through the kernel's real time signals |
|
// since SIGSTOP/CONT can handle suspend()/resume() on Linux |
|
// block them |
|
// #if defined(PEGASUS_PLATFORM_LINUX_IX86_GNU) |
|
// sigaddset(sig, SIGUSR1); |
|
// sigaddset(sig, SIGUSR2); |
|
// #endif |
|
#ifndef PEGASUS_PLATFORM_ZOS_ZSERIES_IBM |
|
pthread_sigmask(SIG_BLOCK, sig, NULL); |
|
#else |
|
sigprocmask(SIG_BLOCK, sig, NULL); |
|
#endif |
|
return sig; |
|
} |
|
|
|
Thread::Thread(ThreadReturnType(PEGASUS_THREAD_CDECL * start) (void *), void *parameter, Boolean detached):_is_detached(detached), |
|
_cancel_enabled(true), |
|
_cancelled(false), |
|
_start(start), _cleanup(), _tsd(), _thread_parm(parameter), _exit_code(0) |
|
{ |
|
Threads::clear(_handle.thid); |
|
} |
|
|
|
Thread::~Thread() |
|
{ |
|
try |
|
{ |
|
join(); |
|
empty_tsd(); |
|
} |
|
catch(...) |
|
{ |
|
// Do not allow the destructor to throw an exception |
|
} |
|
} |
|
|
|
#endif /* PEGASUS_HAVE_PTHREADS */ |
|
|
|
//============================================================================== |
|
// |
|
// Windows Threads Implementation: |
|
// |
|
//============================================================================== |
| |
|
#if defined(PEGASUS_HAVE_WINDOWS_THREADS) |
| |
// for non-native implementations |
ThreadStatus Thread::run(void) |
#ifndef PEGASUS_THREAD_CLEANUP_NATIVE |
{ |
void Thread::cleanup_push( void (*routine)(void *), void *parm) throw(IPCException) |
// Note: A Win32 thread ID is not the same thing as a pthread ID. |
{ |
// Win32 threads have both a thread ID and a handle. The handle |
cleanup_handler *cu = new cleanup_handler(routine, parm); |
// is used in the wait functions, etc. |
try { _cleanup.insert_first(cu); } |
// So _handle.thid is actually the thread handle. |
catch(IPCException& e) { delete cu; throw; } |
|
|
unsigned threadid = 0; |
|
|
|
ThreadType tt; |
|
tt.handle = (HANDLE) _beginthreadex(NULL, 0, _start, this, 0, &threadid); |
|
_handle.thid = tt; |
|
|
|
if (Threads::id(_handle.thid) == 0) |
|
{ |
|
if (errno == EAGAIN) |
|
{ |
|
return PEGASUS_THREAD_INSUFFICIENT_RESOURCES; |
|
} |
|
else |
|
{ |
|
return PEGASUS_THREAD_SETUP_FAILURE; |
|
} |
|
} |
|
return PEGASUS_THREAD_OK; |
|
} |
|
|
|
void Thread::cancel(void) |
|
{ |
|
_cancelled = true; |
|
} |
|
|
|
void Thread::test_cancel(void) |
|
{ |
|
if (_cancel_enabled && _cancelled) |
|
{ |
|
exit_self(0); |
|
} |
|
} |
|
|
|
Boolean Thread::is_cancelled(void) |
|
{ |
|
return _cancelled; |
|
} |
|
|
|
void Thread::thread_switch(void) |
|
{ |
|
Sleep(0); |
|
} |
|
|
|
void Thread::sleep(Uint32 milliseconds) |
|
{ |
|
Sleep(milliseconds); |
|
} |
|
|
|
void Thread::join(void) |
|
{ |
|
if (Threads::id(_handle.thid) != 0) |
|
{ |
|
if (!_is_detached) |
|
{ |
|
if (!_cancelled) |
|
{ |
|
// Emulate the unix join api. Caller sleeps until thread is |
|
// done. |
|
WaitForSingleObject(_handle.thid.handle, INFINITE); |
|
} |
|
else |
|
{ |
|
// Currently this is the only way to ensure this code does |
|
// not |
|
// hang forever. |
|
if (WaitForSingleObject(_handle.thid.handle, 10000) == |
|
WAIT_TIMEOUT) |
|
{ |
|
TerminateThread(_handle.thid.handle, 0); |
|
} |
|
} |
|
|
|
DWORD exit_code = 0; |
|
GetExitCodeThread(_handle.thid.handle, &exit_code); |
|
_exit_code = (ThreadReturnType) exit_code; |
|
} |
|
|
|
CloseHandle(_handle.thid.handle); |
|
Threads::clear(_handle.thid); |
|
} |
|
} |
|
|
|
void Thread::thread_init(void) |
|
{ |
|
_cancel_enabled = true; |
|
} |
|
|
|
void Thread::detach(void) |
|
{ |
|
_is_detached = true; |
|
} |
|
|
|
Thread::Thread(ThreadReturnType(PEGASUS_THREAD_CDECL * start) (void *), |
|
void *parameter, |
|
Boolean detached):_is_detached(detached), |
|
_cancel_enabled(true), |
|
_cancelled(false), |
|
_start(start), _cleanup(), _tsd(), _thread_parm(parameter), _exit_code(0) |
|
{ |
|
Threads::clear(_handle.thid); |
|
} |
|
|
|
Thread::~Thread() |
|
{ |
|
try |
|
{ |
|
join(); |
|
empty_tsd(); |
|
} |
|
catch(...) |
|
{ |
|
} |
|
} |
|
|
|
#endif /* PEGASUS_HAVE_WINDOWS_THREADS */ |
|
|
|
//============================================================================== |
|
// |
|
// Common implementation: |
|
// |
|
//============================================================================== |
|
|
|
void thread_data::default_delete(void *data) |
|
{ |
|
if (data != NULL) |
|
::operator delete(data); |
|
} |
|
|
|
void language_delete(void *data) |
|
{ |
|
if (data != NULL) |
|
{ |
|
AutoPtr < AcceptLanguageList > al(static_cast < |
|
AcceptLanguageList * >(data)); |
|
} |
|
} |
|
|
|
Boolean Thread::_signals_blocked = false; |
|
#ifndef PEGASUS_OS_ZOS |
|
TSDKeyType Thread::_platform_thread_key = TSDKeyType(-1); |
|
#else |
|
TSDKeyType Thread::_platform_thread_key; |
|
#endif |
|
Boolean Thread::_key_initialized = false; |
|
Boolean Thread::_key_error = false; |
|
|
|
void Thread::cleanup_push(void (*routine) (void *), void *parm) |
|
{ |
|
AutoPtr < cleanup_handler > cu(new cleanup_handler(routine, parm)); |
|
_cleanup.insert_front(cu.get()); |
|
cu.release(); |
return; | return; |
} | } |
| |
void Thread::cleanup_pop(Boolean execute = true) throw(IPCException) |
void Thread::cleanup_pop(Boolean execute) |
{ | { |
cleanup_handler *cu ; |
AutoPtr < cleanup_handler > cu; |
try { cu = _cleanup.remove_first() ;} |
try |
catch(IPCException& e) { assert(0); } |
{ |
|
cu.reset(_cleanup.remove_front()); |
|
} |
|
catch(IPCException &) |
|
{ |
|
PEGASUS_ASSERT(0); |
|
} |
if(execute == true) | if(execute == true) |
cu->execute(); | cu->execute(); |
delete cu; |
|
} | } |
| |
|
|
|
//thread_data *Thread::put_tsd(const Sint8 *key, void (*delete_func)(void *), Uint32 size, void *value) |
|
|
|
|
|
void Thread::exit_self(ThreadReturnType exit_code) |
|
{ |
|
#if defined(PEGASUS_PLATFORM_HPUX_ACC) || \ |
|
defined(PEGASUS_PLATFORM_LINUX_GENERIC_GNU) |
|
// 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(exit_code); |
|
#else |
|
// execute the cleanup stack and then return |
|
while (_cleanup.size()) |
|
{ |
|
try |
|
{ |
|
cleanup_pop(true); |
|
} |
|
catch(IPCException &) |
|
{ |
|
PEGASUS_ASSERT(0); |
|
break; |
|
} |
|
} |
|
_exit_code = exit_code; |
|
Threads::exit(exit_code); |
|
Threads::clear(_handle.thid); |
|
#endif |
|
} |
|
|
|
Sint8 Thread::initializeKey() |
|
{ |
|
PEG_METHOD_ENTER(TRC_THREAD, "Thread::initializeKey"); |
|
if (!Thread::_key_initialized) |
|
{ |
|
if (Thread::_key_error) |
|
{ |
|
Tracer::trace(TRC_THREAD, Tracer::LEVEL4, |
|
"Thread: ERROR - thread key error"); |
|
return -1; |
|
} |
|
|
|
if (TSDKey::create(&Thread::_platform_thread_key) == 0) |
|
{ |
|
Tracer::trace(TRC_THREAD, Tracer::LEVEL4, |
|
"Thread: able to create a thread key"); |
|
Thread::_key_initialized = true; |
|
} |
|
else |
|
{ |
|
Tracer::trace(TRC_THREAD, Tracer::LEVEL4, |
|
"Thread: ERROR - unable to create a thread key"); |
|
Thread::_key_error = true; |
|
return -1; |
|
} |
|
} |
|
|
|
PEG_METHOD_EXIT(); |
|
return 0; |
|
} |
|
|
|
Thread *Thread::getCurrent() |
|
{ |
|
PEG_METHOD_ENTER(TRC_THREAD, "Thread::getCurrent"); |
|
if (Thread::initializeKey() != 0) |
|
{ |
|
return NULL; |
|
} |
|
PEG_METHOD_EXIT(); |
|
return (Thread *) TSDKey::get_thread_specific(_platform_thread_key); |
|
} |
|
|
|
void Thread::setCurrent(Thread * thrd) |
|
{ |
|
PEG_METHOD_ENTER(TRC_THREAD, "Thread::setCurrent"); |
|
if (Thread::initializeKey() == 0) |
|
{ |
|
if (TSDKey:: |
|
set_thread_specific(Thread::_platform_thread_key, |
|
(void *) thrd) == 0) |
|
{ |
|
Tracer::trace(TRC_THREAD, Tracer::LEVEL4, |
|
"Successful set Thread * into thread specific storage"); |
|
} |
|
else |
|
{ |
|
Tracer::trace(TRC_THREAD, Tracer::LEVEL4, |
|
"ERROR: error setting Thread * into thread specific storage"); |
|
} |
|
} |
|
PEG_METHOD_EXIT(); |
|
} |
|
|
|
AcceptLanguageList *Thread::getLanguages() |
|
{ |
|
PEG_METHOD_ENTER(TRC_THREAD, "Thread::getLanguages"); |
|
|
|
Thread *curThrd = Thread::getCurrent(); |
|
if (curThrd == NULL) |
|
return NULL; |
|
AcceptLanguageList *acceptLangs = |
|
(AcceptLanguageList *) curThrd->reference_tsd("acceptLanguages"); |
|
curThrd->dereference_tsd(); |
|
PEG_METHOD_EXIT(); |
|
return acceptLangs; |
|
} |
|
|
|
void Thread::setLanguages(AcceptLanguageList * langs) // l10n |
|
{ |
|
PEG_METHOD_ENTER(TRC_THREAD, "Thread::setLanguages"); |
|
|
|
Thread *currentThrd = Thread::getCurrent(); |
|
if (currentThrd != NULL) |
|
{ |
|
// deletes the old tsd and creates a new one |
|
currentThrd->put_tsd("acceptLanguages", |
|
language_delete, |
|
sizeof (AcceptLanguageList *), langs); |
|
} |
|
|
|
PEG_METHOD_EXIT(); |
|
} |
|
|
|
void Thread::clearLanguages() // l10n |
|
{ |
|
PEG_METHOD_ENTER(TRC_THREAD, "Thread::clearLanguages"); |
|
|
|
Thread *currentThrd = Thread::getCurrent(); |
|
if (currentThrd != NULL) |
|
{ |
|
// deletes the old tsd |
|
currentThrd->delete_tsd("acceptLanguages"); |
|
} |
|
|
|
PEG_METHOD_EXIT(); |
|
} |
|
|
|
// ATTN: not sure where to put this! |
|
#ifdef PEGASUS_ZOS_SECURITY |
|
bool isEnhancedSecurity = 99; |
#endif | #endif |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |