2 * 386-specific Win32 dll<->dll snooping functions
4 * Copyright 1998 Marcus Meissner
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.
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.
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
22 #include "wine/port.h"
29 #include "wine/debug.h"
30 #include "wine/exception.h"
32 #include "ntdll_misc.h"
34 WINE_DEFAULT_DEBUG_CHANNEL(snoop);
35 WINE_DECLARE_DEBUG_CHANNEL(seh);
37 static WINE_EXCEPTION_FILTER(page_fault)
39 if (GetExceptionCode() == EXCEPTION_ACCESS_VIOLATION ||
40 GetExceptionCode() == EXCEPTION_PRIV_INSTRUCTION)
41 return EXCEPTION_EXECUTE_HANDLER;
42 return EXCEPTION_CONTINUE_SEARCH;
45 extern const char **debug_snoop_excludelist;
46 extern const char **debug_snoop_includelist;
50 extern void WINAPI SNOOP_Entry();
51 extern void WINAPI SNOOP_Return();
55 typedef struct tagSNOOP_FUN {
57 BYTE lcall; /* 0xe8 call snoopentry (relative) */
58 /* NOTE: If you move snoopentry OR nrofargs fix the relative offset
61 DWORD snoopentry; /* SNOOP_Entry relative */
68 typedef struct tagSNOOP_DLL {
73 struct tagSNOOP_DLL *next;
77 typedef struct tagSNOOP_RETURNENTRY {
79 BYTE lcall; /* 0xe8 call snoopret relative*/
80 /* NOTE: If you move snoopret OR origreturn fix the relative offset
83 DWORD snoopret; /* SNOOP_Ret relative */
89 DWORD *args; /* saved args across a stdcall */
92 typedef struct tagSNOOP_RETURNENTRIES {
93 SNOOP_RETURNENTRY entry[4092/sizeof(SNOOP_RETURNENTRY)];
94 struct tagSNOOP_RETURNENTRIES *next;
95 } SNOOP_RETURNENTRIES;
99 static SNOOP_DLL *firstdll = NULL;
100 static SNOOP_RETURNENTRIES *firstrets = NULL;
102 /***********************************************************************
103 * SNOOP_ShowDebugmsgSnoop
105 * Simple function to decide if a particular debugging message is
108 int SNOOP_ShowDebugmsgSnoop(const char *dll, int ord, const char *fname) {
110 if(debug_snoop_excludelist || debug_snoop_includelist) {
111 const char **listitem;
113 int len, len2, itemlen, show;
115 if(debug_snoop_excludelist) {
117 listitem = debug_snoop_excludelist;
120 listitem = debug_snoop_includelist;
124 sprintf(buf, "%s.%d", dll, ord);
126 for(; *listitem; listitem++) {
127 itemlen = strlen(*listitem);
128 if((itemlen == len && !strncasecmp(*listitem, buf, len)) ||
129 (itemlen == len2 && !strncasecmp(*listitem, buf, len2)) ||
130 !strcasecmp(*listitem, fname)) {
141 SNOOP_RegisterDLL(HMODULE hmod,LPCSTR name,DWORD ordbase,DWORD nrofordinals) {
142 SNOOP_DLL **dll = &(firstdll);
147 TRACE("hmod=%p, name=%s, ordbase=%ld, nrofordinals=%ld\n",
148 hmod, name, ordbase, nrofordinals);
150 if (!TRACE_ON(snoop)) return;
152 if ((*dll)->hmod == hmod)
154 /* another dll, loaded at the same address */
156 size = (*dll)->nrofordinals * sizeof(SNOOP_FUN);
157 NtFreeVirtualMemory(GetCurrentProcess(), &addr, &size, MEM_RELEASE);
160 dll = &((*dll)->next);
162 *dll = RtlReAllocateHeap(ntdll_get_process_heap(),
163 HEAP_ZERO_MEMORY, *dll,
164 sizeof(SNOOP_DLL) + strlen(name));
166 (*dll)->ordbase = ordbase;
167 (*dll)->nrofordinals = nrofordinals;
168 strcpy( (*dll)->name, name );
169 if ((s=strrchr((*dll)->name,'.')))
171 size = nrofordinals * sizeof(SNOOP_FUN);
172 NtAllocateVirtualMemory(GetCurrentProcess(), &addr, NULL, &size,
173 MEM_COMMIT | MEM_RESERVE, PAGE_EXECUTE_READWRITE);
175 RtlFreeHeap(ntdll_get_process_heap(),0,*dll);
176 FIXME("out of memory\n");
180 memset((*dll)->funs,0,size);
184 SNOOP_GetProcAddress(HMODULE hmod,LPCSTR name,DWORD ordinal,FARPROC origfun) {
185 SNOOP_DLL *dll = firstdll;
187 IMAGE_SECTION_HEADER *sec;
189 if (!TRACE_ON(snoop)) return origfun;
190 if (!*(LPBYTE)origfun) /* 0x00 is an imposs. opcode, poss. dataref. */
193 sec = RtlImageRvaToSection( RtlImageNtHeader(hmod), hmod, (char *)origfun - (char *)hmod );
195 if (!sec || !(sec->Characteristics & IMAGE_SCN_CNT_CODE))
196 return origfun; /* most likely a data reference */
199 if (hmod == dll->hmod)
203 if (!dll) /* probably internal */
205 if (!SNOOP_ShowDebugmsgSnoop(dll->name,ordinal,name))
207 assert(ordinal < dll->nrofordinals);
208 fun = dll->funs+ordinal;
211 fun->name = RtlAllocateHeap(ntdll_get_process_heap(),0,strlen(name)+1);
212 strcpy( fun->name, name );
214 /* NOTE: origreturn struct member MUST come directly after snoopentry */
215 fun->snoopentry = (char*)SNOOP_Entry-((char*)(&fun->nrofargs));
216 fun->origfun = origfun;
219 return (FARPROC)&(fun->lcall);
222 static void SNOOP_PrintArg(DWORD x)
227 if (!HIWORD(x) || TRACE_ON(seh)) return; /* trivial reject to avoid faults */
234 if (s[i]<0x20) {nostring=1;break;}
235 if (s[i]>=0x80) {nostring=1;break;}
238 if (!nostring && i > 5)
239 DPRINTF(" %s",debugstr_an((LPSTR)x,i));
240 else /* try unicode */
246 if (s[i]<0x20) {nostring=1;break;}
247 if (s[i]>0x100) {nostring=1;break;}
250 if (!nostring && i > 5) DPRINTF(" %s",debugstr_wn((LPWSTR)x,i));
259 #define CALLER1REF (*(DWORD*)context->Esp)
261 void WINAPI SNOOP_DoEntry( CONTEXT86 *context )
263 DWORD ordinal=0,entry = context->Eip - 5;
264 SNOOP_DLL *dll = firstdll;
265 SNOOP_FUN *fun = NULL;
266 SNOOP_RETURNENTRIES **rets = &firstrets;
267 SNOOP_RETURNENTRY *ret;
271 if ( ((char*)entry>=(char*)dll->funs) &&
272 ((char*)entry<=(char*)(dll->funs+dll->nrofordinals))
274 fun = (SNOOP_FUN*)entry;
275 ordinal = fun-dll->funs;
281 FIXME("entrypoint 0x%08lx not found\n",entry);
284 /* guess cdecl ... */
285 if (fun->nrofargs<0) {
286 /* Typical cdecl return frame is:
288 * which has (for xxxxxxxx up to 255 the opcode "83 C4 xx".
289 * (after that 81 C2 xx xx xx xx)
291 LPBYTE reteip = (LPBYTE)CALLER1REF;
294 if ((reteip[0]==0x83)&&(reteip[1]==0xc4))
295 fun->nrofargs=reteip[2]/4;
301 for (i=0;i<sizeof((*rets)->entry)/sizeof((*rets)->entry[0]);i++)
302 if (!(*rets)->entry[i].origreturn)
304 if (i!=sizeof((*rets)->entry)/sizeof((*rets)->entry[0]))
306 rets = &((*rets)->next);
312 NtAllocateVirtualMemory(GetCurrentProcess(), &addr, NULL, &size,
313 MEM_COMMIT | MEM_RESERVE,
314 PAGE_EXECUTE_READWRITE);
317 memset(*rets,0,4096);
318 i = 0; /* entry 0 is free */
320 ret = &((*rets)->entry[i]);
322 /* NOTE: origreturn struct member MUST come directly after snoopret */
323 ret->snoopret = ((char*)SNOOP_Return)-(char*)(&ret->origreturn);
324 ret->origreturn = (FARPROC)CALLER1REF;
325 CALLER1REF = (DWORD)&ret->lcall;
328 ret->ordinal = ordinal;
329 ret->origESP = context->Esp;
331 context->Eip = (DWORD)fun->origfun;
333 DPRINTF("%04lx:CALL %s.%ld: %s(",GetCurrentThreadId(),dll->name,dll->ordbase+ordinal,fun->name);
334 if (fun->nrofargs>0) {
335 max = fun->nrofargs; if (max>16) max=16;
338 SNOOP_PrintArg(*(DWORD*)(context->Esp + 4 + sizeof(DWORD)*i));
339 if (i<fun->nrofargs-1) DPRINTF(",");
341 if (max!=fun->nrofargs)
343 } else if (fun->nrofargs<0) {
344 DPRINTF("<unknown, check return>");
345 ret->args = RtlAllocateHeap(ntdll_get_process_heap(),
347 memcpy(ret->args,(LPBYTE)(context->Esp + 4),sizeof(DWORD)*16);
349 DPRINTF(") ret=%08lx\n",(DWORD)ret->origreturn);
353 void WINAPI SNOOP_DoReturn( CONTEXT86 *context )
355 SNOOP_RETURNENTRY *ret = (SNOOP_RETURNENTRY*)(context->Eip - 5);
357 /* We haven't found out the nrofargs yet. If we called a cdecl
358 * function it is too late anyway and we can just set '0' (which
359 * will be the difference between orig and current ESP
360 * If stdcall -> everything ok.
362 if (ret->dll->funs[ret->ordinal].nrofargs<0)
363 ret->dll->funs[ret->ordinal].nrofargs=(context->Esp - ret->origESP-4)/4;
364 context->Eip = (DWORD)ret->origreturn;
368 DPRINTF("%04lx:RET %s.%ld: %s(",
369 GetCurrentThreadId(),
370 ret->dll->name,ret->dll->ordbase+ret->ordinal,ret->dll->funs[ret->ordinal].name);
371 max = ret->dll->funs[ret->ordinal].nrofargs;
376 SNOOP_PrintArg(ret->args[i]);
377 if (i<max-1) DPRINTF(",");
379 DPRINTF(") retval = %08lx ret=%08lx\n",
380 context->Eax,(DWORD)ret->origreturn );
381 RtlFreeHeap(ntdll_get_process_heap(),0,ret->args);
384 DPRINTF("%04lx:RET %s.%ld: %s() retval = %08lx ret=%08lx\n",
385 GetCurrentThreadId(),
386 ret->dll->name,ret->dll->ordbase+ret->ordinal,ret->dll->funs[ret->ordinal].name,
387 context->Eax, (DWORD)ret->origreturn);
388 ret->origreturn = NULL; /* mark as empty */
391 /* assembly wrappers that save the context */
392 __ASM_GLOBAL_FUNC( SNOOP_Entry,
393 "call " __ASM_NAME("__wine_call_from_32_regs") "\n\t"
394 ".long " __ASM_NAME("SNOOP_DoEntry") ",0" );
395 __ASM_GLOBAL_FUNC( SNOOP_Return,
396 "call " __ASM_NAME("__wine_call_from_32_regs") "\n\t"
397 ".long " __ASM_NAME("SNOOP_DoReturn") ",0" );
399 #else /* !__i386__ */
400 void SNOOP_RegisterDLL(HMODULE hmod,LPCSTR name,DWORD nrofordinals, DWORD dw) {
401 if (!TRACE_ON(snoop)) return;
402 FIXME("snooping works only on i386 for now.\n");
405 FARPROC SNOOP_GetProcAddress(HMODULE hmod,LPCSTR name,DWORD ordinal,FARPROC origfun) {
408 #endif /* !__i386__ */