1 /**
2  * This file has no copyright assigned and is placed in the Public Domain.
3  * This file is part of the mingw-w64 runtime package.
4  * No warranty is given; refer to the file DISCLAIMER.PD within this package.
5  */
6 #ifndef _VDMDBG_
7 #define _VDMDBG_
8 
9 #ifdef __cplusplus
10 extern "C" {
11 #endif
12 
13 #include <pshpack4.h>
14 
15 #define STATUS_VDM_EVENT STATUS_SEGMENT_NOTIFICATION
16 
17 #ifndef DBG_SEGLOAD
18 #define DBG_SEGLOAD 0
19 #define DBG_SEGMOVE 1
20 #define DBG_SEGFREE 2
21 #define DBG_MODLOAD 3
22 #define DBG_MODFREE 4
23 #define DBG_SINGLESTEP 5
24 #define DBG_BREAK 6
25 #define DBG_GPFAULT 7
26 #define DBG_DIVOVERFLOW 8
27 #define DBG_INSTRFAULT 9
28 #define DBG_TASKSTART 10
29 #define DBG_TASKSTOP 11
30 #define DBG_DLLSTART 12
31 #define DBG_DLLSTOP 13
32 #define DBG_ATTACH 14
33 #define DBG_TOOLHELP 15
34 #define DBG_STACKFAULT 16
35 #define DBG_WOWINIT 17
36 #define DBG_TEMPBP 18
37 #define DBG_MODMOVE 19
38 #define DBG_INIT 20
39 #define DBG_GPFAULT2 21
40 #endif
41 
42 #define VDMEVENT_NEEDS_INTERACTIVE 0x8000
43 #define VDMEVENT_VERBOSE 0x4000
44 #define VDMEVENT_PE 0x2000
45 #define VDMEVENT_ALLFLAGS 0xe000
46 
47 #define VDMEVENT_V86 0x0001
48 #define VDMEVENT_PM16 0x0002
49 
50 #define VDMCONTEXT_i386 0x00010000
51 #define VDMCONTEXT_i486 0x00010000
52 
53 #define VDMCONTEXT_CONTROL (VDMCONTEXT_i386 | __MSABI_LONG(0x00000001))
54 #define VDMCONTEXT_INTEGER (VDMCONTEXT_i386 | __MSABI_LONG(0x00000002))
55 #define VDMCONTEXT_SEGMENTS (VDMCONTEXT_i386 | __MSABI_LONG(0x00000004))
56 #define VDMCONTEXT_FLOATING_POINT (VDMCONTEXT_i386 | __MSABI_LONG(0x00000008))
57 #define VDMCONTEXT_DEBUG_REGISTERS (VDMCONTEXT_i386 | __MSABI_LONG(0x00000010))
58 #define VDMCONTEXT_EXTENDED_REGISTERS (VDMCONTEXT_i386 | __MSABI_LONG(0x00000020))
59 
60 #define VDMCONTEXT_FULL (VDMCONTEXT_CONTROL | VDMCONTEXT_INTEGER | VDMCONTEXT_SEGMENTS)
61 
62 #ifdef _X86_
63 
64   typedef struct _CONTEXT VDMCONTEXT;
65   typedef struct _LDT_ENTRY VDMLDT_ENTRY;
66 #else
67 
68 #define SIZE_OF_80387_REGISTERS 80
69 
70   typedef struct _FLOATING_SAVE_AREA {
71     ULONG ControlWord;
72     ULONG StatusWord;
73     ULONG TagWord;
74     ULONG ErrorOffset;
75     ULONG ErrorSelector;
76     ULONG DataOffset;
77     ULONG DataSelector;
78     UCHAR RegisterArea[SIZE_OF_80387_REGISTERS];
79     ULONG Cr0NpxState;
80   } FLOATING_SAVE_AREA;
81 
82   typedef struct _VDMCONTEXT {
83     ULONG ContextFlags;
84 
85     ULONG Dr0;
86     ULONG Dr1;
87     ULONG Dr2;
88     ULONG Dr3;
89     ULONG Dr6;
90     ULONG Dr7;
91 
92     FLOATING_SAVE_AREA FloatSave;
93     ULONG SegGs;
94     ULONG SegFs;
95     ULONG SegEs;
96     ULONG SegDs;
97     ULONG Edi;
98     ULONG Esi;
99     ULONG Ebx;
100     ULONG Edx;
101     ULONG Ecx;
102     ULONG Eax;
103     ULONG Ebp;
104     ULONG Eip;
105     ULONG SegCs;
106     ULONG EFlags;
107     ULONG Esp;
108     ULONG SegSs;
109   } VDMCONTEXT;
110 
111   typedef struct _VDMLDT_ENTRY {
112     USHORT LimitLow;
113     USHORT BaseLow;
114     union {
115       struct {
116 	UCHAR BaseMid;
117 	UCHAR Flags1;
118 	UCHAR Flags2;
119 	UCHAR BaseHi;
120       } Bytes;
121       struct {
122 	ULONG BaseMid : 8;
123 	ULONG Type : 5;
124 	ULONG Dpl : 2;
125 	ULONG Pres : 1;
126 	ULONG LimitHi : 4;
127 	ULONG Sys : 1;
128 	ULONG Reserved_0 : 1;
129 	ULONG Default_Big : 1;
130 	ULONG Granularity : 1;
131 	ULONG BaseHi : 8;
132       } Bits;
133     } HighWord;
134   } VDMLDT_ENTRY;
135 #endif
136 
137   typedef VDMCONTEXT *LPVDMCONTEXT;
138   typedef VDMLDT_ENTRY *LPVDMLDT_ENTRY;
139 
140 #define VDMCONTEXT_TO_PROGRAM_COUNTER(Context) (PVOID)((Context)->Eip)
141 
142 #define VDMCONTEXT_LENGTH (sizeof(VDMCONTEXT))
143 #define VDMCONTEXT_ALIGN (sizeof(ULONG))
144 #define VDMCONTEXT_ROUND (VDMCONTEXT_ALIGN - 1)
145 
146 #define V86FLAGS_CARRY 0x00001
147 #define V86FLAGS_PARITY 0x00004
148 #define V86FLAGS_AUXCARRY 0x00010
149 #define V86FLAGS_ZERO 0x00040
150 #define V86FLAGS_SIGN 0x00080
151 #define V86FLAGS_TRACE 0x00100
152 #define V86FLAGS_INTERRUPT 0x00200
153 #define V86FLAGS_DIRECTION 0x00400
154 #define V86FLAGS_OVERFLOW 0x00800
155 #define V86FLAGS_IOPL 0x03000
156 #define V86FLAGS_IOPL_BITS 0x12
157 #define V86FLAGS_RESUME 0x10000
158 #define V86FLAGS_V86 0x20000
159 #define V86FLAGS_ALIGNMENT 0x40000
160 
161 #define MAX_MODULE_NAME 8 + 1
162 #define MAX_PATH16 255
163 
164   typedef struct _SEGMENT_NOTE {
165     WORD Selector1;
166     WORD Selector2;
167     WORD Segment;
168     CHAR Module[MAX_MODULE_NAME+1];
169     CHAR FileName[MAX_PATH16+1];
170     WORD Type;
171     DWORD Length;
172   } SEGMENT_NOTE;
173 
174   typedef struct _IMAGE_NOTE {
175     CHAR Module[MAX_MODULE_NAME+1];
176     CHAR FileName[MAX_PATH16+1];
177     WORD hModule;
178     WORD hTask;
179   } IMAGE_NOTE;
180 
181   typedef struct {
182     DWORD dwSize;
183     char szModule[MAX_MODULE_NAME+1];
184     HANDLE hModule;
185     WORD wcUsage;
186     char szExePath[MAX_PATH16+1];
187     WORD wNext;
188   } MODULEENTRY,*LPMODULEENTRY;
189 
190 #define SN_CODE 0
191 #define SN_DATA 1
192 #define SN_V86 2
193 
194   typedef struct _TEMP_BP_NOTE {
195     WORD Seg;
196     DWORD Offset;
197     WINBOOL bPM;
198   } TEMP_BP_NOTE;
199 
200   typedef struct _VDM_SEGINFO {
201     WORD Selector;
202     WORD SegNumber;
203     DWORD Length;
204     WORD Type;
205     CHAR ModuleName[MAX_MODULE_NAME];
206     CHAR FileName[MAX_PATH16];
207   } VDM_SEGINFO;
208 
209 #define GLOBAL_ALL 0
210 #define GLOBAL_LRU 1
211 #define GLOBAL_FREE 2
212 
213 #define GT_UNKNOWN 0
214 #define GT_DGROUP 1
215 #define GT_DATA 2
216 #define GT_CODE 3
217 #define GT_TASK 4
218 #define GT_RESOURCE 5
219 #define GT_MODULE 6
220 #define GT_FREE 7
221 #define GT_INTERNAL 8
222 #define GT_SENTINEL 9
223 #define GT_BURGERMASTER 10
224 
225 #define GD_USERDEFINED 0
226 #define GD_CURSORCOMPONENT 1
227 #define GD_BITMAP 2
228 #define GD_ICONCOMPONENT 3
229 #define GD_MENU 4
230 #define GD_DIALOG 5
231 #define GD_STRING 6
232 #define GD_FONTDIR 7
233 #define GD_FONT 8
234 #define GD_ACCELERATORS 9
235 #define GD_RCDATA 10
236 #define GD_ERRTABLE 11
237 #define GD_CURSOR 12
238 #define GD_ICON 14
239 #define GD_NAMETABLE 15
240 #define GD_MAX_RESOURCE 15
241 
242   typedef struct {
243     DWORD dwSize;
244     DWORD dwAddress;
245     DWORD dwBlockSize;
246     HANDLE hBlock;
247     WORD wcLock;
248     WORD wcPageLock;
249     WORD wFlags;
250     WINBOOL wHeapPresent;
251     HANDLE hOwner;
252     WORD wType;
253     WORD wData;
254     DWORD dwNext;
255     DWORD dwNextAlt;
256   } GLOBALENTRY,*LPGLOBALENTRY;
257 
258   typedef DWORD (CALLBACK *DEBUGEVENTPROC)(LPDEBUG_EVENT,LPVOID);
259 
260 #define W1(x) ((USHORT)(x.ExceptionInformation[0]))
261 #define W2(x) ((USHORT)(x.ExceptionInformation[0] >> 16))
262 #define W3(x) ((USHORT)(x.ExceptionInformation[1]))
263 #define W4(x) ((USHORT)(x.ExceptionInformation[1] >> 16))
264 #define DW3(x) (x.ExceptionInformation[2])
265 #define DW4(x) (x.ExceptionInformation[3])
266 
267 #include <poppack.h>
268 
269   WINBOOL WINAPI VDMProcessException(LPDEBUG_EVENT lpDebugEvent);
270   WINBOOL WINAPI VDMGetThreadSelectorEntry(HANDLE hProcess,HANDLE hThread,WORD wSelector,LPVDMLDT_ENTRY lpSelectorEntry);
271   ULONG WINAPI VDMGetPointer(HANDLE hProcess,HANDLE hThread,WORD wSelector,DWORD dwOffset,WINBOOL fProtMode);
272   WINBOOL WINAPI VDMGetContext(HANDLE hProcess,HANDLE hThread,LPVDMCONTEXT lpVDMContext);
273   WINBOOL WINAPI VDMSetContext(HANDLE hProcess,HANDLE hThread,LPVDMCONTEXT lpVDMContext);
274   WINBOOL WINAPI VDMGetSelectorModule(HANDLE hProcess,HANDLE hThread,WORD wSelector,PUINT lpSegmentNumber,LPSTR lpModuleName,UINT nNameSize,LPSTR lpModulePath,UINT nPathSize);
275   WINBOOL WINAPI VDMGetModuleSelector(HANDLE hProcess,HANDLE hThread,UINT wSegmentNumber,LPSTR lpModuleName,LPWORD lpSelector);
276   WINBOOL WINAPI VDMModuleFirst(HANDLE hProcess,HANDLE hThread,LPMODULEENTRY lpModuleEntry,DEBUGEVENTPROC lpEventProc,LPVOID lpData);
277   WINBOOL WINAPI VDMModuleNext(HANDLE hProcess,HANDLE hThread,LPMODULEENTRY lpModuleEntry,DEBUGEVENTPROC lpEventProc,LPVOID lpData);
278   WINBOOL WINAPI VDMGlobalFirst(HANDLE hProcess,HANDLE hThread,LPGLOBALENTRY lpGlobalEntry,WORD wFlags,DEBUGEVENTPROC lpEventProc,LPVOID lpData);
279   WINBOOL WINAPI VDMGlobalNext(HANDLE hProcess,HANDLE hThread,LPGLOBALENTRY lpGlobalEntry,WORD wFlags,DEBUGEVENTPROC lpEventProc,LPVOID lpData);
280 
281   typedef WINBOOL (WINAPI *PROCESSENUMPROC)(DWORD dwProcessId,DWORD dwAttributes,LPARAM lpUserDefined);
282   typedef WINBOOL (WINAPI *TASKENUMPROC)(DWORD dwThreadId,WORD hMod16,WORD hTask16,LPARAM lpUserDefined);
283   typedef WINBOOL (WINAPI *TASKENUMPROCEX)(DWORD dwThreadId,WORD hMod16,WORD hTask16,PSZ pszModName,PSZ pszFileName,LPARAM lpUserDefined);
284 
285 #define WOW_SYSTEM (DWORD)0x0001
286 
287   INT WINAPI VDMEnumProcessWOW(PROCESSENUMPROC fp,LPARAM lparam);
288   INT WINAPI VDMEnumTaskWOW(DWORD dwProcessId,TASKENUMPROC fp,LPARAM lparam);
289   INT WINAPI VDMEnumTaskWOWEx(DWORD dwProcessId,TASKENUMPROCEX fp,LPARAM lparam);
290   WINBOOL WINAPI VDMTerminateTaskWOW(DWORD dwProcessId,WORD htask);
291   WINBOOL WINAPI VDMStartTaskInWOW(DWORD dwProcessId,LPSTR lpCommandLine,WORD wShow);
292   WINBOOL WINAPI VDMKillWOW(VOID);
293   WINBOOL WINAPI VDMDetectWOW(VOID);
294   WINBOOL WINAPI VDMBreakThread(HANDLE hProcess,HANDLE hThread);
295   DWORD WINAPI VDMGetDbgFlags(HANDLE hProcess);
296   WINBOOL WINAPI VDMSetDbgFlags(HANDLE hProcess,DWORD dwFlags);
297 
298 #define VDMDBG_BREAK_DOSTASK 0x00000001
299 #define VDMDBG_BREAK_WOWTASK 0x00000002
300 #define VDMDBG_BREAK_LOADDLL 0x00000004
301 #define VDMDBG_BREAK_EXCEPTIONS 0x00000008
302 #define VDMDBG_BREAK_DEBUGGER 0x00000010
303 #define VDMDBG_TRACE_HISTORY 0x00000080
304 
305   WINBOOL WINAPI VDMIsModuleLoaded(LPSTR szPath);
306   WINBOOL WINAPI VDMGetSegmentInfo(WORD Selector,ULONG Offset,WINBOOL bProtectMode,VDM_SEGINFO *pSegInfo);
307   WINBOOL WINAPI VDMGetSymbol(LPSTR szModule,WORD SegNumber,DWORD Offset,WINBOOL bProtectMode,WINBOOL bNextSymbol,LPSTR szSymbolName,PDWORD pDisplacement);
308   WINBOOL WINAPI VDMGetAddrExpression(LPSTR szModule,LPSTR szSymbol,PWORD Selector,PDWORD Offset,PWORD Type);
309 
310 #define VDMADDR_V86 2
311 #define VDMADDR_PM16 4
312 #define VDMADDR_PM32 16
313 
314   typedef WINBOOL (WINAPI *VDMPROCESSEXCEPTIONPROC)(LPDEBUG_EVENT);
315   typedef WINBOOL (WINAPI *VDMGETTHREADSELECTORENTRYPROC)(HANDLE,HANDLE,DWORD,LPVDMLDT_ENTRY);
316   typedef ULONG (WINAPI *VDMGETPOINTERPROC)(HANDLE,HANDLE,WORD,DWORD,WINBOOL);
317   typedef WINBOOL (WINAPI *VDMGETCONTEXTPROC)(HANDLE,HANDLE,LPVDMCONTEXT);
318   typedef WINBOOL (WINAPI *VDMSETCONTEXTPROC)(HANDLE,HANDLE,LPVDMCONTEXT);
319   typedef WINBOOL (WINAPI *VDMKILLWOWPROC)(VOID);
320   typedef WINBOOL (WINAPI *VDMDETECTWOWPROC)(VOID);
321   typedef WINBOOL (WINAPI *VDMBREAKTHREADPROC)(HANDLE);
322   typedef WINBOOL (WINAPI *VDMGETSELECTORMODULEPROC)(HANDLE,HANDLE,WORD,PUINT,LPSTR,UINT,LPSTR,UINT);
323   typedef WINBOOL (WINAPI *VDMGETMODULESELECTORPROC)(HANDLE,HANDLE,UINT,LPSTR,LPWORD);
324   typedef WINBOOL (WINAPI *VDMMODULEFIRSTPROC)(HANDLE,HANDLE,LPMODULEENTRY,DEBUGEVENTPROC,LPVOID);
325   typedef WINBOOL (WINAPI *VDMMODULENEXTPROC)(HANDLE,HANDLE,LPMODULEENTRY,DEBUGEVENTPROC,LPVOID);
326   typedef WINBOOL (WINAPI *VDMGLOBALFIRSTPROC)(HANDLE,HANDLE,LPGLOBALENTRY,WORD,DEBUGEVENTPROC,LPVOID);
327   typedef WINBOOL (WINAPI *VDMGLOBALNEXTPROC)(HANDLE,HANDLE,LPGLOBALENTRY,WORD,DEBUGEVENTPROC,LPVOID);
328   typedef INT (WINAPI *VDMENUMPROCESSWOWPROC)(PROCESSENUMPROC,LPARAM);
329   typedef INT (WINAPI *VDMENUMTASKWOWPROC)(DWORD,TASKENUMPROC,LPARAM);
330   typedef INT (WINAPI *VDMENUMTASKWOWEXPROC)(DWORD,TASKENUMPROCEX,LPARAM);
331   typedef WINBOOL (WINAPI *VDMTERMINATETASKINWOWPROC)(DWORD,WORD);
332   typedef WINBOOL (WINAPI *VDMSTARTTASKINWOWPROC)(DWORD,LPSTR,WORD);
333   typedef DWORD (WINAPI *VDMGETDBGFLAGSPROC)(HANDLE);
334   typedef WINBOOL (WINAPI *VDMSETDBGFLAGSPROC)(HANDLE,DWORD);
335   typedef WINBOOL (WINAPI *VDMISMODULELOADEDPROC)(LPSTR);
336   typedef WINBOOL (WINAPI *VDMGETSEGMENTINFOPROC)(WORD,ULONG,WINBOOL,VDM_SEGINFO);
337   typedef WINBOOL (WINAPI *VDMGETSYMBOLPROC)(LPSTR,WORD,DWORD,WINBOOL,WINBOOL,LPSTR,PDWORD);
338   typedef WINBOOL (WINAPI *VDMGETADDREXPRESSIONPROC)(LPSTR,LPSTR,PWORD,PDWORD,PWORD);
339 
340 #ifdef __cplusplus
341 }
342 #endif
343 #endif
344