include/thread.h

   1 /*
   2  * Thread definitions
   3  *
   4  * Copyright 1996 Alexandre Julliard
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  */
  20
  21 #ifndef __WINE_THREAD_H
  22 #define __WINE_THREAD_H
  23
  24 #define WINE_NO_TEB
  25 #include <winternl.h>
  26 #include <wine/windef16.h>
  27
  28 struct _SECURITY_ATTRIBUTES;
  29 struct tagSYSLEVEL;
  30 struct server_buffer_info;
  31 struct fiber_data;
  32
  33 struct debug_info
  34 {
  35     char *str_pos;       /* current position in strings buffer */
  36     char *out_pos;       /* current position in output buffer */
  37     char  strings[1024]; /* buffer for temporary strings */
  38     char  output[1024];  /* current output line */
  39 };
  40
  41 /* Thread exception block
  42
  43   flags in the comment:
  44   1-- win95 field
  45   d-- win95 debug version
  46   -2- nt field
  47   --3 wine special
  48   --n wine unused
  49   !-- or -!- likely or observed  collision
  50   more problems (collected from mailing list):
  51   psapi.dll 0x10/0x30 (expects nt fields)
  52   ie4       0x40
  53   PESHiELD  0x23/0x30 (win95)
  54 */
  55 #ifndef WINE_TEB_DEFINED
  56 #define WINE_TEB_DEFINED
  57 typedef struct _TEB
  58 {
  59     NT_TIB       Tib;            /* 12-  00 Thread information block */
  60     WORD         tibflags;       /* 1!n  1c Flags (NT: EnvironmentPointer) */
  61     WORD         mutex_count;    /* 1-n  1e Win16 mutex count */
  62     CLIENT_ID    ClientId;       /* -2-  20 Process and thread id (win95: debug context) */
  63     HQUEUE16     queue;          /* 1!-  28 Message queue (NT: DWORD ActiveRpcHandle)*/
  64     WORD         pad1;           /* --n  2a */
  65     PVOID        ThreadLocalStoragePointer; /* 1--  2c Pointer to TLS array */
  66     PEB         *Peb;            /* 12-  30 owning process PEB */
  67     DWORD        flags;          /* 1-n  34 */
  68     DWORD        exit_code;      /* 1--  38 Termination status */
  69     WORD         teb_sel;        /* 1--  3c Selector to TEB */
  70     WORD         emu_sel;        /* 1-n  3e 80387 emulator selector */
  71     DWORD        unknown1;       /* --n  40 */
  72     DWORD        unknown2;       /* --n  44 */
  73     DWORD        unknown3;       /* --n  48 */
  74     int          thread_errno;   /* --3  4c Per-thread errno (was: ring0_thread) */
  75     int          thread_h_errno; /* --3  50 Per-thread h_errno (was: ptr to tdbx structure) */
  76     void        *signal_stack;   /* --3  54 Signal stack (was: stack_base) */
  77     void        *exit_stack;     /* 1-n  58 Exit stack */
  78     void        *emu_data;       /* --n  5c Related to 80387 emulation */
  79     DWORD        last_error;     /* 1--  60 Last error code */
  80     HANDLE       debug_cb;       /* 1-n  64 Debugger context block */
  81     DWORD        debug_thread;   /* 1-n  68 Thread debugging this one (?) */
  82     void        *pcontext;       /* 1-n  6c Thread register context */
  83     DWORD        cur_stack;      /* --3  70 Current stack (was: unknown) */
  84     DWORD        ThunkConnect;   /* 1-n  74 */
  85     DWORD        NegStackBase;   /* 1-n  78 */
  86     WORD         current_ss;     /* 1-n  7c Another 16-bit stack selector */
  87     WORD         pad2;           /* --n  7e */
  88     void        *ss_table;       /* --n  80 Pointer to info about 16-bit stack */
  89     WORD         stack_sel;      /* --3  84 16-bit stack selector */
  90     HTASK16      htask16;        /* --3  86 Win16 task handle */
  91     DWORD        pad4[15];       /* --n  88 */
  92     ULONG        CurrentLocale;  /* -2-  C4 */
  93     DWORD        pad5[48];       /* --n  C8 */
  94     DWORD        delta_priority; /* 1-n 188 Priority delta */
  95     DWORD        unknown4[7];    /* d-n 18c Unknown */
  96     void        *create_data;    /* d-n 1a8 Pointer to creation structure */
  97     DWORD        suspend_count;  /* d-n 1ac SuspendThread() counter */
  98     void        *entry_point;    /* --3 1b0 Thread entry point (was: unknown) */
  99     void        *entry_arg;      /* --3 1b4 Entry point arg (was: unknown) */
 100     DWORD        unknown5[4];    /* --n 1b8 Unknown */
 101     DWORD        sys_count[4];   /* --3 1c8 Syslevel mutex entry counters */
 102     struct tagSYSLEVEL *sys_mutex[4];   /* --3 1d8 Syslevel mutex pointers */
 103     DWORD        unknown6[5];    /* --n 1e8 Unknown */
 104
 105     /* The following are Wine-specific fields (NT: GDI stuff) */
 106     UINT         code_page;      /* --3 1fc Thread code page */
 107     DWORD        unused[2];      /* --3 200 Was server buffer */
 108     DWORD        gs_sel;         /* --3 208 %gs selector for this thread */
 109     int          request_fd;     /* --3 20c fd for sending server requests */
 110     int          reply_fd;       /* --3 210 fd for receiving server replies */
 111     int          wait_fd[2];     /* --3 214 fd for sleeping server requests */
 112     struct debug_info *debug_info;        /* --3 21c Info for debugstr functions */
 113     void        *pthread_data;   /* --3 220 Data for pthread emulation */
 114     struct async_private *pending_list;   /* --3 224 list of pending async operations */
 115     void        *driver_data;    /* --3 228 Graphics driver private data */
 116     DWORD        dpmi_vif;       /* --3 22c Protected mode virtual interrupt flag */
 117     DWORD        vm86_pending;   /* --3 230 Data for vm86 mode */
 118     void        *vm86_ptr;       /* --3 234 Data for vm86 mode */
 119     /* here is plenty space for wine specific fields (don't forget to change pad6!!) */
 120
 121     /* the following are nt specific fields */
 122     DWORD        pad6[624];                  /* --n 238 */
 123     UNICODE_STRING StaticUnicodeString;      /* -2- bf8 used by advapi32 */
 124     USHORT       StaticUnicodeBuffer[261];   /* -2- c00 used by advapi32 */
 125     PVOID        DeallocationStack;          /* -2- e0c Base of the stack */
 126     LPVOID       TlsSlots[64];               /* -2- e10 Thread local storage */
 127     DWORD        pad8[3];                    /* --n f10 */
 128     PVOID        ReservedForNtRpc;           /* -2- f1c used by rpcrt4 */
 129     DWORD        pad9[24];                   /* --n f20 */
 130     PVOID        ReservedForOle;             /* -2- f80 used by ole32 (IErrorInfo*) */
 131 } TEB;
 132 #endif /* WINE_TEB_DEFINED */
 133
 134 /* Thread exception flags */
 135 #define TEBF_WIN32  0x0001
 136 #define TEBF_TRAP   0x0002
 137
 138 /* The per-thread signal stack size */
 139 #define SIGNAL_STACK_SIZE  0x100000  /* 1Mb  FIXME: should be much smaller than that */
 140
 141
 142 /* scheduler/thread.c */
 143 extern void THREAD_Init(void);
 144 extern TEB *THREAD_InitStack( TEB *teb, DWORD stack_size );
 145
 146 /* scheduler/sysdeps.c */
 147 extern int SYSDEPS_SpawnThread( void (*func)(TEB *), TEB *teb );
 148 extern void SYSDEPS_SetCurThread( TEB *teb );
 149 extern int SYSDEPS_GetUnixTid(void);
 150 extern void DECLSPEC_NORETURN SYSDEPS_ExitThread( int status );
 151 extern void DECLSPEC_NORETURN SYSDEPS_AbortThread( int status );
 152
 153 /* signal handling */
 154 extern BOOL SIGNAL_Init(void);
 155 extern void SIGNAL_Block(void);
 156 extern void SIGNAL_Unblock(void);
 157 extern void SIGNAL_Reset(void);
 158
 159 #endif  /* __WINE_THREAD_H */