src/unix/threadpsx.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        threadpsx.cpp
   3 // Purpose:     wxThread (Posix) Implementation
   4 // Author:      Original from Wolfram Gloger/Guilhem Lavaux
   5 // Modified by:
   6 // Created:     04/22/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Wolfram Gloger (1996, 1997)
   9 //                  Guilhem Lavaux (1998)
  10 //                  Vadim Zeitlin (1999)
  11 //                  Robert Roebling (1999)
  12 // Licence:     wxWindows licence
  13 /////////////////////////////////////////////////////////////////////////////
  14
  15 // ============================================================================
  16 // declaration
  17 // ============================================================================
  18
  19 // ----------------------------------------------------------------------------
  20 // headers
  21 // ----------------------------------------------------------------------------
  22
  23 #ifdef __GNUG__
  24     #pragma implementation "thread.h"
  25 #endif
  26
  27 // With simple makefiles, we must ignore the file body if not using
  28 // threads.
  29 #include "wx/setup.h"
  30
  31 #if wxUSE_THREADS
  32
  33 #include "wx/thread.h"
  34 #include "wx/module.h"
  35 #include "wx/utils.h"
  36 #include "wx/log.h"
  37 #include "wx/intl.h"
  38 #include "wx/dynarray.h"
  39
  40 #include <stdio.h>
  41 #include <unistd.h>
  42 #include <pthread.h>
  43 #include <errno.h>
  44 #include <time.h>
  45
  46 #if HAVE_SCHED_H
  47     #include <sched.h>
  48 #endif
  49
  50 // ----------------------------------------------------------------------------
  51 // constants
  52 // ----------------------------------------------------------------------------
  53
  54 // the possible states of the thread and transitions from them
  55 enum wxThreadState
  56 {
  57     STATE_NEW,          // didn't start execution yet (=> RUNNING)
  58     STATE_RUNNING,      // running (=> PAUSED or EXITED)
  59     STATE_PAUSED,       // suspended (=> RUNNING or EXITED)
  60     STATE_EXITED        // thread doesn't exist any more
  61 };
  62
  63 // ----------------------------------------------------------------------------
  64 // types
  65 // ----------------------------------------------------------------------------
  66
  67 WX_DEFINE_ARRAY(wxThread *, wxArrayThread);
  68
  69 // -----------------------------------------------------------------------------
  70 // global data
  71 // -----------------------------------------------------------------------------
  72
  73 // we keep the list of all threads created by the application to be able to
  74 // terminate them on exit if there are some left - otherwise the process would
  75 // be left in memory
  76 static wxArrayThread gs_allThreads;
  77
  78 // the id of the main thread
  79 static pthread_t gs_tidMain;
  80
  81 // the key for the pointer to the associated wxThread object
  82 static pthread_key_t gs_keySelf;
  83
  84 // this mutex must be acquired before any call to a GUI function
  85 static wxMutex *gs_mutexGui;
  86
  87 // ============================================================================
  88 // implementation
  89 // ============================================================================
  90
  91 //--------------------------------------------------------------------
  92 // wxMutex (Posix implementation)
  93 //--------------------------------------------------------------------
  94
  95 class wxMutexInternal
  96 {
  97 public:
  98     pthread_mutex_t p_mutex;
  99 };
 100
 101 wxMutex::wxMutex()
 102 {
 103     p_internal = new wxMutexInternal;
 104     pthread_mutex_init( &(p_internal->p_mutex), (const pthread_mutexattr_t*) NULL );
 105     m_locked = 0;
 106 }
 107
 108 wxMutex::~wxMutex()
 109 {
 110     if (m_locked > 0)
 111         wxLogDebug(_T("Freeing a locked mutex (%d locks)"), m_locked);
 112
 113     pthread_mutex_destroy( &(p_internal->p_mutex) );
 114     delete p_internal;
 115 }
 116
 117 wxMutexError wxMutex::Lock()
 118 {
 119     int err = pthread_mutex_lock( &(p_internal->p_mutex) );
 120     if (err == EDEADLK)
 121     {
 122         wxLogDebug(_T("Locking this mutex would lead to deadlock!"));
 123
 124         return wxMUTEX_DEAD_LOCK;
 125     }
 126
 127     m_locked++;
 128
 129     return wxMUTEX_NO_ERROR;
 130 }
 131
 132 wxMutexError wxMutex::TryLock()
 133 {
 134     if (m_locked)
 135     {
 136         return wxMUTEX_BUSY;
 137     }
 138
 139     int err = pthread_mutex_trylock( &(p_internal->p_mutex) );
 140     switch (err)
 141     {
 142         case EBUSY: return wxMUTEX_BUSY;
 143     }
 144
 145     m_locked++;
 146
 147     return wxMUTEX_NO_ERROR;
 148 }
 149
 150 wxMutexError wxMutex::Unlock()
 151 {
 152     if (m_locked > 0)
 153     {
 154         m_locked--;
 155     }
 156     else
 157     {
 158         wxLogDebug(_T("Unlocking not locked mutex."));
 159
 160         return wxMUTEX_UNLOCKED;
 161     }
 162
 163     pthread_mutex_unlock( &(p_internal->p_mutex) );
 164
 165     return wxMUTEX_NO_ERROR;
 166 }
 167
 168 //--------------------------------------------------------------------
 169 // wxCondition (Posix implementation)
 170 //--------------------------------------------------------------------
 171
 172 class wxConditionInternal
 173 {
 174 public:
 175   pthread_cond_t p_condition;
 176 };
 177
 178 wxCondition::wxCondition()
 179 {
 180     p_internal = new wxConditionInternal;
 181     pthread_cond_init( &(p_internal->p_condition), (const pthread_condattr_t *) NULL );
 182 }
 183
 184 wxCondition::~wxCondition()
 185 {
 186     pthread_cond_destroy( &(p_internal->p_condition) );
 187
 188     delete p_internal;
 189 }
 190
 191 void wxCondition::Wait(wxMutex& mutex)
 192 {
 193     pthread_cond_wait( &(p_internal->p_condition), &(mutex.p_internal->p_mutex) );
 194 }
 195
 196 bool wxCondition::Wait(wxMutex& mutex, unsigned long sec, unsigned long nsec)
 197 {
 198     struct timespec tspec;
 199
 200     tspec.tv_sec = time(0L)+sec;
 201     tspec.tv_nsec = nsec;
 202     return (pthread_cond_timedwait(&(p_internal->p_condition), &(mutex.p_internal->p_mutex), &tspec) != ETIMEDOUT);
 203 }
 204
 205 void wxCondition::Signal()
 206 {
 207     pthread_cond_signal( &(p_internal->p_condition) );
 208 }
 209
 210 void wxCondition::Broadcast()
 211 {
 212     pthread_cond_broadcast( &(p_internal->p_condition) );
 213 }
 214
 215 //--------------------------------------------------------------------
 216 // wxThread (Posix implementation)
 217 //--------------------------------------------------------------------
 218
 219 class wxThreadInternal
 220 {
 221 public:
 222     wxThreadInternal();
 223     ~wxThreadInternal();
 224
 225     // thread entry function
 226     static void *PthreadStart(void *ptr);
 227
 228 #if HAVE_THREAD_CLEANUP_FUNCTIONS
 229     // thread exit function
 230     static void PthreadCleanup(void *ptr);
 231 #endif
 232
 233     // thread actions
 234         // start the thread
 235     wxThreadError Run();
 236         // ask the thread to terminate
 237     void Wait();
 238         // wake up threads waiting for our termination
 239     void SignalExit();
 240         // go to sleep until Resume() is called
 241     void Pause();
 242         // resume the thread
 243     void Resume();
 244
 245     // accessors
 246         // priority
 247     int GetPriority() const { return m_prio; }
 248     void SetPriority(int prio) { m_prio = prio; }
 249         // state
 250     wxThreadState GetState() const { return m_state; }
 251     void SetState(wxThreadState state) { m_state = state; }
 252         // id
 253     pthread_t GetId() const { return m_threadId; }
 254     pthread_t *GetIdPtr() { return &m_threadId; }
 255         // "cancelled" flag
 256     void SetCancelFlag() { m_cancelled = TRUE; }
 257     bool WasCancelled() const { return m_cancelled; }
 258
 259 private:
 260     pthread_t     m_threadId;   // id of the thread
 261     wxThreadState m_state;      // see wxThreadState enum
 262     int           m_prio;       // in wxWindows units: from 0 to 100
 263
 264     // set when the thread should terminate
 265     bool m_cancelled;
 266
 267     // this (mutex, cond) pair is used to synchronize the main thread and this
 268     // thread in several situations:
 269     //  1. The thread function blocks until condition is signaled by Run() when
 270     //     it's initially created - this allows thread creation in "suspended"
 271     //     state
 272     //  2. The Delete() function blocks until the condition is signaled when the
 273     //     thread exits.
 274     // GL: On Linux, this may fail because we can have a deadlock in either
 275     //     SignalExit() or Wait(): so we add m_end_mutex for the finalization.
 276     wxMutex     m_mutex, m_end_mutex;
 277     wxCondition m_cond;
 278
 279     // another (mutex, cond) pair for Pause()/Resume() usage
 280     //
 281     // VZ: it's possible that we might reuse the mutex and condition from above
 282     //     for this too, but as I'm not at all sure that it won't create subtle
 283     //     problems with race conditions between, say, Pause() and Delete() I
 284     //     prefer this may be a bit less efficient but much safer solution
 285     wxMutex     m_mutexSuspend;
 286     wxCondition m_condSuspend;
 287 };
 288
 289 void *wxThreadInternal::PthreadStart(void *ptr)
 290 {
 291     wxThread *thread = (wxThread *)ptr;
 292     wxThreadInternal *pthread = thread->p_internal;
 293     void *status;
 294
 295     int rc = pthread_setspecific(gs_keySelf, thread);
 296     if ( rc != 0 )
 297     {
 298         wxLogSysError(rc, _("Cannot start thread: error writing TLS"));
 299
 300         return (void *)-1;
 301     }
 302 #if HAVE_THREAD_CLEANUP_FUNCTIONS
 303     // Install the cleanup handler.
 304     pthread_cleanup_push(wxThreadInternal::PthreadCleanup, ptr);
 305 #endif
 306
 307     // wait for the condition to be signaled from Run()
 308     // mutex state: currently locked by the thread which created us
 309     pthread->m_cond.Wait(pthread->m_mutex);
 310     // mutex state: locked again on exit of Wait()
 311
 312     // call the main entry
 313     status = thread->Entry();
 314
 315 #if HAVE_THREAD_CLEANUP_FUNCTIONS
 316     pthread_cleanup_pop(FALSE);
 317 #endif
 318
 319     // terminate the thread
 320     thread->Exit(status);
 321
 322     wxFAIL_MSG(_T("wxThread::Exit() can't return."));
 323
 324     return NULL;
 325 }
 326
 327 #if HAVE_THREAD_CLEANUP_FUNCTIONS
 328 // Only called when the thread is explicitely killed.
 329
 330 void wxThreadInternal::PthreadCleanup(void *ptr)
 331 {
 332     wxThread *thread = (wxThread *) ptr;
 333
 334     // The thread is already considered as finished.
 335     if (thread->p_internal->GetState() == STATE_EXITED)
 336       return;
 337
 338     // first call user-level clean up code
 339     thread->OnExit();
 340
 341     // next wake up the threads waiting for us (OTOH, this function won't retur
 342     // until someone waited for us!)
 343     thread->p_internal->SetState(STATE_EXITED);
 344
 345     thread->p_internal->SignalExit();
 346 }
 347 #endif
 348
 349 wxThreadInternal::wxThreadInternal()
 350 {
 351     m_state = STATE_NEW;
 352     m_cancelled = FALSE;
 353
 354     // this mutex is locked during almost all thread lifetime - it will only be
 355     // unlocked in the very end
 356     m_mutex.Lock();
 357
 358     // this mutex is used by wxThreadInternal::Wait() and by
 359     // wxThreadInternal::SignalExit(). We don't use m_mutex because of a
 360     // possible deadlock in either Wait() or SignalExit().
 361     m_end_mutex.Lock();
 362
 363     // this mutex is used in Pause()/Resume() and is also locked all the time
 364     // unless the thread is paused
 365     m_mutexSuspend.Lock();
 366 }
 367
 368 wxThreadInternal::~wxThreadInternal()
 369 {
 370     // GL: moved to SignalExit
 371     // m_mutexSuspend.Unlock();
 372
 373     // note that m_mutex will be unlocked by the thread which waits for our
 374     // termination
 375
 376     // In the case, we didn't start the thread, all these mutex are locked:
 377     // we must unlock them.
 378     if (m_mutex.IsLocked())
 379       m_mutex.Unlock();
 380
 381     if (m_end_mutex.IsLocked())
 382       m_end_mutex.Unlock();
 383
 384     if (m_mutexSuspend.IsLocked())
 385       m_mutexSuspend.Unlock();
 386 }
 387
 388 wxThreadError wxThreadInternal::Run()
 389 {
 390     wxCHECK_MSG( GetState() == STATE_NEW, wxTHREAD_RUNNING,
 391                  _T("thread may only be started once after successful Create()") );
 392
 393     // the mutex was locked on Create(), so we will be able to lock it again
 394     // only when the thread really starts executing and enters the wait -
 395     // otherwise we might signal the condition before anybody is waiting for it
 396     wxMutexLocker lock(m_mutex);
 397     m_cond.Signal();
 398
 399     m_state = STATE_RUNNING;
 400
 401     return wxTHREAD_NO_ERROR;
 402
 403     // now the mutex is unlocked back - but just to allow Wait() function to
 404     // terminate by relocking it, so the net result is that the worker thread
 405     // starts executing and the mutex is still locked
 406 }
 407
 408 void wxThreadInternal::Wait()
 409 {
 410     wxCHECK_RET( WasCancelled(), _T("thread should have been cancelled first") );
 411
 412     // if the thread we're waiting for is waiting for the GUI mutex, we will
 413     // deadlock so make sure we release it temporarily
 414     if ( wxThread::IsMain() )
 415         wxMutexGuiLeave();
 416
 417     // entering Wait() releases the mutex thus allowing SignalExit() to acquire
 418     // it and to signal us its termination
 419     m_cond.Wait(m_end_mutex);
 420
 421     // mutex is still in the locked state - relocked on exit from Wait(), so
 422     // unlock it - we don't need it any more, the thread has already terminated
 423     m_end_mutex.Unlock();
 424
 425     // After that, we wait for the real end of the other thread.
 426     pthread_join(GetId(), NULL);
 427
 428     // reacquire GUI mutex
 429     if ( wxThread::IsMain() )
 430         wxMutexGuiEnter();
 431 }
 432
 433 void wxThreadInternal::SignalExit()
 434 {
 435     // GL: Unlock mutexSuspend here.
 436     m_mutexSuspend.Unlock();
 437
 438     // as mutex is currently locked, this will block until some other thread
 439     // (normally the same which created this one) unlocks it by entering Wait()
 440     m_end_mutex.Lock();
 441
 442     // wake up all the threads waiting for our termination
 443     m_cond.Broadcast();
 444
 445     // after this call mutex will be finally unlocked
 446     m_end_mutex.Unlock();
 447 }
 448
 449 void wxThreadInternal::Pause()
 450 {
 451     // the state is set from the thread which pauses us first, this function
 452     // is called later so the state should have been already set
 453     wxCHECK_RET( m_state == STATE_PAUSED,
 454                  _T("thread must first be paused with wxThread::Pause().") );
 455
 456     // don't pause the thread which is being terminated - this would lead to
 457     // deadlock if the thread is paused after Delete() had called Resume() but
 458     // before it had time to call Wait()
 459     if ( WasCancelled() )
 460         return;
 461
 462     // wait until the condition is signaled from Resume()
 463     m_condSuspend.Wait(m_mutexSuspend);
 464 }
 465
 466 void wxThreadInternal::Resume()
 467 {
 468     wxCHECK_RET( m_state == STATE_PAUSED,
 469                  _T("can't resume thread which is not suspended.") );
 470
 471     // we will be able to lock this mutex only when Pause() starts waiting
 472     wxMutexLocker lock(m_mutexSuspend);
 473     m_condSuspend.Signal();
 474
 475     SetState(STATE_RUNNING);
 476 }
 477
 478 // -----------------------------------------------------------------------------
 479 // static functions
 480 // -----------------------------------------------------------------------------
 481
 482 wxThread *wxThread::This()
 483 {
 484     return (wxThread *)pthread_getspecific(gs_keySelf);
 485 }
 486
 487 bool wxThread::IsMain()
 488 {
 489     return (bool)pthread_equal(pthread_self(), gs_tidMain);
 490 }
 491
 492 void wxThread::Yield()
 493 {
 494     sched_yield();
 495 }
 496
 497 void wxThread::Sleep(unsigned long milliseconds)
 498 {
 499     wxUsleep(milliseconds);
 500 }
 501
 502 // -----------------------------------------------------------------------------
 503 // creating thread
 504 // -----------------------------------------------------------------------------
 505
 506 wxThread::wxThread()
 507 {
 508     // add this thread to the global list of all threads
 509     gs_allThreads.Add(this);
 510
 511     p_internal = new wxThreadInternal();
 512 }
 513
 514 wxThreadError wxThread::Create()
 515 {
 516     if (p_internal->GetState() != STATE_NEW)
 517         return wxTHREAD_RUNNING;
 518
 519     // set up the thread attribute: right now, we only set thread priority
 520     pthread_attr_t attr;
 521     pthread_attr_init(&attr);
 522
 523 #ifdef HAVE_THREAD_PRIORITY_FUNCTIONS
 524     int prio;
 525     if ( pthread_attr_getschedpolicy(&attr, &prio) != 0 )
 526     {
 527         wxLogError(_("Cannot retrieve thread scheduling policy."));
 528     }
 529
 530     int min_prio = sched_get_priority_min(prio),
 531         max_prio = sched_get_priority_max(prio);
 532
 533     if ( min_prio == -1 || max_prio == -1 )
 534     {
 535         wxLogError(_("Cannot get priority range for scheduling policy %d."),
 536                    prio);
 537     }
 538     else
 539     {
 540         struct sched_param sp;
 541         pthread_attr_getschedparam(&attr, &sp);
 542         sp.sched_priority = min_prio +
 543                            (p_internal->GetPriority()*(max_prio-min_prio))/100;
 544         pthread_attr_setschedparam(&attr, &sp);
 545     }
 546 #endif // HAVE_THREAD_PRIORITY_FUNCTIONS
 547
 548 #ifdef HAVE_PTHREAD_ATTR_SETSCOPE
 549     // this will make the threads created by this process really concurrent
 550     pthread_attr_setscope(&attr, PTHREAD_SCOPE_SYSTEM);
 551 #endif // HAVE_PTHREAD_ATTR_SETSCOPE
 552
 553     // create the new OS thread object
 554     int rc = pthread_create(p_internal->GetIdPtr(), &attr,
 555                             wxThreadInternal::PthreadStart, (void *)this);
 556     pthread_attr_destroy(&attr);
 557
 558     if ( rc != 0 )
 559     {
 560         p_internal->SetState(STATE_EXITED);
 561         return wxTHREAD_NO_RESOURCE;
 562     }
 563
 564     return wxTHREAD_NO_ERROR;
 565 }
 566
 567 wxThreadError wxThread::Run()
 568 {
 569     return p_internal->Run();
 570 }
 571
 572 // -----------------------------------------------------------------------------
 573 // misc accessors
 574 // -----------------------------------------------------------------------------
 575
 576 void wxThread::SetPriority(unsigned int prio)
 577 {
 578     wxCHECK_RET( ((int)WXTHREAD_MIN_PRIORITY <= (int)prio) &&
 579                  ((int)prio <= (int)WXTHREAD_MAX_PRIORITY),
 580                  _T("invalid thread priority") );
 581
 582     wxCriticalSectionLocker lock(m_critsect);
 583
 584     switch ( p_internal->GetState() )
 585     {
 586         case STATE_NEW:
 587             // thread not yet started, priority will be set when it is
 588             p_internal->SetPriority(prio);
 589             break;
 590
 591         case STATE_RUNNING:
 592         case STATE_PAUSED:
 593 #ifdef HAVE_THREAD_PRIORITY_FUNCTIONS
 594             {
 595                 struct sched_param sparam;
 596                 sparam.sched_priority = prio;
 597
 598                 if ( pthread_setschedparam(p_internal->GetId(),
 599                                            SCHED_OTHER, &sparam) != 0 )
 600                 {
 601                     wxLogError(_("Failed to set thread priority %d."), prio);
 602                 }
 603             }
 604 #endif // HAVE_THREAD_PRIORITY_FUNCTIONS
 605             break;
 606
 607         case STATE_EXITED:
 608         default:
 609             wxFAIL_MSG(_T("impossible to set thread priority in this state"));
 610     }
 611 }
 612
 613 unsigned int wxThread::GetPriority() const
 614 {
 615     wxCriticalSectionLocker lock((wxCriticalSection &)m_critsect);
 616
 617     return p_internal->GetPriority();
 618 }
 619
 620 unsigned long wxThread::GetID() const
 621 {
 622     return (unsigned long)p_internal->GetId();
 623 }
 624
 625 // -----------------------------------------------------------------------------
 626 // pause/resume
 627 // -----------------------------------------------------------------------------
 628
 629 wxThreadError wxThread::Pause()
 630 {
 631     wxCriticalSectionLocker lock(m_critsect);
 632
 633     if ( p_internal->GetState() != STATE_RUNNING )
 634     {
 635         wxLogDebug(_T("Can't pause thread which is not running."));
 636
 637         return wxTHREAD_NOT_RUNNING;
 638     }
 639
 640     p_internal->SetState(STATE_PAUSED);
 641
 642     return wxTHREAD_NO_ERROR;
 643 }
 644
 645 wxThreadError wxThread::Resume()
 646 {
 647     wxCriticalSectionLocker lock(m_critsect);
 648
 649     if ( p_internal->GetState() == STATE_PAUSED )
 650     {
 651         m_critsect.Leave();
 652         p_internal->Resume();
 653         m_critsect.Enter();
 654
 655         return wxTHREAD_NO_ERROR;
 656     }
 657     else
 658     {
 659         wxLogDebug(_T("Attempt to resume a thread which is not paused."));
 660
 661         return wxTHREAD_MISC_ERROR;
 662     }
 663 }
 664
 665 // -----------------------------------------------------------------------------
 666 // exiting thread
 667 // -----------------------------------------------------------------------------
 668
 669 wxThread::ExitCode wxThread::Delete()
 670 {
 671     if (IsPaused())
 672       Resume();
 673
 674     m_critsect.Enter();
 675     wxThreadState state = p_internal->GetState();
 676
 677     // ask the thread to stop
 678     p_internal->SetCancelFlag();
 679
 680     m_critsect.Leave();
 681
 682     switch ( state )
 683     {
 684         case STATE_NEW:
 685         case STATE_EXITED:
 686             // nothing to do
 687             break;
 688
 689         case STATE_PAUSED:
 690             // resume the thread first
 691             Resume();
 692
 693             // fall through
 694
 695         default:
 696             // wait until the thread stops
 697             p_internal->Wait();
 698     }
 699
 700     return NULL;
 701 }
 702
 703 wxThreadError wxThread::Kill()
 704 {
 705     switch ( p_internal->GetState() )
 706     {
 707         case STATE_NEW:
 708         case STATE_EXITED:
 709             return wxTHREAD_NOT_RUNNING;
 710
 711         default:
 712 #ifdef HAVE_PTHREAD_CANCEL
 713             if ( pthread_cancel(p_internal->GetId()) != 0 )
 714 #endif
 715             {
 716                 wxLogError(_("Failed to terminate a thread."));
 717
 718                 return wxTHREAD_MISC_ERROR;
 719             }
 720
 721             return wxTHREAD_NO_ERROR;
 722     }
 723 }
 724
 725 void wxThread::Exit(void *status)
 726 {
 727     // first call user-level clean up code
 728     OnExit();
 729
 730     // next wake up the threads waiting for us (OTOH, this function won't return
 731     // until someone waited for us!)
 732     p_internal->SignalExit();
 733
 734     p_internal->SetState(STATE_EXITED);
 735
 736     // delete both C++ thread object and terminate the OS thread object
 737     // GL: This is very ugly and buggy ...
 738 //    delete this;
 739     pthread_exit(status);
 740 }
 741
 742 // also test whether we were paused
 743 bool wxThread::TestDestroy()
 744 {
 745     wxCriticalSectionLocker lock(m_critsect);
 746
 747     if ( p_internal->GetState() == STATE_PAUSED )
 748     {
 749         // leave the crit section or the other threads will stop too if they try
 750         // to call any of (seemingly harmless) IsXXX() functions while we sleep
 751         m_critsect.Leave();
 752
 753         p_internal->Pause();
 754
 755         // enter it back before it's finally left in lock object dtor
 756         m_critsect.Enter();
 757     }
 758
 759     return p_internal->WasCancelled();
 760 }
 761
 762 wxThread::~wxThread()
 763 {
 764     m_critsect.Enter();
 765     if (p_internal->GetState() != STATE_EXITED &&
 766         p_internal->GetState() != STATE_NEW)
 767       wxLogDebug(_T("The thread is being destroyed althought it is still running ! The application may crash."));
 768
 769     m_critsect.Leave();
 770
 771     delete p_internal;
 772     // remove this thread from the global array
 773     gs_allThreads.Remove(this);
 774 }
 775
 776 // -----------------------------------------------------------------------------
 777 // state tests
 778 // -----------------------------------------------------------------------------
 779
 780 bool wxThread::IsRunning() const
 781 {
 782     wxCriticalSectionLocker lock((wxCriticalSection &)m_critsect);
 783
 784     return p_internal->GetState() == STATE_RUNNING;
 785 }
 786
 787 bool wxThread::IsAlive() const
 788 {
 789     wxCriticalSectionLocker lock((wxCriticalSection&)m_critsect);
 790
 791     switch ( p_internal->GetState() )
 792     {
 793         case STATE_RUNNING:
 794         case STATE_PAUSED:
 795             return TRUE;
 796
 797         default:
 798             return FALSE;
 799     }
 800 }
 801
 802 bool wxThread::IsPaused() const
 803 {
 804     wxCriticalSectionLocker lock((wxCriticalSection&)m_critsect);
 805
 806     return (p_internal->GetState() == STATE_PAUSED);
 807 }
 808
 809 //--------------------------------------------------------------------
 810 // wxThreadModule
 811 //--------------------------------------------------------------------
 812
 813 class wxThreadModule : public wxModule
 814 {
 815 public:
 816     virtual bool OnInit();
 817     virtual void OnExit();
 818
 819 private:
 820     DECLARE_DYNAMIC_CLASS(wxThreadModule)
 821 };
 822
 823 IMPLEMENT_DYNAMIC_CLASS(wxThreadModule, wxModule)
 824
 825 bool wxThreadModule::OnInit()
 826 {
 827     int rc = pthread_key_create(&gs_keySelf, NULL /* dtor function */);
 828     if ( rc != 0 )
 829     {
 830         wxLogSysError(rc, _("Thread module initialization failed: "
 831                             "failed to create thread key"));
 832
 833         return FALSE;
 834     }
 835
 836     gs_mutexGui = new wxMutex();
 837
 838     gs_tidMain = pthread_self();
 839
 840     gs_mutexGui->Lock();
 841
 842     return TRUE;
 843 }
 844
 845 void wxThreadModule::OnExit()
 846 {
 847     wxASSERT_MSG( wxThread::IsMain(), _T("only main thread can be here") );
 848
 849     // terminate any threads left
 850     size_t count = gs_allThreads.GetCount();
 851     if ( count != 0u )
 852         wxLogDebug(_T("Some threads were not terminated by the application."));
 853
 854     for ( size_t n = 0u; n < count; n++ )
 855     {
 856         gs_allThreads[n]->Delete();
 857     }
 858
 859     // destroy GUI mutex
 860     gs_mutexGui->Unlock();
 861
 862     delete gs_mutexGui;
 863
 864     // and free TLD slot
 865     (void)pthread_key_delete(gs_keySelf);
 866 }
 867
 868 // ----------------------------------------------------------------------------
 869 // global functions
 870 // ----------------------------------------------------------------------------
 871
 872 void wxMutexGuiEnter()
 873 {
 874   gs_mutexGui->Lock();
 875 }
 876
 877 void wxMutexGuiLeave()
 878 {
 879   gs_mutexGui->Unlock();
 880 }
 881
 882 #endif
 883   // wxUSE_THREADS