VirtualBox

source: vbox/trunk/src/VBox/Debugger/DBGPlugInOS2.cpp@ 60550

Last change on this file since 60550 was 57358, checked in by vboxsync, 9 years ago

*: scm cleanup run.
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 11.6 KB
Line 
1/* $Id: DBGPlugInOS2.cpp 57358 2015-08-14 15:16:38Z vboxsync $ */
2/** @file
3 * DBGPlugInOS2 - Debugger and Guest OS Digger Plugin For OS/2.
4 */
5
6/*
7 * Copyright (C) 2009-2015 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 */
17
18
19/*********************************************************************************************************************************
20* Header Files *
21*********************************************************************************************************************************/
22#define LOG_GROUP LOG_GROUP_DBGF ///@todo add new log group.
23#include "DBGPlugIns.h"
24#include <VBox/vmm/dbgf.h>
25#include <VBox/err.h>
26#include <VBox/param.h>
27#include <iprt/string.h>
28#include <iprt/mem.h>
29#include <iprt/stream.h>
30
31
32/*********************************************************************************************************************************
33* Structures and Typedefs *
34*********************************************************************************************************************************/
35
36/** @name Internal OS/2 structures */
37
38/** @} */
39
40
41typedef enum DBGDIGGEROS2VER
42{
43 DBGDIGGEROS2VER_UNKNOWN,
44 DBGDIGGEROS2VER_1_x,
45 DBGDIGGEROS2VER_2_x,
46 DBGDIGGEROS2VER_3_0,
47 DBGDIGGEROS2VER_4_0,
48 DBGDIGGEROS2VER_4_5
49} DBGDIGGEROS2VER;
50
51/**
52 * OS/2 guest OS digger instance data.
53 */
54typedef struct DBGDIGGEROS2
55{
56 /** Whether the information is valid or not.
57 * (For fending off illegal interface method calls.) */
58 bool fValid;
59 /** 32-bit (true) or 16-bit (false) */
60 bool f32Bit;
61
62 /** The OS/2 guest version. */
63 DBGDIGGEROS2VER enmVer;
64 uint8_t OS2MajorVersion;
65 uint8_t OS2MinorVersion;
66
67 /** Guest's Global Info Segment selector. */
68 uint16_t selGIS;
69
70} DBGDIGGEROS2;
71/** Pointer to the OS/2 guest OS digger instance data. */
72typedef DBGDIGGEROS2 *PDBGDIGGEROS2;
73
74
75/*********************************************************************************************************************************
76* Defined Constants And Macros *
77*********************************************************************************************************************************/
78/** The 'SAS ' signature. */
79#define DIG_OS2_SAS_SIG RT_MAKE_U32_FROM_U8('S','A','S',' ')
80
81/** OS/2Warp on little endian ASCII systems. */
82#define DIG_OS2_MOD_TAG UINT64_C(0x43532f3257617270)
83
84
85/*********************************************************************************************************************************
86* Internal Functions *
87*********************************************************************************************************************************/
88static DECLCALLBACK(int) dbgDiggerOS2Init(PUVM pUVM, void *pvData);
89
90
91/*********************************************************************************************************************************
92* Global Variables *
93*********************************************************************************************************************************/
94
95
96/**
97 * Process a PE image found in guest memory.
98 *
99 * @param pThis The instance data.
100 * @param pUVM The user mode VM handle.
101 * @param pszName The image name.
102 * @param pImageAddr The image address.
103 * @param cbImage The size of the image.
104 * @param pbBuf Scratch buffer containing the first
105 * RT_MIN(cbBuf, cbImage) bytes of the image.
106 * @param cbBuf The scratch buffer size.
107 */
108static void dbgDiggerOS2ProcessImage(PDBGDIGGEROS2 pThis, PUVM pUVM, const char *pszName,
109 PCDBGFADDRESS pImageAddr, uint32_t cbImage,
110 uint8_t *pbBuf, size_t cbBuf)
111{
112 LogFlow(("DigOS2: %RGp %#x %s\n", pImageAddr->FlatPtr, cbImage, pszName));
113
114 /* To be implemented.*/
115}
116
117
118/**
119 * @copydoc DBGFOSREG::pfnQueryInterface
120 */
121static DECLCALLBACK(void *) dbgDiggerOS2QueryInterface(PUVM pUVM, void *pvData, DBGFOSINTERFACE enmIf)
122{
123 return NULL;
124}
125
126
127/**
128 * @copydoc DBGFOSREG::pfnQueryVersion
129 */
130static DECLCALLBACK(int) dbgDiggerOS2QueryVersion(PUVM pUVM, void *pvData, char *pszVersion, size_t cchVersion)
131{
132 PDBGDIGGEROS2 pThis = (PDBGDIGGEROS2)pvData;
133 Assert(pThis->fValid);
134 char *achOS2ProductType[32];
135 char *pszOS2ProductType = (char *)achOS2ProductType;
136
137 if (pThis->OS2MajorVersion == 10)
138 {
139 RTStrPrintf(pszOS2ProductType, sizeof(achOS2ProductType), "OS/2 1.%02d", pThis->OS2MinorVersion);
140 pThis->enmVer = DBGDIGGEROS2VER_1_x;
141 }
142 else if (pThis->OS2MajorVersion == 20)
143 {
144 if (pThis->OS2MinorVersion < 30)
145 {
146 RTStrPrintf(pszOS2ProductType, sizeof(achOS2ProductType), "OS/2 2.%02d", pThis->OS2MinorVersion);
147 pThis->enmVer = DBGDIGGEROS2VER_2_x;
148 }
149 else if (pThis->OS2MinorVersion < 40)
150 {
151 RTStrPrintf(pszOS2ProductType, sizeof(achOS2ProductType), "OS/2 Warp");
152 pThis->enmVer = DBGDIGGEROS2VER_3_0;
153 }
154 else if (pThis->OS2MinorVersion == 40)
155 {
156 RTStrPrintf(pszOS2ProductType, sizeof(achOS2ProductType), "OS/2 Warp 4");
157 pThis->enmVer = DBGDIGGEROS2VER_4_0;
158 }
159 else
160 {
161 RTStrPrintf(pszOS2ProductType, sizeof(achOS2ProductType), "OS/2 Warp %d.%d",
162 pThis->OS2MinorVersion / 10, pThis->OS2MinorVersion % 10);
163 pThis->enmVer = DBGDIGGEROS2VER_4_5;
164 }
165 }
166 RTStrPrintf(pszVersion, cchVersion, "%u.%u (%s)", pThis->OS2MajorVersion, pThis->OS2MinorVersion, pszOS2ProductType);
167 return VINF_SUCCESS;
168}
169
170
171/**
172 * @copydoc DBGFOSREG::pfnTerm
173 */
174static DECLCALLBACK(void) dbgDiggerOS2Term(PUVM pUVM, void *pvData)
175{
176 PDBGDIGGEROS2 pThis = (PDBGDIGGEROS2)pvData;
177 Assert(pThis->fValid);
178
179 pThis->fValid = false;
180}
181
182
183/**
184 * @copydoc DBGFOSREG::pfnRefresh
185 */
186static DECLCALLBACK(int) dbgDiggerOS2Refresh(PUVM pUVM, void *pvData)
187{
188 PDBGDIGGEROS2 pThis = (PDBGDIGGEROS2)pvData;
189 NOREF(pThis);
190 Assert(pThis->fValid);
191
192 /*
193 * For now we'll flush and reload everything.
194 */
195 RTDBGAS hDbgAs = DBGFR3AsResolveAndRetain(pUVM, DBGF_AS_KERNEL);
196 if (hDbgAs != NIL_RTDBGAS)
197 {
198 uint32_t iMod = RTDbgAsModuleCount(hDbgAs);
199 while (iMod-- > 0)
200 {
201 RTDBGMOD hMod = RTDbgAsModuleByIndex(hDbgAs, iMod);
202 if (hMod != NIL_RTDBGMOD)
203 {
204 if (RTDbgModGetTag(hMod) == DIG_OS2_MOD_TAG)
205 {
206 int rc = RTDbgAsModuleUnlink(hDbgAs, hMod);
207 AssertRC(rc);
208 }
209 RTDbgModRelease(hMod);
210 }
211 }
212 RTDbgAsRelease(hDbgAs);
213 }
214
215 dbgDiggerOS2Term(pUVM, pvData);
216 return dbgDiggerOS2Init(pUVM, pvData);
217}
218
219
220/**
221 * @copydoc DBGFOSREG::pfnInit
222 */
223static DECLCALLBACK(int) dbgDiggerOS2Init(PUVM pUVM, void *pvData)
224{
225 PDBGDIGGEROS2 pThis = (PDBGDIGGEROS2)pvData;
226 Assert(!pThis->fValid);
227
228 union
229 {
230 uint8_t au8[0x2000];
231 uint16_t au16[0x2000/2];
232 uint32_t au32[0x2000/4];
233 RTUTF16 wsz[0x2000/2];
234 } u;
235 DBGFADDRESS Addr;
236 int rc;
237
238 /*
239 * Determine the OS/2 version.
240 */
241 do {
242 /* Version info is at GIS:15h (major/minor/revision). */
243 rc = DBGFR3AddrFromSelOff(pUVM, 0 /*idCpu*/, &Addr, pThis->selGIS, 0x15);
244 if (RT_FAILURE(rc))
245 break;
246 rc = DBGFR3MemRead(pUVM, 0 /*idCpu*/, &Addr, u.au32, sizeof(uint32_t));
247 if (RT_FAILURE(rc))
248 break;
249
250 pThis->OS2MajorVersion = u.au8[0];
251 pThis->OS2MinorVersion = u.au8[1];
252
253 pThis->fValid = true;
254 return VINF_SUCCESS;
255 } while (0);
256 return VERR_NOT_SUPPORTED;
257}
258
259
260/**
261 * @copydoc DBGFOSREG::pfnProbe
262 */
263static DECLCALLBACK(bool) dbgDiggerOS2Probe(PUVM pUVM, void *pvData)
264{
265 PDBGDIGGEROS2 pThis = (PDBGDIGGEROS2)pvData;
266 DBGFADDRESS Addr;
267 int rc;
268 uint16_t offInfo;
269 union
270 {
271 uint8_t au8[8192];
272 uint16_t au16[8192/2];
273 uint32_t au32[8192/4];
274 RTUTF16 wsz[8192/2];
275 } u;
276
277 /*
278 * If the DWORD at 70:0 contains 'SAS ' it's quite unlikely that this wouldn't be OS/2.
279 * Note: The SAS layout is similar between 16-bit and 32-bit OS/2, but not identical.
280 * 32-bit OS/2 will have the flat kernel data selector at SAS:06. The selector is 168h
281 * or similar. For 16-bit OS/2 the field contains a table offset into the SAS which will
282 * be much smaller. Fun fact: The global infoseg selector in the SAS is bimodal in 16-bit
283 * OS/2 and will work in real mode as well.
284 */
285 do {
286 rc = DBGFR3AddrFromSelOff(pUVM, 0 /*idCpu*/, &Addr, 0x70, 0x00);
287 if (RT_FAILURE(rc))
288 break;
289 rc = DBGFR3MemRead(pUVM, 0 /*idCpu*/, &Addr, u.au32, 256);
290 if (RT_FAILURE(rc))
291 break;
292 if (u.au32[0] != DIG_OS2_SAS_SIG)
293 break;
294
295 /* This sure looks like OS/2, but a bit of paranoia won't hurt. */
296 if (u.au16[2] >= u.au16[4])
297 break;
298
299 /* If 4th word is bigger than 5th, it's the flat kernel mode selector. */
300 if (u.au16[3] > u.au16[4])
301 pThis->f32Bit = true;
302
303 /* Offset into info table is either at SAS:14h or SAS:16h. */
304 if (pThis->f32Bit)
305 offInfo = u.au16[0x14/2];
306 else
307 offInfo = u.au16[0x16/2];
308
309 /* The global infoseg selector is the first entry in the info table. */
310 pThis->selGIS = u.au16[offInfo/2];
311 return true;
312 } while (0);
313
314 return false;
315}
316
317
318/**
319 * @copydoc DBGFOSREG::pfnDestruct
320 */
321static DECLCALLBACK(void) dbgDiggerOS2Destruct(PUVM pUVM, void *pvData)
322{
323
324}
325
326
327/**
328 * @copydoc DBGFOSREG::pfnConstruct
329 */
330static DECLCALLBACK(int) dbgDiggerOS2Construct(PUVM pUVM, void *pvData)
331{
332 PDBGDIGGEROS2 pThis = (PDBGDIGGEROS2)pvData;
333 pThis->fValid = false;
334 pThis->f32Bit = false;
335 pThis->enmVer = DBGDIGGEROS2VER_UNKNOWN;
336 return VINF_SUCCESS;
337}
338
339
340const DBGFOSREG g_DBGDiggerOS2 =
341{
342 /* .u32Magic = */ DBGFOSREG_MAGIC,
343 /* .fFlags = */ 0,
344 /* .cbData = */ sizeof(DBGDIGGEROS2),
345 /* .szName = */ "OS/2",
346 /* .pfnConstruct = */ dbgDiggerOS2Construct,
347 /* .pfnDestruct = */ dbgDiggerOS2Destruct,
348 /* .pfnProbe = */ dbgDiggerOS2Probe,
349 /* .pfnInit = */ dbgDiggerOS2Init,
350 /* .pfnRefresh = */ dbgDiggerOS2Refresh,
351 /* .pfnTerm = */ dbgDiggerOS2Term,
352 /* .pfnQueryVersion = */ dbgDiggerOS2QueryVersion,
353 /* .pfnQueryInterface = */ dbgDiggerOS2QueryInterface,
354 /* .u32EndMagic = */ DBGFOSREG_MAGIC
355};
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette