push 955563f995be8b0942dbb757ceb5b3a4c8ccafbf
[wine/hacks.git] / dlls / ntdll / relay.c
blob0f74c410846461971f9d5f7d14fdfa952497eb16
1 /*
2 * Win32 relay and snoop functions
4 * Copyright 1997 Alexandre Julliard
5 * Copyright 1998 Marcus Meissner
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "config.h"
23 #include "wine/port.h"
25 #include <assert.h>
26 #include <string.h>
27 #include <stdarg.h>
28 #include <stdio.h>
30 #include "ntstatus.h"
31 #define WIN32_NO_STATUS
32 #include "windef.h"
33 #include "winternl.h"
34 #include "wine/exception.h"
35 #include "ntdll_misc.h"
36 #include "wine/unicode.h"
37 #include "wine/debug.h"
39 WINE_DEFAULT_DEBUG_CHANNEL(relay);
41 #if defined(__i386__) || defined(__x86_64__)
43 struct relay_descr /* descriptor for a module */
45 void *magic; /* signature */
46 void *relay_call; /* functions to call from relay thunks */
47 void *relay_call_regs;
48 void *private; /* reserved for the relay code private data */
49 const char *entry_point_base; /* base address of entry point thunks */
50 const unsigned int *entry_point_offsets; /* offsets of entry points thunks */
51 const unsigned int *arg_types; /* table of argument types for all entry points */
54 #define RELAY_DESCR_MAGIC ((void *)0xdeb90001)
56 /* private data built at dll load time */
58 struct relay_entry_point
60 void *orig_func; /* original entry point function */
61 const char *name; /* function name (if any) */
64 struct relay_private_data
66 HMODULE module; /* module handle of this dll */
67 unsigned int base; /* ordinal base */
68 char dllname[40]; /* dll name (without .dll extension) */
69 struct relay_entry_point entry_points[1]; /* list of dll entry points */
72 static const WCHAR **debug_relay_excludelist;
73 static const WCHAR **debug_relay_includelist;
74 static const WCHAR **debug_snoop_excludelist;
75 static const WCHAR **debug_snoop_includelist;
76 static const WCHAR **debug_from_relay_excludelist;
77 static const WCHAR **debug_from_relay_includelist;
78 static const WCHAR **debug_from_snoop_excludelist;
79 static const WCHAR **debug_from_snoop_includelist;
81 static BOOL init_done;
83 /* compare an ASCII and a Unicode string without depending on the current codepage */
84 static inline int strcmpAW( const char *strA, const WCHAR *strW )
86 while (*strA && ((unsigned char)*strA == *strW)) { strA++; strW++; }
87 return (unsigned char)*strA - *strW;
90 /* compare an ASCII and a Unicode string without depending on the current codepage */
91 static inline int strncmpiAW( const char *strA, const WCHAR *strW, int n )
93 int ret = 0;
94 for ( ; n > 0; n--, strA++, strW++)
95 if ((ret = toupperW((unsigned char)*strA) - toupperW(*strW)) || !*strA) break;
96 return ret;
99 /***********************************************************************
100 * build_list
102 * Build a function list from a ';'-separated string.
104 static const WCHAR **build_list( const WCHAR *buffer )
106 int count = 1;
107 const WCHAR *p = buffer;
108 const WCHAR **ret;
110 while ((p = strchrW( p, ';' )))
112 count++;
113 p++;
115 /* allocate count+1 pointers, plus the space for a copy of the string */
116 if ((ret = RtlAllocateHeap( GetProcessHeap(), 0,
117 (count+1) * sizeof(WCHAR*) + (strlenW(buffer)+1) * sizeof(WCHAR) )))
119 WCHAR *str = (WCHAR *)(ret + count + 1);
120 WCHAR *p = str;
122 strcpyW( str, buffer );
123 count = 0;
124 for (;;)
126 ret[count++] = p;
127 if (!(p = strchrW( p, ';' ))) break;
128 *p++ = 0;
130 ret[count++] = NULL;
132 return ret;
135 /***********************************************************************
136 * load_list_value
138 * Load a function list from a registry value.
140 static const WCHAR **load_list( HKEY hkey, const WCHAR *value )
142 char initial_buffer[4096];
143 char *buffer = initial_buffer;
144 DWORD count;
145 NTSTATUS status;
146 UNICODE_STRING name;
147 const WCHAR **list = NULL;
149 RtlInitUnicodeString( &name, value );
150 status = NtQueryValueKey( hkey, &name, KeyValuePartialInformation, buffer, sizeof(buffer), &count );
151 if (status == STATUS_BUFFER_OVERFLOW)
153 buffer = RtlAllocateHeap( GetProcessHeap(), 0, count );
154 status = NtQueryValueKey( hkey, &name, KeyValuePartialInformation, buffer, count, &count );
156 if (status == STATUS_SUCCESS)
158 WCHAR *str = (WCHAR *)((KEY_VALUE_PARTIAL_INFORMATION *)buffer)->Data;
159 list = build_list( str );
160 if (list) TRACE( "%s = %s\n", debugstr_w(value), debugstr_w(str) );
163 if (buffer != initial_buffer) RtlFreeHeap( GetProcessHeap(), 0, buffer );
164 return list;
167 /***********************************************************************
168 * init_debug_lists
170 * Build the relay include/exclude function lists.
172 static void init_debug_lists(void)
174 OBJECT_ATTRIBUTES attr;
175 UNICODE_STRING name;
176 HANDLE root, hkey;
177 static const WCHAR configW[] = {'S','o','f','t','w','a','r','e','\\',
178 'W','i','n','e','\\',
179 'D','e','b','u','g',0};
180 static const WCHAR RelayIncludeW[] = {'R','e','l','a','y','I','n','c','l','u','d','e',0};
181 static const WCHAR RelayExcludeW[] = {'R','e','l','a','y','E','x','c','l','u','d','e',0};
182 static const WCHAR SnoopIncludeW[] = {'S','n','o','o','p','I','n','c','l','u','d','e',0};
183 static const WCHAR SnoopExcludeW[] = {'S','n','o','o','p','E','x','c','l','u','d','e',0};
184 static const WCHAR RelayFromIncludeW[] = {'R','e','l','a','y','F','r','o','m','I','n','c','l','u','d','e',0};
185 static const WCHAR RelayFromExcludeW[] = {'R','e','l','a','y','F','r','o','m','E','x','c','l','u','d','e',0};
186 static const WCHAR SnoopFromIncludeW[] = {'S','n','o','o','p','F','r','o','m','I','n','c','l','u','d','e',0};
187 static const WCHAR SnoopFromExcludeW[] = {'S','n','o','o','p','F','r','o','m','E','x','c','l','u','d','e',0};
189 if (init_done) return;
190 init_done = TRUE;
192 RtlOpenCurrentUser( KEY_ALL_ACCESS, &root );
193 attr.Length = sizeof(attr);
194 attr.RootDirectory = root;
195 attr.ObjectName = &name;
196 attr.Attributes = 0;
197 attr.SecurityDescriptor = NULL;
198 attr.SecurityQualityOfService = NULL;
199 RtlInitUnicodeString( &name, configW );
201 /* @@ Wine registry key: HKCU\Software\Wine\Debug */
202 if (NtOpenKey( &hkey, KEY_ALL_ACCESS, &attr )) hkey = 0;
203 NtClose( root );
204 if (!hkey) return;
206 debug_relay_includelist = load_list( hkey, RelayIncludeW );
207 debug_relay_excludelist = load_list( hkey, RelayExcludeW );
208 debug_snoop_includelist = load_list( hkey, SnoopIncludeW );
209 debug_snoop_excludelist = load_list( hkey, SnoopExcludeW );
210 debug_from_relay_includelist = load_list( hkey, RelayFromIncludeW );
211 debug_from_relay_excludelist = load_list( hkey, RelayFromExcludeW );
212 debug_from_snoop_includelist = load_list( hkey, SnoopFromIncludeW );
213 debug_from_snoop_excludelist = load_list( hkey, SnoopFromExcludeW );
215 NtClose( hkey );
219 /***********************************************************************
220 * check_list
222 * Check if a given module and function is in the list.
224 static BOOL check_list( const char *module, int ordinal, const char *func, const WCHAR *const *list )
226 char ord_str[10];
228 sprintf( ord_str, "%d", ordinal );
229 for(; *list; list++)
231 const WCHAR *p = strrchrW( *list, '.' );
232 if (p && p > *list) /* check module and function */
234 int len = p - *list;
235 if (strncmpiAW( module, *list, len-1 ) || module[len]) continue;
236 if (p[1] == '*' && !p[2]) return TRUE;
237 if (!strcmpAW( ord_str, p + 1 )) return TRUE;
238 if (func && !strcmpAW( func, p + 1 )) return TRUE;
240 else /* function only */
242 if (func && !strcmpAW( func, *list )) return TRUE;
245 return FALSE;
249 /***********************************************************************
250 * check_relay_include
252 * Check if a given function must be included in the relay output.
254 static BOOL check_relay_include( const char *module, int ordinal, const char *func )
256 if (debug_relay_excludelist && check_list( module, ordinal, func, debug_relay_excludelist ))
257 return FALSE;
258 if (debug_relay_includelist && !check_list( module, ordinal, func, debug_relay_includelist ))
259 return FALSE;
260 return TRUE;
263 /***********************************************************************
264 * check_from_module
266 * Check if calls from a given module must be included in the relay/snoop output,
267 * given the exclusion and inclusion lists.
269 static BOOL check_from_module( const WCHAR **includelist, const WCHAR **excludelist, const WCHAR *module )
271 static const WCHAR dllW[] = {'.','d','l','l',0 };
272 const WCHAR **listitem;
273 BOOL show;
275 if (!module) return TRUE;
276 if (!includelist && !excludelist) return TRUE;
277 if (excludelist)
279 show = TRUE;
280 listitem = excludelist;
282 else
284 show = FALSE;
285 listitem = includelist;
287 for(; *listitem; listitem++)
289 int len;
291 if (!strcmpiW( *listitem, module )) return !show;
292 len = strlenW( *listitem );
293 if (!strncmpiW( *listitem, module, len ) && !strcmpiW( module + len, dllW ))
294 return !show;
296 return show;
299 /***********************************************************************
300 * RELAY_PrintArgs
302 static inline void RELAY_PrintArgs( const INT_PTR *args, int nb_args, unsigned int typemask )
304 while (nb_args--)
306 if ((typemask & 3) && HIWORD(*args))
308 if (typemask & 2)
309 DPRINTF( "%08lx %s", *args, debugstr_w((LPCWSTR)*args) );
310 else
311 DPRINTF( "%08lx %s", *args, debugstr_a((LPCSTR)*args) );
313 else DPRINTF( "%08lx", *args );
314 if (nb_args) DPRINTF( "," );
315 args++;
316 typemask >>= 2;
320 extern LONGLONG CDECL call_entry_point( void *func, int nb_args, const INT_PTR *args );
321 #ifdef __i386__
322 __ASM_GLOBAL_FUNC( call_entry_point,
323 "\tpushl %ebp\n"
324 "\tmovl %esp,%ebp\n"
325 "\tpushl %esi\n"
326 "\tpushl %edi\n"
327 "\tmovl 12(%ebp),%edx\n"
328 "\tshll $2,%edx\n"
329 "\tjz 1f\n"
330 "\tsubl %edx,%esp\n"
331 "\tandl $~15,%esp\n"
332 "\tmovl 12(%ebp),%ecx\n"
333 "\tmovl 16(%ebp),%esi\n"
334 "\tmovl %esp,%edi\n"
335 "\tcld\n"
336 "\trep; movsl\n"
337 "1:\tcall *8(%ebp)\n"
338 "\tleal -8(%ebp),%esp\n"
339 "\tpopl %edi\n"
340 "\tpopl %esi\n"
341 "\tpopl %ebp\n"
342 "\tret" )
343 #else
344 __ASM_GLOBAL_FUNC( call_entry_point,
345 "pushq %rbp\n\t"
346 ".cfi_adjust_cfa_offset 8\n\t"
347 ".cfi_rel_offset %rbp,0\n\t"
348 "movq %rsp,%rbp\n\t"
349 ".cfi_def_cfa_register %rbp\n\t"
350 "pushq %rsi\n\t"
351 ".cfi_rel_offset %rsi,-8\n\t"
352 "pushq %rdi\n\t"
353 ".cfi_rel_offset %rdi,-16\n\t"
354 "movq %rcx,%rax\n\t"
355 "movq $4,%rcx\n\t"
356 "cmp %rcx,%rdx\n\t"
357 "cmovgq %rdx,%rcx\n\t"
358 "leaq 0(,%rcx,8),%rdx\n\t"
359 "subq %rdx,%rsp\n\t"
360 "andq $~15,%rsp\n\t"
361 "movq %rsp,%rdi\n\t"
362 "movq %r8,%rsi\n\t"
363 "rep; movsq\n\t"
364 "movq 0(%rsp),%rcx\n\t"
365 "movq 8(%rsp),%rdx\n\t"
366 "movq 16(%rsp),%r8\n\t"
367 "movq 24(%rsp),%r9\n\t"
368 "callq *%rax\n\t"
369 "leaq -16(%rbp),%rsp\n\t"
370 "popq %rdi\n\t"
371 ".cfi_same_value %rdi\n\t"
372 "popq %rsi\n\t"
373 ".cfi_same_value %rsi\n\t"
374 ".cfi_def_cfa_register %rsp\n\t"
375 "popq %rbp\n\t"
376 ".cfi_adjust_cfa_offset -8\n\t"
377 ".cfi_same_value %rbp\n\t"
378 "ret")
379 #endif
382 /***********************************************************************
383 * relay_call
385 * stack points to the return address, i.e. the first argument is stack[1].
387 static LONGLONG WINAPI relay_call( struct relay_descr *descr, unsigned int idx, const INT_PTR *stack )
389 LONGLONG ret;
390 WORD ordinal = LOWORD(idx);
391 BYTE nb_args = LOBYTE(HIWORD(idx));
392 BYTE flags = HIBYTE(HIWORD(idx));
393 struct relay_private_data *data = descr->private;
394 struct relay_entry_point *entry_point = data->entry_points + ordinal;
396 if (!TRACE_ON(relay))
397 ret = call_entry_point( entry_point->orig_func, nb_args, stack + 1 );
398 else
400 if (entry_point->name)
401 DPRINTF( "%04x:Call %s.%s(", GetCurrentThreadId(), data->dllname, entry_point->name );
402 else
403 DPRINTF( "%04x:Call %s.%u(", GetCurrentThreadId(), data->dllname, data->base + ordinal );
404 RELAY_PrintArgs( stack + 1, nb_args, descr->arg_types[ordinal] );
405 DPRINTF( ") ret=%08lx\n", stack[0] );
407 ret = call_entry_point( entry_point->orig_func, nb_args, stack + 1 );
409 if (entry_point->name)
410 DPRINTF( "%04x:Ret %s.%s()", GetCurrentThreadId(), data->dllname, entry_point->name );
411 else
412 DPRINTF( "%04x:Ret %s.%u()", GetCurrentThreadId(), data->dllname, data->base + ordinal );
414 if (flags & 1) /* 64-bit return value */
415 DPRINTF( " retval=%08x%08x ret=%08lx\n",
416 (UINT)(ret >> 32), (UINT)ret, stack[0] );
417 else
418 DPRINTF( " retval=%08lx ret=%08lx\n", (UINT_PTR)ret, stack[0] );
420 return ret;
424 /***********************************************************************
425 * relay_call_regs
427 #ifdef __i386__
428 void WINAPI __regs_relay_call_regs( struct relay_descr *descr, unsigned int idx,
429 unsigned int orig_eax, unsigned int ret_addr,
430 CONTEXT86 *context )
432 WORD ordinal = LOWORD(idx);
433 BYTE nb_args = LOBYTE(HIWORD(idx));
434 struct relay_private_data *data = descr->private;
435 struct relay_entry_point *entry_point = data->entry_points + ordinal;
436 BYTE *orig_func = entry_point->orig_func;
437 INT_PTR *args = (INT_PTR *)context->Esp;
438 INT_PTR args_copy[32];
440 /* restore the context to what it was before the relay thunk */
441 context->Eax = orig_eax;
442 context->Eip = ret_addr;
443 context->Esp += nb_args * sizeof(int);
445 if (TRACE_ON(relay))
447 if (entry_point->name)
448 DPRINTF( "%04x:Call %s.%s(", GetCurrentThreadId(), data->dllname, entry_point->name );
449 else
450 DPRINTF( "%04x:Call %s.%u(", GetCurrentThreadId(), data->dllname, data->base + ordinal );
451 RELAY_PrintArgs( args, nb_args, descr->arg_types[ordinal] );
452 DPRINTF( ") ret=%08x\n", ret_addr );
454 DPRINTF( "%04x: eax=%08x ebx=%08x ecx=%08x edx=%08x esi=%08x edi=%08x "
455 "ebp=%08x esp=%08x ds=%04x es=%04x fs=%04x gs=%04x flags=%08x\n",
456 GetCurrentThreadId(), context->Eax, context->Ebx, context->Ecx,
457 context->Edx, context->Esi, context->Edi, context->Ebp, context->Esp,
458 context->SegDs, context->SegEs, context->SegFs, context->SegGs, context->EFlags );
460 assert( orig_func[0] == 0x68 /* pushl func */ );
461 assert( orig_func[5] == 0x6a /* pushl args */ );
462 assert( orig_func[7] == 0xe8 /* call */ );
465 /* now call the real function */
467 memcpy( args_copy, args, nb_args * sizeof(args[0]) );
468 args_copy[nb_args++] = (INT_PTR)context; /* append context argument */
470 call_entry_point( orig_func + 12 + *(int *)(orig_func + 1), nb_args, args_copy );
473 if (TRACE_ON(relay))
475 if (entry_point->name)
476 DPRINTF( "%04x:Ret %s.%s() retval=%08x ret=%08x\n",
477 GetCurrentThreadId(), data->dllname, entry_point->name,
478 context->Eax, context->Eip );
479 else
480 DPRINTF( "%04x:Ret %s.%u() retval=%08x ret=%08x\n",
481 GetCurrentThreadId(), data->dllname, data->base + ordinal,
482 context->Eax, context->Eip );
483 DPRINTF( "%04x: eax=%08x ebx=%08x ecx=%08x edx=%08x esi=%08x edi=%08x "
484 "ebp=%08x esp=%08x ds=%04x es=%04x fs=%04x gs=%04x flags=%08x\n",
485 GetCurrentThreadId(), context->Eax, context->Ebx, context->Ecx,
486 context->Edx, context->Esi, context->Edi, context->Ebp, context->Esp,
487 context->SegDs, context->SegEs, context->SegFs, context->SegGs, context->EFlags );
490 extern void WINAPI relay_call_regs(void);
491 DEFINE_REGS_ENTRYPOINT( relay_call_regs, 4 )
493 #else /* __i386__ */
495 void WINAPI __regs_relay_call_regs( struct relay_descr *descr, INT_PTR idx,
496 INT_PTR *stack, CONTEXT *context )
498 WORD ordinal = LOWORD(idx);
499 BYTE nb_args = LOBYTE(HIWORD(idx));
500 struct relay_private_data *data = descr->private;
501 struct relay_entry_point *entry_point = data->entry_points + ordinal;
502 BYTE *orig_func = entry_point->orig_func;
503 INT_PTR *args = stack + 1;
504 INT_PTR args_copy[32];
506 /* restore the context to what it was before the relay thunk */
507 context->Rip = stack[0];
508 context->Rsp = (INT_PTR)args;
510 if (TRACE_ON(relay))
512 if (entry_point->name)
513 DPRINTF( "%04x:Call %s.%s(", GetCurrentThreadId(), data->dllname, entry_point->name );
514 else
515 DPRINTF( "%04x:Call %s.%u(", GetCurrentThreadId(), data->dllname, data->base + ordinal );
516 RELAY_PrintArgs( args, nb_args, descr->arg_types[ordinal] );
517 DPRINTF( ") ret=%08lx\n", context->Rip );
519 DPRINTF( "%04x: rax=%016lx rbx=%016lx rcx=%016lx rdx=%016lx rsi=%016lx rdi=%016lx rbp=%016lx rsp=%016lx\n",
520 GetCurrentThreadId(), context->Rax, context->Rbx, context->Rcx, context->Rdx,
521 context->Rsi, context->Rdi, context->Rbp, context->Rsp );
522 DPRINTF( "%04x: r8=%016lx r9=%016lx r10=%016lx r11=%016lx r12=%016lx r13=%016lx r14=%016lx r15=%016lx\n",
523 GetCurrentThreadId(), context->R8, context->R9, context->R10, context->R11,
524 context->R12, context->R13, context->R14, context->R15 );
526 assert( orig_func[17] == 0x48 /* leaq */ );
527 assert( orig_func[18] == 0x8d );
528 assert( orig_func[19] == 0x15 );
529 assert( orig_func[24] == 0xe8 /* call */ );
532 /* now call the real function */
534 memcpy( args_copy, args, nb_args * sizeof(args[0]) );
535 args_copy[nb_args++] = (INT_PTR)context; /* append context argument */
537 call_entry_point( orig_func + 24 + *(int *)(orig_func + 20), nb_args, args_copy );
540 if (TRACE_ON(relay))
542 if (entry_point->name)
543 DPRINTF( "%04x:Ret %s.%s() retval=%08lx ret=%08lx\n",
544 GetCurrentThreadId(), data->dllname, entry_point->name,
545 context->Rax, context->Rip );
546 else
547 DPRINTF( "%04x:Ret %s.%u() retval=%08lx ret=%08lx\n",
548 GetCurrentThreadId(), data->dllname, data->base + ordinal,
549 context->Rax, context->Rip );
550 DPRINTF( "%04x: rax=%016lx rbx=%016lx rcx=%016lx rdx=%016lx rsi=%016lx rdi=%016lx rbp=%016lx rsp=%016lx\n",
551 GetCurrentThreadId(), context->Rax, context->Rbx, context->Rcx, context->Rdx,
552 context->Rsi, context->Rdi, context->Rbp, context->Rsp );
553 DPRINTF( "%04x: r8=%016lx r9=%016lx r10=%016lx r11=%016lx r12=%016lx r13=%016lx r14=%016lx r15=%016lx\n",
554 GetCurrentThreadId(), context->R8, context->R9, context->R10, context->R11,
555 context->R12, context->R13, context->R14, context->R15 );
558 extern void WINAPI relay_call_regs(void);
559 DEFINE_REGS_ENTRYPOINT( relay_call_regs, 3 )
561 #endif /* __i386__ */
564 /***********************************************************************
565 * RELAY_GetProcAddress
567 * Return the proc address to use for a given function.
569 FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
570 DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user )
572 struct relay_private_data *data;
573 const struct relay_descr *descr = (const struct relay_descr *)((const char *)exports + exp_size);
575 if (descr->magic != RELAY_DESCR_MAGIC || !(data = descr->private)) return proc; /* no relay data */
576 if (!data->entry_points[ordinal].orig_func) return proc; /* not a relayed function */
577 if (check_from_module( debug_from_relay_includelist, debug_from_relay_excludelist, user ))
578 return proc; /* we want to relay it */
579 return data->entry_points[ordinal].orig_func;
583 /***********************************************************************
584 * RELAY_SetupDLL
586 * Setup relay debugging for a built-in dll.
588 void RELAY_SetupDLL( HMODULE module )
590 IMAGE_EXPORT_DIRECTORY *exports;
591 DWORD *funcs;
592 unsigned int i, len;
593 DWORD size, entry_point_rva;
594 struct relay_descr *descr;
595 struct relay_private_data *data;
596 const WORD *ordptr;
598 if (!init_done) init_debug_lists();
600 exports = RtlImageDirectoryEntryToData( module, TRUE, IMAGE_DIRECTORY_ENTRY_EXPORT, &size );
601 if (!exports) return;
603 descr = (struct relay_descr *)((char *)exports + size);
604 if (descr->magic != RELAY_DESCR_MAGIC) return;
606 if (!(data = RtlAllocateHeap( GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(*data) +
607 (exports->NumberOfFunctions-1) * sizeof(data->entry_points) )))
608 return;
610 descr->relay_call = relay_call;
611 descr->relay_call_regs = relay_call_regs;
612 descr->private = data;
614 data->module = module;
615 data->base = exports->Base;
616 len = strlen( (char *)module + exports->Name );
617 if (len > 4 && !strcasecmp( (char *)module + exports->Name + len - 4, ".dll" )) len -= 4;
618 len = min( len, sizeof(data->dllname) - 1 );
619 memcpy( data->dllname, (char *)module + exports->Name, len );
620 data->dllname[len] = 0;
622 /* fetch name pointer for all entry points and store them in the private structure */
624 ordptr = (const WORD *)((char *)module + exports->AddressOfNameOrdinals);
625 for (i = 0; i < exports->NumberOfNames; i++, ordptr++)
627 DWORD name_rva = ((DWORD*)((char *)module + exports->AddressOfNames))[i];
628 data->entry_points[*ordptr].name = (const char *)module + name_rva;
631 /* patch the functions in the export table to point to the relay thunks */
633 funcs = (DWORD *)((char *)module + exports->AddressOfFunctions);
634 entry_point_rva = descr->entry_point_base - (const char *)module;
635 for (i = 0; i < exports->NumberOfFunctions; i++, funcs++)
637 if (!descr->entry_point_offsets[i]) continue; /* not a normal function */
638 if (!check_relay_include( data->dllname, i + exports->Base, data->entry_points[i].name ))
639 continue; /* don't include this entry point */
641 data->entry_points[i].orig_func = (char *)module + *funcs;
642 *funcs = entry_point_rva + descr->entry_point_offsets[i];
646 #else /* __i386__ || __x86_64__ */
648 FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
649 DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user )
651 return proc;
654 void RELAY_SetupDLL( HMODULE module )
658 #endif /* __i386__ || __x86_64__ */
661 /***********************************************************************/
662 /* snoop support */
663 /***********************************************************************/
665 #ifdef __i386__
667 WINE_DECLARE_DEBUG_CHANNEL(seh);
668 WINE_DECLARE_DEBUG_CHANNEL(snoop);
670 #include "pshpack1.h"
672 typedef struct
674 /* code part */
675 BYTE lcall; /* 0xe8 call snoopentry (relative) */
676 /* NOTE: If you move snoopentry OR nrofargs fix the relative offset
677 * calculation!
679 DWORD snoopentry; /* SNOOP_Entry relative */
680 /* unreached */
681 int nrofargs;
682 FARPROC origfun;
683 const char *name;
684 } SNOOP_FUN;
686 typedef struct tagSNOOP_DLL {
687 HMODULE hmod;
688 SNOOP_FUN *funs;
689 DWORD ordbase;
690 DWORD nrofordinals;
691 struct tagSNOOP_DLL *next;
692 char name[1];
693 } SNOOP_DLL;
695 typedef struct
697 /* code part */
698 BYTE lcall; /* 0xe8 call snoopret relative*/
699 /* NOTE: If you move snoopret OR origreturn fix the relative offset
700 * calculation!
702 DWORD snoopret; /* SNOOP_Ret relative */
703 /* unreached */
704 FARPROC origreturn;
705 SNOOP_DLL *dll;
706 DWORD ordinal;
707 DWORD origESP;
708 DWORD *args; /* saved args across a stdcall */
709 } SNOOP_RETURNENTRY;
711 typedef struct tagSNOOP_RETURNENTRIES {
712 SNOOP_RETURNENTRY entry[4092/sizeof(SNOOP_RETURNENTRY)];
713 struct tagSNOOP_RETURNENTRIES *next;
714 } SNOOP_RETURNENTRIES;
716 #include "poppack.h"
718 extern void WINAPI SNOOP_Entry(void);
719 extern void WINAPI SNOOP_Return(void);
721 static SNOOP_DLL *firstdll;
722 static SNOOP_RETURNENTRIES *firstrets;
725 /***********************************************************************
726 * SNOOP_ShowDebugmsgSnoop
728 * Simple function to decide if a particular debugging message is
729 * wanted.
731 static BOOL SNOOP_ShowDebugmsgSnoop(const char *module, int ordinal, const char *func)
733 if (debug_snoop_excludelist && check_list( module, ordinal, func, debug_snoop_excludelist ))
734 return FALSE;
735 if (debug_snoop_includelist && !check_list( module, ordinal, func, debug_snoop_includelist ))
736 return FALSE;
737 return TRUE;
741 /***********************************************************************
742 * SNOOP_SetupDLL
744 * Setup snoop debugging for a native dll.
746 void SNOOP_SetupDLL(HMODULE hmod)
748 SNOOP_DLL **dll = &firstdll;
749 char *p, *name;
750 void *addr;
751 SIZE_T size;
752 ULONG size32;
753 IMAGE_EXPORT_DIRECTORY *exports;
755 if (!init_done) init_debug_lists();
757 exports = RtlImageDirectoryEntryToData( hmod, TRUE, IMAGE_DIRECTORY_ENTRY_EXPORT, &size32 );
758 if (!exports || !exports->NumberOfFunctions) return;
759 name = (char *)hmod + exports->Name;
760 size = size32;
762 TRACE_(snoop)("hmod=%p, name=%s\n", hmod, name);
764 while (*dll) {
765 if ((*dll)->hmod == hmod)
767 /* another dll, loaded at the same address */
768 addr = (*dll)->funs;
769 size = (*dll)->nrofordinals * sizeof(SNOOP_FUN);
770 NtFreeVirtualMemory(NtCurrentProcess(), &addr, &size, MEM_RELEASE);
771 break;
773 dll = &((*dll)->next);
775 if (*dll)
776 *dll = RtlReAllocateHeap(GetProcessHeap(),
777 HEAP_ZERO_MEMORY, *dll,
778 sizeof(SNOOP_DLL) + strlen(name));
779 else
780 *dll = RtlAllocateHeap(GetProcessHeap(),
781 HEAP_ZERO_MEMORY,
782 sizeof(SNOOP_DLL) + strlen(name));
783 (*dll)->hmod = hmod;
784 (*dll)->ordbase = exports->Base;
785 (*dll)->nrofordinals = exports->NumberOfFunctions;
786 strcpy( (*dll)->name, name );
787 p = (*dll)->name + strlen((*dll)->name) - 4;
788 if (p > (*dll)->name && !strcasecmp( p, ".dll" )) *p = 0;
790 size = exports->NumberOfFunctions * sizeof(SNOOP_FUN);
791 addr = NULL;
792 NtAllocateVirtualMemory(NtCurrentProcess(), &addr, 0, &size,
793 MEM_COMMIT | MEM_RESERVE, PAGE_EXECUTE_READWRITE);
794 if (!addr) {
795 RtlFreeHeap(GetProcessHeap(),0,*dll);
796 FIXME("out of memory\n");
797 return;
799 (*dll)->funs = addr;
800 memset((*dll)->funs,0,size);
804 /***********************************************************************
805 * SNOOP_GetProcAddress
807 * Return the proc address to use for a given function.
809 FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports,
810 DWORD exp_size, FARPROC origfun, DWORD ordinal,
811 const WCHAR *user)
813 unsigned int i;
814 const char *ename;
815 const WORD *ordinals;
816 const DWORD *names;
817 SNOOP_DLL *dll = firstdll;
818 SNOOP_FUN *fun;
819 const IMAGE_SECTION_HEADER *sec;
821 if (!TRACE_ON(snoop)) return origfun;
822 if (!check_from_module( debug_from_snoop_includelist, debug_from_snoop_excludelist, user ))
823 return origfun; /* the calling module was explicitly excluded */
825 if (!*(LPBYTE)origfun) /* 0x00 is an impossible opcode, possible dataref. */
826 return origfun;
828 sec = RtlImageRvaToSection( RtlImageNtHeader(hmod), hmod, (char *)origfun - (char *)hmod );
830 if (!sec || !(sec->Characteristics & IMAGE_SCN_CNT_CODE))
831 return origfun; /* most likely a data reference */
833 while (dll) {
834 if (hmod == dll->hmod)
835 break;
836 dll = dll->next;
838 if (!dll) /* probably internal */
839 return origfun;
841 /* try to find a name for it */
842 ename = NULL;
843 names = (const DWORD *)((const char *)hmod + exports->AddressOfNames);
844 ordinals = (const WORD *)((const char *)hmod + exports->AddressOfNameOrdinals);
845 if (names) for (i = 0; i < exports->NumberOfNames; i++)
847 if (ordinals[i] == ordinal)
849 ename = (const char *)hmod + names[i];
850 break;
853 if (!SNOOP_ShowDebugmsgSnoop(dll->name,ordinal,ename))
854 return origfun;
855 assert(ordinal < dll->nrofordinals);
856 fun = dll->funs + ordinal;
857 if (!fun->name)
859 fun->name = ename;
860 fun->lcall = 0xe8;
861 /* NOTE: origreturn struct member MUST come directly after snoopentry */
862 fun->snoopentry = (char*)SNOOP_Entry-((char*)(&fun->nrofargs));
863 fun->origfun = origfun;
864 fun->nrofargs = -1;
866 return (FARPROC)&(fun->lcall);
869 static void SNOOP_PrintArg(DWORD x)
871 int i,nostring;
873 DPRINTF("%08x",x);
874 if (!HIWORD(x) || TRACE_ON(seh)) return; /* trivial reject to avoid faults */
875 __TRY
877 LPBYTE s=(LPBYTE)x;
878 i=0;nostring=0;
879 while (i<80) {
880 if (s[i]==0) break;
881 if (s[i]<0x20) {nostring=1;break;}
882 if (s[i]>=0x80) {nostring=1;break;}
883 i++;
885 if (!nostring && i > 5)
886 DPRINTF(" %s",debugstr_an((LPSTR)x,i));
887 else /* try unicode */
889 LPWSTR s=(LPWSTR)x;
890 i=0;nostring=0;
891 while (i<80) {
892 if (s[i]==0) break;
893 if (s[i]<0x20) {nostring=1;break;}
894 if (s[i]>0x100) {nostring=1;break;}
895 i++;
897 if (!nostring && i > 5) DPRINTF(" %s",debugstr_wn((LPWSTR)x,i));
900 __EXCEPT_PAGE_FAULT
903 __ENDTRY
906 #define CALLER1REF (*(DWORD*)context->Esp)
908 void WINAPI __regs_SNOOP_Entry( CONTEXT86 *context )
910 DWORD ordinal=0,entry = context->Eip - 5;
911 SNOOP_DLL *dll = firstdll;
912 SNOOP_FUN *fun = NULL;
913 SNOOP_RETURNENTRIES **rets = &firstrets;
914 SNOOP_RETURNENTRY *ret;
915 int i=0, max;
917 while (dll) {
918 if ( ((char*)entry>=(char*)dll->funs) &&
919 ((char*)entry<=(char*)(dll->funs+dll->nrofordinals))
921 fun = (SNOOP_FUN*)entry;
922 ordinal = fun-dll->funs;
923 break;
925 dll=dll->next;
927 if (!dll) {
928 FIXME("entrypoint 0x%08x not found\n",entry);
929 return; /* oops */
931 /* guess cdecl ... */
932 if (fun->nrofargs<0) {
933 /* Typical cdecl return frame is:
934 * add esp, xxxxxxxx
935 * which has (for xxxxxxxx up to 255 the opcode "83 C4 xx".
936 * (after that 81 C2 xx xx xx xx)
938 LPBYTE reteip = (LPBYTE)CALLER1REF;
940 if (reteip) {
941 if ((reteip[0]==0x83)&&(reteip[1]==0xc4))
942 fun->nrofargs=reteip[2]/4;
947 while (*rets) {
948 for (i=0;i<sizeof((*rets)->entry)/sizeof((*rets)->entry[0]);i++)
949 if (!(*rets)->entry[i].origreturn)
950 break;
951 if (i!=sizeof((*rets)->entry)/sizeof((*rets)->entry[0]))
952 break;
953 rets = &((*rets)->next);
955 if (!*rets) {
956 SIZE_T size = 4096;
957 VOID* addr = NULL;
959 NtAllocateVirtualMemory(NtCurrentProcess(), &addr, 0, &size,
960 MEM_COMMIT | MEM_RESERVE,
961 PAGE_EXECUTE_READWRITE);
962 if (!addr) return;
963 *rets = addr;
964 memset(*rets,0,4096);
965 i = 0; /* entry 0 is free */
967 ret = &((*rets)->entry[i]);
968 ret->lcall = 0xe8;
969 /* NOTE: origreturn struct member MUST come directly after snoopret */
970 ret->snoopret = ((char*)SNOOP_Return)-(char*)(&ret->origreturn);
971 ret->origreturn = (FARPROC)CALLER1REF;
972 CALLER1REF = (DWORD)&ret->lcall;
973 ret->dll = dll;
974 ret->args = NULL;
975 ret->ordinal = ordinal;
976 ret->origESP = context->Esp;
978 context->Eip = (DWORD)fun->origfun;
980 if (fun->name) DPRINTF("%04x:CALL %s.%s(",GetCurrentThreadId(),dll->name,fun->name);
981 else DPRINTF("%04x:CALL %s.%d(",GetCurrentThreadId(),dll->name,dll->ordbase+ordinal);
982 if (fun->nrofargs>0) {
983 max = fun->nrofargs; if (max>16) max=16;
984 for (i=0;i<max;i++)
986 SNOOP_PrintArg(*(DWORD*)(context->Esp + 4 + sizeof(DWORD)*i));
987 if (i<fun->nrofargs-1) DPRINTF(",");
989 if (max!=fun->nrofargs)
990 DPRINTF(" ...");
991 } else if (fun->nrofargs<0) {
992 DPRINTF("<unknown, check return>");
993 ret->args = RtlAllocateHeap(GetProcessHeap(),
994 0,16*sizeof(DWORD));
995 memcpy(ret->args,(LPBYTE)(context->Esp + 4),sizeof(DWORD)*16);
997 DPRINTF(") ret=%08x\n",(DWORD)ret->origreturn);
1001 void WINAPI __regs_SNOOP_Return( CONTEXT86 *context )
1003 SNOOP_RETURNENTRY *ret = (SNOOP_RETURNENTRY*)(context->Eip - 5);
1004 SNOOP_FUN *fun = &ret->dll->funs[ret->ordinal];
1006 /* We haven't found out the nrofargs yet. If we called a cdecl
1007 * function it is too late anyway and we can just set '0' (which
1008 * will be the difference between orig and current ESP
1009 * If stdcall -> everything ok.
1011 if (ret->dll->funs[ret->ordinal].nrofargs<0)
1012 ret->dll->funs[ret->ordinal].nrofargs=(context->Esp - ret->origESP-4)/4;
1013 context->Eip = (DWORD)ret->origreturn;
1014 if (ret->args) {
1015 int i,max;
1017 if (fun->name)
1018 DPRINTF("%04x:RET %s.%s(", GetCurrentThreadId(), ret->dll->name, fun->name);
1019 else
1020 DPRINTF("%04x:RET %s.%d(", GetCurrentThreadId(),
1021 ret->dll->name,ret->dll->ordbase+ret->ordinal);
1023 max = fun->nrofargs;
1024 if (max>16) max=16;
1026 for (i=0;i<max;i++)
1028 SNOOP_PrintArg(ret->args[i]);
1029 if (i<max-1) DPRINTF(",");
1031 DPRINTF(") retval=%08x ret=%08x\n",
1032 context->Eax,(DWORD)ret->origreturn );
1033 RtlFreeHeap(GetProcessHeap(),0,ret->args);
1034 ret->args = NULL;
1036 else
1038 if (fun->name)
1039 DPRINTF("%04x:RET %s.%s() retval=%08x ret=%08x\n",
1040 GetCurrentThreadId(),
1041 ret->dll->name, fun->name, context->Eax, (DWORD)ret->origreturn);
1042 else
1043 DPRINTF("%04x:RET %s.%d() retval=%08x ret=%08x\n",
1044 GetCurrentThreadId(),
1045 ret->dll->name,ret->dll->ordbase+ret->ordinal,
1046 context->Eax, (DWORD)ret->origreturn);
1048 ret->origreturn = NULL; /* mark as empty */
1051 /* assembly wrappers that save the context */
1052 DEFINE_REGS_ENTRYPOINT( SNOOP_Entry, 0 )
1053 DEFINE_REGS_ENTRYPOINT( SNOOP_Return, 0 )
1055 #else /* __i386__ */
1057 FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports, DWORD exp_size,
1058 FARPROC origfun, DWORD ordinal, const WCHAR *user )
1060 return origfun;
1063 void SNOOP_SetupDLL( HMODULE hmod )
1065 FIXME("snooping works only on i386 for now.\n");
1068 #endif /* __i386__ */