scheduler/thread.c

   1 /*
   2  * Win32 threads
   3  *
   4  * Copyright 1996 Alexandre Julliard
   5  */
   6
   7 #include <assert.h>
   8 #include <fcntl.h>
   9 #include <sys/types.h>
  10 #include <sys/socket.h>
  11 #include <unistd.h>
  12 #include "wine/winbase16.h"
  13 #include "thread.h"
  14 #include "process.h"
  15 #include "task.h"
  16 #include "module.h"
  17 #include "user.h"
  18 #include "winerror.h"
  19 #include "heap.h"
  20 #include "selectors.h"
  21 #include "winnt.h"
  22 #include "server.h"
  23 #include "services.h"
  24 #include "stackframe.h"
  25 #include "debugtools.h"
  26 #include "queue.h"
  27 #include "hook.h"
  28
  29 DEFAULT_DEBUG_CHANNEL(thread)
  30
  31 #ifndef __i386__
  32 THDB *pCurrentThread;
  33 #endif
  34
  35 /* Is threading code initialized? */
  36 BOOL THREAD_InitDone = FALSE;
  37
  38 /* THDB of the initial thread */
  39 static THDB initial_thdb;
  40
  41 /* Global thread list (FIXME: not thread-safe) */
  42 THDB *THREAD_First = &initial_thdb;
  43
  44 /***********************************************************************
  45  *           THREAD_Current
  46  *
  47  * Return the current thread THDB pointer.
  48  */
  49 THDB *THREAD_Current(void)
  50 {
  51     if (!THREAD_InitDone) return NULL;
  52     return (THDB *)((char *)NtCurrentTeb() - (int)&((THDB *)0)->teb);
  53 }
  54
  55 /***********************************************************************
  56  *           THREAD_IsWin16
  57  */
  58 BOOL THREAD_IsWin16( THDB *thdb )
  59 {
  60     return !thdb || !(thdb->teb.flags & TEBF_WIN32);
  61 }
  62
  63 /***********************************************************************
  64  *           THREAD_IdToTHDB
  65  *
  66  * Convert a thread id to a THDB, making sure it is valid.
  67  */
  68 THDB *THREAD_IdToTHDB( DWORD id )
  69 {
  70     THDB *thdb = THREAD_First;
  71
  72     if (!id) return THREAD_Current();
  73     while (thdb)
  74     {
  75         if ((DWORD)thdb->server_tid == id) return thdb;
  76         thdb = thdb->next;
  77     }
  78     /* Allow task handles to be used; convert to main thread */
  79     if ( IsTask16( id ) )
  80     {
  81         TDB *pTask = (TDB *)GlobalLock16( id );
  82         if (pTask) return pTask->thdb;
  83     }
  84     SetLastError( ERROR_INVALID_PARAMETER );
  85     return NULL;
  86 }
  87
  88
  89 /***********************************************************************
  90  *           THREAD_InitTHDB
  91  *
  92  * Initialization of a newly created THDB.
  93  */
  94 static BOOL THREAD_InitTHDB( THDB *thdb, DWORD stack_size, BOOL alloc_stack16,
  95                              LPSECURITY_ATTRIBUTES sa )
  96 {
  97     DWORD old_prot;
  98
  99     /* Allocate the stack */
 100
 101     /* FIXME:
 102      * If stacksize smaller than 1 MB, allocate 1MB
 103      * (one program wanted only 10 kB, which is recommendable, but some WINE
 104      *  functions, noteably in the files subdir, push HUGE structures and
 105      *  arrays on the stack. They probably shouldn't.)
 106      * If stacksize larger than 16 MB, warn the user. (We could shrink the stack
 107      * but this could give more or less unexplainable crashes.)
 108      */
 109     if (stack_size<1024*1024)
 110         stack_size = 1024 * 1024;
 111     if (stack_size >= 16*1024*1024)
 112         WARN("Thread stack size is %ld MB.\n",stack_size/1024/1024);
 113     thdb->stack_base = VirtualAlloc(NULL,
 114                                     stack_size + (alloc_stack16 ? 0x10000 : 0),
 115                                     MEM_COMMIT, PAGE_EXECUTE_READWRITE );
 116     if (!thdb->stack_base) goto error;
 117     /* Set a guard page at the bottom of the stack */
 118     VirtualProtect( thdb->stack_base, 1, PAGE_EXECUTE_READWRITE | PAGE_GUARD,
 119                     &old_prot );
 120     thdb->teb.stack_top   = (char *)thdb->stack_base + stack_size;
 121     thdb->teb.stack_low   = thdb->stack_base;
 122     thdb->exit_stack      = thdb->teb.stack_top;
 123
 124     /* Allocate the 16-bit stack selector */
 125
 126     if (alloc_stack16)
 127     {
 128         thdb->teb.stack_sel = SELECTOR_AllocBlock( thdb->teb.stack_top,
 129                                                    0x10000, SEGMENT_DATA,
 130                                                    FALSE, FALSE );
 131         if (!thdb->teb.stack_sel) goto error;
 132         thdb->cur_stack = PTR_SEG_OFF_TO_SEGPTR( thdb->teb.stack_sel,
 133                                                  0x10000 - sizeof(STACK16FRAME) );
 134     }
 135
 136     /* Create the thread event */
 137
 138     if (!(thdb->event = CreateEventA( NULL, FALSE, FALSE, NULL ))) goto error;
 139     thdb->event = ConvertToGlobalHandle( thdb->event );
 140     return TRUE;
 141
 142 error:
 143     if (thdb->event) CloseHandle( thdb->event );
 144     if (thdb->teb.stack_sel) SELECTOR_FreeBlock( thdb->teb.stack_sel, 1 );
 145     if (thdb->stack_base) VirtualFree( thdb->stack_base, 0, MEM_RELEASE );
 146     return FALSE;
 147 }
 148
 149
 150 /***********************************************************************
 151  *           THREAD_FreeTHDB
 152  *
 153  * Free data structures associated with a thread.
 154  * Must be called from the context of another thread.
 155  */
 156 void CALLBACK THREAD_FreeTHDB( ULONG_PTR arg )
 157 {
 158     THDB *thdb = (THDB *)arg;
 159     THDB **pptr = &THREAD_First;
 160
 161     TRACE("(%p) called\n", thdb );
 162     SERVICE_Delete( thdb->cleanup );
 163
 164     PROCESS_CallUserSignalProc( USIG_THREAD_EXIT, 0, 0 );
 165
 166     CloseHandle( thdb->event );
 167     while (*pptr && (*pptr != thdb)) pptr = &(*pptr)->next;
 168     if (*pptr) *pptr = thdb->next;
 169
 170     /* Free the associated memory */
 171
 172     if (thdb->teb.stack_sel) SELECTOR_FreeBlock( thdb->teb.stack_sel, 1 );
 173     SELECTOR_FreeBlock( thdb->teb_sel, 1 );
 174     close( thdb->socket );
 175     VirtualFree( thdb->stack_base, 0, MEM_RELEASE );
 176     HeapFree( SystemHeap, HEAP_NO_SERIALIZE, thdb );
 177 }
 178
 179
 180 /***********************************************************************
 181  *           THREAD_CreateInitialThread
 182  *
 183  * Create the initial thread.
 184  */
 185 THDB *THREAD_CreateInitialThread( PDB *pdb, int server_fd )
 186 {
 187     initial_thdb.process         = pdb;
 188     initial_thdb.teb.except      = (void *)-1;
 189     initial_thdb.teb.self        = &initial_thdb.teb;
 190     initial_thdb.teb.flags       = /* TEBF_WIN32 */ 0;
 191     initial_thdb.teb.tls_ptr     = initial_thdb.tls_array;
 192     initial_thdb.teb.process     = pdb;
 193     initial_thdb.exit_code       = 0x103; /* STILL_ACTIVE */
 194     initial_thdb.socket          = server_fd;
 195
 196     /* Allocate the TEB selector (%fs register) */
 197
 198     if (!(initial_thdb.teb_sel = SELECTOR_AllocBlock( &initial_thdb.teb, 0x1000,
 199                                                       SEGMENT_DATA, TRUE, FALSE )))
 200     {
 201         MESSAGE("Could not allocate fs register for initial thread\n" );
 202         return NULL;
 203     }
 204     SET_CUR_THREAD( &initial_thdb );
 205     THREAD_InitDone = TRUE;
 206
 207     /* Now proceed with normal initialization */
 208
 209     if (CLIENT_InitThread()) return NULL;
 210     if (!THREAD_InitTHDB( &initial_thdb, 0, TRUE, NULL )) return NULL;
 211     return &initial_thdb;
 212 }
 213
 214
 215 /***********************************************************************
 216  *           THREAD_Create
 217  */
 218 THDB *THREAD_Create( PDB *pdb, DWORD flags, DWORD stack_size, BOOL alloc_stack16,
 219                      LPSECURITY_ATTRIBUTES sa, int *server_handle )
 220 {
 221     struct new_thread_request request;
 222     struct new_thread_reply reply = { NULL, -1 };
 223     int fd[2];
 224
 225     THDB *thdb = HeapAlloc( SystemHeap, HEAP_ZERO_MEMORY, sizeof(THDB) );
 226     if (!thdb) return NULL;
 227     thdb->process         = pdb;
 228     thdb->teb.except      = (void *)-1;
 229     thdb->teb.htask16     = pdb->task;
 230     thdb->teb.self        = &thdb->teb;
 231     thdb->teb.flags       = (pdb->flags & PDB32_WIN16_PROC)? 0 : TEBF_WIN32;
 232     thdb->teb.tls_ptr     = thdb->tls_array;
 233     thdb->teb.process     = pdb;
 234     thdb->exit_code       = 0x103; /* STILL_ACTIVE */
 235     thdb->flags           = flags;
 236     thdb->socket          = -1;
 237
 238     /* Allocate the TEB selector (%fs register) */
 239
 240     thdb->teb_sel = SELECTOR_AllocBlock( &thdb->teb, 0x1000, SEGMENT_DATA,
 241                                          TRUE, FALSE );
 242     if (!thdb->teb_sel) goto error;
 243
 244     /* Create the socket pair for server communication */
 245
 246     if (socketpair( AF_UNIX, SOCK_STREAM, 0, fd ) == -1)
 247     {
 248         SetLastError( ERROR_TOO_MANY_OPEN_FILES );  /* FIXME */
 249         goto error;
 250     }
 251     thdb->socket = fd[0];
 252     fcntl( fd[0], F_SETFD, 1 ); /* set close on exec flag */
 253
 254     /* Create the thread on the server side */
 255
 256     request.pid     = thdb->process->server_pid;
 257     request.suspend = ((thdb->flags & CREATE_SUSPENDED) != 0);
 258     request.inherit = (sa && (sa->nLength>=sizeof(*sa)) && sa->bInheritHandle);
 259     CLIENT_SendRequest( REQ_NEW_THREAD, fd[1], 1, &request, sizeof(request) );
 260     if (CLIENT_WaitSimpleReply( &reply, sizeof(reply), NULL )) goto error;
 261     thdb->server_tid = reply.tid;
 262     *server_handle = reply.handle;
 263
 264     /* Do the rest of the initialization */
 265
 266     if (!THREAD_InitTHDB( thdb, stack_size, alloc_stack16, sa )) goto error;
 267     thdb->next = THREAD_First;
 268     THREAD_First = thdb;
 269
 270     /* Install cleanup handler */
 271
 272     thdb->cleanup = SERVICE_AddObject( *server_handle,
 273                                        THREAD_FreeTHDB, (ULONG_PTR)thdb );
 274     return thdb;
 275
 276 error:
 277     if (reply.handle != -1) CloseHandle( reply.handle );
 278     if (thdb->teb_sel) SELECTOR_FreeBlock( thdb->teb_sel, 1 );
 279     HeapFree( SystemHeap, 0, thdb );
 280     if (thdb->socket != -1) close( thdb->socket );
 281     return NULL;
 282 }
 283
 284
 285 /***********************************************************************
 286  *           THREAD_Start
 287  *
 288  * Start execution of a newly created thread. Does not return.
 289  */
 290 static void THREAD_Start(void)
 291 {
 292     THDB *thdb = THREAD_Current();
 293     LPTHREAD_START_ROUTINE func = (LPTHREAD_START_ROUTINE)thdb->entry_point;
 294     PROCESS_CallUserSignalProc( USIG_THREAD_INIT, 0, 0 );
 295     PE_InitTls();
 296     MODULE_DllThreadAttach( NULL );
 297     ExitThread( func( thdb->entry_arg ) );
 298 }
 299
 300
 301 /***********************************************************************
 302  *           CreateThread   (KERNEL32.63)
 303  */
 304 HANDLE WINAPI CreateThread( SECURITY_ATTRIBUTES *sa, DWORD stack,
 305                             LPTHREAD_START_ROUTINE start, LPVOID param,
 306                             DWORD flags, LPDWORD id )
 307 {
 308     int handle = -1;
 309     THDB *thread = THREAD_Create( PROCESS_Current(), flags, stack, TRUE, sa, &handle );
 310     if (!thread) return INVALID_HANDLE_VALUE;
 311     thread->teb.flags  |= TEBF_WIN32;
 312     thread->entry_point = start;
 313     thread->entry_arg   = param;
 314     thread->startup     = THREAD_Start;
 315     if (SYSDEPS_SpawnThread( thread ) == -1)
 316     {
 317         CloseHandle( handle );
 318         return INVALID_HANDLE_VALUE;
 319     }
 320     if (id) *id = (DWORD)thread->server_tid;
 321     return handle;
 322 }
 323
 324
 325 /***********************************************************************
 326  * ExitThread [KERNEL32.215]  Ends a thread
 327  *
 328  * RETURNS
 329  *    None
 330  */
 331 void WINAPI ExitThread( DWORD code ) /* [in] Exit code for this thread */
 332 {
 333     MODULE_DllThreadDetach( NULL );
 334     TerminateThread( GetCurrentThread(), code );
 335 }
 336
 337
 338 /***********************************************************************
 339  * GetCurrentThread [KERNEL32.200]  Gets pseudohandle for current thread
 340  *
 341  * RETURNS
 342  *    Pseudohandle for the current thread
 343  */
 344 HANDLE WINAPI GetCurrentThread(void)
 345 {
 346     return CURRENT_THREAD_PSEUDOHANDLE;
 347 }
 348
 349
 350 /***********************************************************************
 351  * GetCurrentThreadId [KERNEL32.201]  Returns thread identifier.
 352  *
 353  * RETURNS
 354  *    Thread identifier of calling thread
 355  */
 356 DWORD WINAPI GetCurrentThreadId(void)
 357 {
 358     THDB *thdb = THREAD_Current();
 359     assert( thdb );
 360     assert( thdb->server_tid );
 361     return (DWORD)thdb->server_tid;
 362 }
 363
 364
 365 /**********************************************************************
 366  * GetLastError [KERNEL.148] [KERNEL32.227]  Returns last-error code.
 367  *
 368  * RETURNS
 369  *     Calling thread's last error code value.
 370  */
 371 DWORD WINAPI GetLastError(void)
 372 {
 373     THDB *thread = THREAD_Current();
 374     DWORD ret = thread->last_error;
 375     TRACE("0x%lx\n",ret);
 376     return ret;
 377 }
 378
 379
 380 /**********************************************************************
 381  * SetLastError [KERNEL.147] [KERNEL32.497]  Sets the last-error code.
 382  *
 383  * RETURNS
 384  *    None.
 385  */
 386 void WINAPI SetLastError(
 387     DWORD error) /* [in] Per-thread error code */
 388 {
 389     THDB *thread = THREAD_Current();
 390     /* This one must work before we have a thread (FIXME) */
 391
 392     TRACE("%p error=0x%lx\n",thread,error);
 393
 394     if (thread)
 395       thread->last_error = error;
 396 }
 397
 398
 399 /**********************************************************************
 400  * SetLastErrorEx [USER32.485]  Sets the last-error code.
 401  *
 402  * RETURNS
 403  *    None.
 404  */
 405 void WINAPI SetLastErrorEx(
 406     DWORD error, /* [in] Per-thread error code */
 407     DWORD type)  /* [in] Error type */
 408 {
 409     TRACE("(0x%08lx, 0x%08lx)\n", error,type);
 410     switch(type) {
 411         case 0:
 412             break;
 413         case SLE_ERROR:
 414         case SLE_MINORERROR:
 415         case SLE_WARNING:
 416             /* Fall through for now */
 417         default:
 418             FIXME("(error=%08lx, type=%08lx): Unhandled type\n", error,type);
 419             break;
 420     }
 421     SetLastError( error );
 422 }
 423
 424
 425 /**********************************************************************
 426  * TlsAlloc [KERNEL32.530]  Allocates a TLS index.
 427  *
 428  * Allocates a thread local storage index
 429  *
 430  * RETURNS
 431  *    Success: TLS Index
 432  *    Failure: 0xFFFFFFFF
 433  */
 434 DWORD WINAPI TlsAlloc( void )
 435 {
 436     THDB *thread = THREAD_Current();
 437     DWORD i, mask, ret = 0;
 438     DWORD *bits = thread->process->tls_bits;
 439     EnterCriticalSection( &thread->process->crit_section );
 440     if (*bits == 0xffffffff)
 441     {
 442         bits++;
 443         ret = 32;
 444         if (*bits == 0xffffffff)
 445         {
 446             LeaveCriticalSection( &thread->process->crit_section );
 447             SetLastError( ERROR_NO_MORE_ITEMS );
 448             return 0xffffffff;
 449         }
 450     }
 451     for (i = 0, mask = 1; i < 32; i++, mask <<= 1) if (!(*bits & mask)) break;
 452     *bits |= mask;
 453     LeaveCriticalSection( &thread->process->crit_section );
 454     return ret + i;
 455 }
 456
 457
 458 /**********************************************************************
 459  * TlsFree [KERNEL32.531]  Releases a TLS index.
 460  *
 461  * Releases a thread local storage index, making it available for reuse
 462  *
 463  * RETURNS
 464  *    Success: TRUE
 465  *    Failure: FALSE
 466  */
 467 BOOL WINAPI TlsFree(
 468     DWORD index) /* [in] TLS Index to free */
 469 {
 470     DWORD mask;
 471     THDB *thread = THREAD_Current();
 472     DWORD *bits = thread->process->tls_bits;
 473     if (index >= 64)
 474     {
 475         SetLastError( ERROR_INVALID_PARAMETER );
 476         return FALSE;
 477     }
 478     EnterCriticalSection( &thread->process->crit_section );
 479     if (index >= 32) bits++;
 480     mask = (1 << (index & 31));
 481     if (!(*bits & mask))  /* already free? */
 482     {
 483         LeaveCriticalSection( &thread->process->crit_section );
 484         SetLastError( ERROR_INVALID_PARAMETER );
 485         return FALSE;
 486     }
 487     *bits &= ~mask;
 488     thread->tls_array[index] = 0;
 489     /* FIXME: should zero all other thread values */
 490     LeaveCriticalSection( &thread->process->crit_section );
 491     return TRUE;
 492 }
 493
 494
 495 /**********************************************************************
 496  * TlsGetValue [KERNEL32.532]  Gets value in a thread's TLS slot
 497  *
 498  * RETURNS
 499  *    Success: Value stored in calling thread's TLS slot for index
 500  *    Failure: 0 and GetLastError returns NO_ERROR
 501  */
 502 LPVOID WINAPI TlsGetValue(
 503     DWORD index) /* [in] TLS index to retrieve value for */
 504 {
 505     THDB *thread = THREAD_Current();
 506     if (index >= 64)
 507     {
 508         SetLastError( ERROR_INVALID_PARAMETER );
 509         return NULL;
 510     }
 511     SetLastError( ERROR_SUCCESS );
 512     return thread->tls_array[index];
 513 }
 514
 515
 516 /**********************************************************************
 517  * TlsSetValue [KERNEL32.533]  Stores a value in the thread's TLS slot.
 518  *
 519  * RETURNS
 520  *    Success: TRUE
 521  *    Failure: FALSE
 522  */
 523 BOOL WINAPI TlsSetValue(
 524     DWORD index,  /* [in] TLS index to set value for */
 525     LPVOID value) /* [in] Value to be stored */
 526 {
 527     THDB *thread = THREAD_Current();
 528     if (index >= 64)
 529     {
 530         SetLastError( ERROR_INVALID_PARAMETER );
 531         return FALSE;
 532     }
 533     thread->tls_array[index] = value;
 534     return TRUE;
 535 }
 536
 537
 538 /***********************************************************************
 539  * SetThreadContext [KERNEL32.670]  Sets context of thread.
 540  *
 541  * RETURNS
 542  *    Success: TRUE
 543  *    Failure: FALSE
 544  */
 545 BOOL WINAPI SetThreadContext(
 546     HANDLE handle,  /* [in]  Handle to thread with context */
 547     CONTEXT *context) /* [out] Address of context structure */
 548 {
 549     FIXME("not implemented\n" );
 550     return TRUE;
 551 }
 552
 553 /***********************************************************************
 554  * GetThreadContext [KERNEL32.294]  Retrieves context of thread.
 555  *
 556  * RETURNS
 557  *    Success: TRUE
 558  *    Failure: FALSE
 559  */
 560 BOOL WINAPI GetThreadContext(
 561     HANDLE handle,  /* [in]  Handle to thread with context */
 562     CONTEXT *context) /* [out] Address of context structure */
 563 {
 564     WORD cs, ds;
 565
 566     FIXME("returning dummy info\n" );
 567
 568     /* make up some plausible values for segment registers */
 569     GET_CS(cs);
 570     GET_DS(ds);
 571     context->SegCs   = cs;
 572     context->SegDs   = ds;
 573     context->SegEs   = ds;
 574     context->SegGs   = ds;
 575     context->SegSs   = ds;
 576     context->SegFs   = ds;
 577     return TRUE;
 578 }
 579
 580
 581 /**********************************************************************
 582  * GetThreadPriority [KERNEL32.296]  Returns priority for thread.
 583  *
 584  * RETURNS
 585  *    Success: Thread's priority level.
 586  *    Failure: THREAD_PRIORITY_ERROR_RETURN
 587  */
 588 INT WINAPI GetThreadPriority(
 589     HANDLE hthread) /* [in] Handle to thread */
 590 {
 591     struct get_thread_info_request req;
 592     struct get_thread_info_reply reply;
 593     req.handle = hthread;
 594     CLIENT_SendRequest( REQ_GET_THREAD_INFO, -1, 1, &req, sizeof(req) );
 595     if (CLIENT_WaitSimpleReply( &reply, sizeof(reply), NULL ))
 596         return THREAD_PRIORITY_ERROR_RETURN;
 597     return reply.priority;
 598 }
 599
 600
 601 /**********************************************************************
 602  * SetThreadPriority [KERNEL32.514]  Sets priority for thread.
 603  *
 604  * RETURNS
 605  *    Success: TRUE
 606  *    Failure: FALSE
 607  */
 608 BOOL WINAPI SetThreadPriority(
 609     HANDLE hthread, /* [in] Handle to thread */
 610     INT priority)   /* [in] Thread priority level */
 611 {
 612     struct set_thread_info_request req;
 613     req.handle   = hthread;
 614     req.priority = priority;
 615     req.mask     = SET_THREAD_INFO_PRIORITY;
 616     CLIENT_SendRequest( REQ_SET_THREAD_INFO, -1, 1, &req, sizeof(req) );
 617     return !CLIENT_WaitReply( NULL, NULL, 0 );
 618 }
 619
 620
 621 /**********************************************************************
 622  *           SetThreadAffinityMask   (KERNEL32.669)
 623  */
 624 DWORD WINAPI SetThreadAffinityMask( HANDLE hThread, DWORD dwThreadAffinityMask )
 625 {
 626     struct set_thread_info_request req;
 627     req.handle   = hThread;
 628     req.affinity = dwThreadAffinityMask;
 629     req.mask     = SET_THREAD_INFO_AFFINITY;
 630     CLIENT_SendRequest( REQ_SET_THREAD_INFO, -1, 1, &req, sizeof(req) );
 631     if (CLIENT_WaitReply( NULL, NULL, 0 )) return 0;
 632     return 1;  /* FIXME: should return previous value */
 633 }
 634
 635
 636 /**********************************************************************
 637  * TerminateThread [KERNEL32.685]  Terminates a thread
 638  *
 639  * RETURNS
 640  *    Success: TRUE
 641  *    Failure: FALSE
 642  */
 643 BOOL WINAPI TerminateThread(
 644     HANDLE handle, /* [in] Handle to thread */
 645     DWORD exitcode)  /* [in] Exit code for thread */
 646 {
 647     struct terminate_thread_request req;
 648     req.handle    = handle;
 649     req.exit_code = exitcode;
 650     CLIENT_SendRequest( REQ_TERMINATE_THREAD, -1, 1, &req, sizeof(req) );
 651     return !CLIENT_WaitReply( NULL, NULL, 0 );
 652 }
 653
 654
 655 /**********************************************************************
 656  * GetExitCodeThread [KERNEL32.???]  Gets termination status of thread.
 657  *
 658  * RETURNS
 659  *    Success: TRUE
 660  *    Failure: FALSE
 661  */
 662 BOOL WINAPI GetExitCodeThread(
 663     HANDLE hthread, /* [in]  Handle to thread */
 664     LPDWORD exitcode) /* [out] Address to receive termination status */
 665 {
 666     struct get_thread_info_request req;
 667     struct get_thread_info_reply reply;
 668     req.handle = hthread;
 669     CLIENT_SendRequest( REQ_GET_THREAD_INFO, -1, 1, &req, sizeof(req) );
 670     if (CLIENT_WaitSimpleReply( &reply, sizeof(reply), NULL )) return FALSE;
 671     if (exitcode) *exitcode = reply.exit_code;
 672     return TRUE;
 673 }
 674
 675
 676 /**********************************************************************
 677  * ResumeThread [KERNEL32.587]  Resumes a thread.
 678  *
 679  * Decrements a thread's suspend count.  When count is zero, the
 680  * execution of the thread is resumed.
 681  *
 682  * RETURNS
 683  *    Success: Previous suspend count
 684  *    Failure: 0xFFFFFFFF
 685  *    Already running: 0
 686  */
 687 DWORD WINAPI ResumeThread(
 688     HANDLE hthread) /* [in] Identifies thread to restart */
 689 {
 690     struct resume_thread_request req;
 691     struct resume_thread_reply reply;
 692     req.handle = hthread;
 693     CLIENT_SendRequest( REQ_RESUME_THREAD, -1, 1, &req, sizeof(req) );
 694     if (CLIENT_WaitSimpleReply( &reply, sizeof(reply), NULL )) return 0xffffffff;
 695     return reply.count;
 696 }
 697
 698
 699 /**********************************************************************
 700  * SuspendThread [KERNEL32.681]  Suspends a thread.
 701  *
 702  * RETURNS
 703  *    Success: Previous suspend count
 704  *    Failure: 0xFFFFFFFF
 705  */
 706 DWORD WINAPI SuspendThread(
 707     HANDLE hthread) /* [in] Handle to the thread */
 708 {
 709     struct suspend_thread_request req;
 710     struct suspend_thread_reply reply;
 711     req.handle = hthread;
 712     CLIENT_SendRequest( REQ_SUSPEND_THREAD, -1, 1, &req, sizeof(req) );
 713     if (CLIENT_WaitSimpleReply( &reply, sizeof(reply), NULL )) return 0xffffffff;
 714     return reply.count;
 715 }
 716
 717
 718 /***********************************************************************
 719  *              QueueUserAPC  (KERNEL32.566)
 720  */
 721 DWORD WINAPI QueueUserAPC( PAPCFUNC func, HANDLE hthread, ULONG_PTR data )
 722 {
 723     struct queue_apc_request req;
 724     req.handle = hthread;
 725     req.func   = func;
 726     req.param  = (void *)data;
 727     CLIENT_SendRequest( REQ_QUEUE_APC, -1, 1, &req, sizeof(req) );
 728     return !CLIENT_WaitReply( NULL, NULL, 0 );
 729 }
 730
 731
 732 /**********************************************************************
 733  * GetThreadTimes [KERNEL32.???]  Obtains timing information.
 734  *
 735  * NOTES
 736  *    What are the fields where these values are stored?
 737  *
 738  * RETURNS
 739  *    Success: TRUE
 740  *    Failure: FALSE
 741  */
 742 BOOL WINAPI GetThreadTimes(
 743     HANDLE thread,         /* [in]  Specifies the thread of interest */
 744     LPFILETIME creationtime, /* [out] When the thread was created */
 745     LPFILETIME exittime,     /* [out] When the thread was destroyed */
 746     LPFILETIME kerneltime,   /* [out] Time thread spent in kernel mode */
 747     LPFILETIME usertime)     /* [out] Time thread spent in user mode */
 748 {
 749     FIXME("(0x%08x): stub\n",thread);
 750     SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
 751     return FALSE;
 752 }
 753
 754
 755 /**********************************************************************
 756  * AttachThreadInput [KERNEL32.8]  Attaches input of 1 thread to other
 757  *
 758  * Attaches the input processing mechanism of one thread to that of
 759  * another thread.
 760  *
 761  * RETURNS
 762  *    Success: TRUE
 763  *    Failure: FALSE
 764  *
 765  * TODO:
 766  *    1. Reset the Key State (currenly per thread key state is not maintained)
 767  */
 768 BOOL WINAPI AttachThreadInput(
 769     DWORD idAttach,   /* [in] Thread to attach */
 770     DWORD idAttachTo, /* [in] Thread to attach to */
 771     BOOL fAttach)   /* [in] Attach or detach */
 772 {
 773     MESSAGEQUEUE *pSrcMsgQ = 0, *pTgtMsgQ = 0;
 774     BOOL16 bRet = 0;
 775
 776     SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
 777
 778     /* A thread cannot attach to itself */
 779     if ( idAttach == idAttachTo )
 780         goto CLEANUP;
 781
 782     /* According to the docs this method should fail if a
 783      * "Journal record" hook is installed. (attaches all input queues together)
 784      */
 785     if ( HOOK_IsHooked( WH_JOURNALRECORD ) )
 786         goto CLEANUP;
 787
 788     /* Retrieve message queues corresponding to the thread id's */
 789     pTgtMsgQ = (MESSAGEQUEUE *)QUEUE_Lock( GetThreadQueue16( idAttach ) );
 790     pSrcMsgQ = (MESSAGEQUEUE *)QUEUE_Lock( GetThreadQueue16( idAttachTo ) );
 791
 792     /* Ensure we have message queues and that Src and Tgt threads
 793      * are not system threads.
 794      */
 795     if ( !pSrcMsgQ || !pTgtMsgQ || !pSrcMsgQ->pQData || !pTgtMsgQ->pQData )
 796         goto CLEANUP;
 797
 798     if (fAttach)   /* Attach threads */
 799     {
 800         /* Only attach if currently detached  */
 801         if ( pTgtMsgQ->pQData != pSrcMsgQ->pQData )
 802         {
 803             /* First release the target threads perQData */
 804             PERQDATA_Release( pTgtMsgQ->pQData );
 805
 806             /* Share a reference to the source threads perQDATA */
 807             PERQDATA_Addref( pSrcMsgQ->pQData );
 808             pTgtMsgQ->pQData = pSrcMsgQ->pQData;
 809         }
 810     }
 811     else    /* Detach threads */
 812     {
 813         /* Only detach if currently attached */
 814         if ( pTgtMsgQ->pQData == pSrcMsgQ->pQData )
 815         {
 816             /* First release the target threads perQData */
 817             PERQDATA_Release( pTgtMsgQ->pQData );
 818
 819             /* Give the target thread its own private perQDATA once more */
 820             pTgtMsgQ->pQData = PERQDATA_CreateInstance();
 821         }
 822     }
 823
 824     /* TODO: Reset the Key State */
 825
 826     bRet = 1;      /* Success */
 827
 828 CLEANUP:
 829
 830     /* Unlock the queues before returning */
 831     if ( pSrcMsgQ )
 832         QUEUE_Unlock( pSrcMsgQ );
 833     if ( pTgtMsgQ )
 834         QUEUE_Unlock( pTgtMsgQ );
 835
 836     return bRet;
 837 }
 838
 839 /**********************************************************************
 840  * VWin32_BoostThreadGroup [KERNEL.535]
 841  */
 842 VOID WINAPI VWin32_BoostThreadGroup( DWORD threadId, INT boost )
 843 {
 844     FIXME("(0x%08lx,%d): stub\n", threadId, boost);
 845 }
 846
 847 /**********************************************************************
 848  * VWin32_BoostThreadStatic [KERNEL.536]
 849  */
 850 VOID WINAPI VWin32_BoostThreadStatic( DWORD threadId, INT boost )
 851 {
 852     FIXME("(0x%08lx,%d): stub\n", threadId, boost);
 853 }
 854
 855 /**********************************************************************
 856  * SetThreadLocale [KERNEL32.671]  Sets the calling threads current locale.
 857  *
 858  * RETURNS
 859  *    Success: TRUE
 860  *    Failure: FALSE
 861  *
 862  * NOTES
 863  *  Implemented in NT only (3.1 and above according to MS
 864  */
 865 BOOL WINAPI SetThreadLocale(
 866     LCID lcid)     /* [in] Locale identifier */
 867 {
 868     SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
 869     return FALSE;
 870 }