ntdll: Add a helper function to check that a fault address lies in a known virtual...
[wine] / dlls / ntdll / relay.c
1 /*
2  * Win32 relay and snoop functions
3  *
4  * Copyright 1997 Alexandre Julliard
5  * Copyright 1998 Marcus Meissner
6  *
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.
11  *
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.
16  *
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
20  */
21
22 #include "config.h"
23 #include "wine/port.h"
24
25 #include <assert.h>
26 #include <string.h>
27 #include <stdarg.h>
28 #include <stdio.h>
29
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"
38
39 WINE_DEFAULT_DEBUG_CHANNEL(relay);
40
41 #if defined(__i386__) || defined(__x86_64__) || defined(__arm__)
42
43 WINE_DECLARE_DEBUG_CHANNEL(timestamp);
44
45 struct relay_descr  /* descriptor for a module */
46 {
47     void               *magic;               /* signature */
48     void               *relay_call;          /* functions to call from relay thunks */
49     void               *relay_call_regs;
50     void               *private;             /* reserved for the relay code private data */
51     const char         *entry_point_base;    /* base address of entry point thunks */
52     const unsigned int *entry_point_offsets; /* offsets of entry points thunks */
53     const unsigned int *arg_types;           /* table of argument types for all entry points */
54 };
55
56 #define RELAY_DESCR_MAGIC  ((void *)0xdeb90001)
57 #define IS_INTARG(x)       (((ULONG_PTR)(x) >> 16) == 0)
58
59 /* private data built at dll load time */
60
61 struct relay_entry_point
62 {
63     void       *orig_func;    /* original entry point function */
64     const char *name;         /* function name (if any) */
65 };
66
67 struct relay_private_data
68 {
69     HMODULE                  module;            /* module handle of this dll */
70     unsigned int             base;              /* ordinal base */
71     char                     dllname[40];       /* dll name (without .dll extension) */
72     struct relay_entry_point entry_points[1];   /* list of dll entry points */
73 };
74
75 static const WCHAR **debug_relay_excludelist;
76 static const WCHAR **debug_relay_includelist;
77 static const WCHAR **debug_snoop_excludelist;
78 static const WCHAR **debug_snoop_includelist;
79 static const WCHAR **debug_from_relay_excludelist;
80 static const WCHAR **debug_from_relay_includelist;
81 static const WCHAR **debug_from_snoop_excludelist;
82 static const WCHAR **debug_from_snoop_includelist;
83
84 static BOOL init_done;
85
86 /* compare an ASCII and a Unicode string without depending on the current codepage */
87 static inline int strcmpAW( const char *strA, const WCHAR *strW )
88 {
89     while (*strA && ((unsigned char)*strA == *strW)) { strA++; strW++; }
90     return (unsigned char)*strA - *strW;
91 }
92
93 /* compare an ASCII and a Unicode string without depending on the current codepage */
94 static inline int strncmpiAW( const char *strA, const WCHAR *strW, int n )
95 {
96     int ret = 0;
97     for ( ; n > 0; n--, strA++, strW++)
98         if ((ret = toupperW((unsigned char)*strA) - toupperW(*strW)) || !*strA) break;
99     return ret;
100 }
101
102 /***********************************************************************
103  *           build_list
104  *
105  * Build a function list from a ';'-separated string.
106  */
107 static const WCHAR **build_list( const WCHAR *buffer )
108 {
109     int count = 1;
110     const WCHAR *p = buffer;
111     const WCHAR **ret;
112
113     while ((p = strchrW( p, ';' )))
114     {
115         count++;
116         p++;
117     }
118     /* allocate count+1 pointers, plus the space for a copy of the string */
119     if ((ret = RtlAllocateHeap( GetProcessHeap(), 0,
120                                 (count+1) * sizeof(WCHAR*) + (strlenW(buffer)+1) * sizeof(WCHAR) )))
121     {
122         WCHAR *str = (WCHAR *)(ret + count + 1);
123         WCHAR *q = str;
124
125         strcpyW( str, buffer );
126         count = 0;
127         for (;;)
128         {
129             ret[count++] = q;
130             if (!(q = strchrW( q, ';' ))) break;
131             *q++ = 0;
132         }
133         ret[count++] = NULL;
134     }
135     return ret;
136 }
137
138 /***********************************************************************
139  *           load_list_value
140  *
141  * Load a function list from a registry value.
142  */
143 static const WCHAR **load_list( HKEY hkey, const WCHAR *value )
144 {
145     char initial_buffer[4096];
146     char *buffer = initial_buffer;
147     DWORD count;
148     NTSTATUS status;
149     UNICODE_STRING name;
150     const WCHAR **list = NULL;
151
152     RtlInitUnicodeString( &name, value );
153     status = NtQueryValueKey( hkey, &name, KeyValuePartialInformation, buffer, sizeof(initial_buffer), &count );
154     if (status == STATUS_BUFFER_OVERFLOW)
155     {
156         buffer = RtlAllocateHeap( GetProcessHeap(), 0, count );
157         status = NtQueryValueKey( hkey, &name, KeyValuePartialInformation, buffer, count, &count );
158     }
159     if (status == STATUS_SUCCESS)
160     {
161         WCHAR *str = (WCHAR *)((KEY_VALUE_PARTIAL_INFORMATION *)buffer)->Data;
162         list = build_list( str );
163         if (list) TRACE( "%s = %s\n", debugstr_w(value), debugstr_w(str) );
164     }
165
166     if (buffer != initial_buffer) RtlFreeHeap( GetProcessHeap(), 0, buffer );
167     return list;
168 }
169
170 /***********************************************************************
171  *           init_debug_lists
172  *
173  * Build the relay include/exclude function lists.
174  */
175 static void init_debug_lists(void)
176 {
177     OBJECT_ATTRIBUTES attr;
178     UNICODE_STRING name;
179     HANDLE root, hkey;
180     static const WCHAR configW[] = {'S','o','f','t','w','a','r','e','\\',
181                                     'W','i','n','e','\\',
182                                     'D','e','b','u','g',0};
183     static const WCHAR RelayIncludeW[] = {'R','e','l','a','y','I','n','c','l','u','d','e',0};
184     static const WCHAR RelayExcludeW[] = {'R','e','l','a','y','E','x','c','l','u','d','e',0};
185     static const WCHAR SnoopIncludeW[] = {'S','n','o','o','p','I','n','c','l','u','d','e',0};
186     static const WCHAR SnoopExcludeW[] = {'S','n','o','o','p','E','x','c','l','u','d','e',0};
187     static const WCHAR RelayFromIncludeW[] = {'R','e','l','a','y','F','r','o','m','I','n','c','l','u','d','e',0};
188     static const WCHAR RelayFromExcludeW[] = {'R','e','l','a','y','F','r','o','m','E','x','c','l','u','d','e',0};
189     static const WCHAR SnoopFromIncludeW[] = {'S','n','o','o','p','F','r','o','m','I','n','c','l','u','d','e',0};
190     static const WCHAR SnoopFromExcludeW[] = {'S','n','o','o','p','F','r','o','m','E','x','c','l','u','d','e',0};
191
192     if (init_done) return;
193     init_done = TRUE;
194
195     RtlOpenCurrentUser( KEY_ALL_ACCESS, &root );
196     attr.Length = sizeof(attr);
197     attr.RootDirectory = root;
198     attr.ObjectName = &name;
199     attr.Attributes = 0;
200     attr.SecurityDescriptor = NULL;
201     attr.SecurityQualityOfService = NULL;
202     RtlInitUnicodeString( &name, configW );
203
204     /* @@ Wine registry key: HKCU\Software\Wine\Debug */
205     if (NtOpenKey( &hkey, KEY_ALL_ACCESS, &attr )) hkey = 0;
206     NtClose( root );
207     if (!hkey) return;
208
209     debug_relay_includelist = load_list( hkey, RelayIncludeW );
210     debug_relay_excludelist = load_list( hkey, RelayExcludeW );
211     debug_snoop_includelist = load_list( hkey, SnoopIncludeW );
212     debug_snoop_excludelist = load_list( hkey, SnoopExcludeW );
213     debug_from_relay_includelist = load_list( hkey, RelayFromIncludeW );
214     debug_from_relay_excludelist = load_list( hkey, RelayFromExcludeW );
215     debug_from_snoop_includelist = load_list( hkey, SnoopFromIncludeW );
216     debug_from_snoop_excludelist = load_list( hkey, SnoopFromExcludeW );
217
218     NtClose( hkey );
219 }
220
221
222 /***********************************************************************
223  *           check_list
224  *
225  * Check if a given module and function is in the list.
226  */
227 static BOOL check_list( const char *module, int ordinal, const char *func, const WCHAR *const *list )
228 {
229     char ord_str[10];
230
231     sprintf( ord_str, "%d", ordinal );
232     for(; *list; list++)
233     {
234         const WCHAR *p = strrchrW( *list, '.' );
235         if (p && p > *list)  /* check module and function */
236         {
237             int len = p - *list;
238             if (strncmpiAW( module, *list, len-1 ) || module[len]) continue;
239             if (p[1] == '*' && !p[2]) return TRUE;
240             if (!strcmpAW( ord_str, p + 1 )) return TRUE;
241             if (func && !strcmpAW( func, p + 1 )) return TRUE;
242         }
243         else  /* function only */
244         {
245             if (func && !strcmpAW( func, *list )) return TRUE;
246         }
247     }
248     return FALSE;
249 }
250
251
252 /***********************************************************************
253  *           check_relay_include
254  *
255  * Check if a given function must be included in the relay output.
256  */
257 static BOOL check_relay_include( const char *module, int ordinal, const char *func )
258 {
259     if (debug_relay_excludelist && check_list( module, ordinal, func, debug_relay_excludelist ))
260         return FALSE;
261     if (debug_relay_includelist && !check_list( module, ordinal, func, debug_relay_includelist ))
262         return FALSE;
263     return TRUE;
264 }
265
266 /***********************************************************************
267  *           check_from_module
268  *
269  * Check if calls from a given module must be included in the relay/snoop output,
270  * given the exclusion and inclusion lists.
271  */
272 static BOOL check_from_module( const WCHAR **includelist, const WCHAR **excludelist, const WCHAR *module )
273 {
274     static const WCHAR dllW[] = {'.','d','l','l',0 };
275     const WCHAR **listitem;
276     BOOL show;
277
278     if (!module) return TRUE;
279     if (!includelist && !excludelist) return TRUE;
280     if (excludelist)
281     {
282         show = TRUE;
283         listitem = excludelist;
284     }
285     else
286     {
287         show = FALSE;
288         listitem = includelist;
289     }
290     for(; *listitem; listitem++)
291     {
292         int len;
293
294         if (!strcmpiW( *listitem, module )) return !show;
295         len = strlenW( *listitem );
296         if (!strncmpiW( *listitem, module, len ) && !strcmpiW( module + len, dllW ))
297             return !show;
298     }
299     return show;
300 }
301
302 /***********************************************************************
303  *           RELAY_PrintArgs
304  */
305 static inline void RELAY_PrintArgs( const INT_PTR *args, int nb_args, unsigned int typemask )
306 {
307     while (nb_args--)
308     {
309         if ((typemask & 3) && !IS_INTARG(*args))
310         {
311             if (typemask & 2)
312                 DPRINTF( "%08lx %s", *args, debugstr_w((LPCWSTR)*args) );
313             else
314                 DPRINTF( "%08lx %s", *args, debugstr_a((LPCSTR)*args) );
315         }
316         else DPRINTF( "%08lx", *args );
317         if (nb_args) DPRINTF( "," );
318         args++;
319         typemask >>= 2;
320     }
321 }
322
323 extern LONGLONG CDECL call_entry_point( void *func, int nb_args, const INT_PTR *args, int flags );
324 #ifdef __i386__
325 __ASM_GLOBAL_FUNC( call_entry_point,
326                    "pushl %ebp\n\t"
327                    __ASM_CFI(".cfi_adjust_cfa_offset 4\n\t")
328                    __ASM_CFI(".cfi_rel_offset %ebp,0\n\t")
329                    "movl %esp,%ebp\n\t"
330                    __ASM_CFI(".cfi_def_cfa_register %ebp\n\t")
331                    "pushl %esi\n\t"
332                   __ASM_CFI(".cfi_rel_offset %esi,-4\n\t")
333                    "pushl %edi\n\t"
334                   __ASM_CFI(".cfi_rel_offset %edi,-8\n\t")
335                    "movl 12(%ebp),%edx\n\t"
336                    "shll $2,%edx\n\t"
337                    "jz 1f\n\t"
338                    "subl %edx,%esp\n\t"
339                    "andl $~15,%esp\n\t"
340                    "movl 12(%ebp),%ecx\n\t"
341                    "movl 16(%ebp),%esi\n\t"
342                    "movl %esp,%edi\n\t"
343                    "cld\n\t"
344                    "rep; movsl\n"
345                    "testl $2,20(%ebp)\n\t"  /* (flags & 2) -> thiscall */
346                    "jz 1f\n\t"
347                    "popl %ecx\n\t"
348                    "1:\tcall *8(%ebp)\n\t"
349                    "leal -8(%ebp),%esp\n\t"
350                    "popl %edi\n\t"
351                    __ASM_CFI(".cfi_same_value %edi\n\t")
352                    "popl %esi\n\t"
353                    __ASM_CFI(".cfi_same_value %esi\n\t")
354                    "popl %ebp\n\t"
355                    __ASM_CFI(".cfi_def_cfa %esp,4\n\t")
356                    __ASM_CFI(".cfi_same_value %ebp\n\t")
357                    "ret" )
358 #elif defined(__arm__)
359 __ASM_GLOBAL_FUNC( call_entry_point,
360                    "push {r4, r5, LR}\n\t"
361                    "mov r4, r0\n\t"
362                    "mov r5, SP\n\t"
363                    "lsl r3, r1, #2\n\t"
364                    "cmp r3, #0\n\t"
365                    "beq 5f\n\t"
366                    "sub SP, SP, r3\n\t"
367                    "bic SP, SP, #15\n\t"
368                    "1:\tsub r3, r3, #4\n\t"
369                    "ldr r0, [r2, r3]\n\t"
370                    "str r0, [SP, r3]\n\t"
371                    "cmp r3, #0\n\t"
372                    "bgt 1b\n\t"
373                    "cmp r1, #1\n\t"
374                    "bgt 2f\n\t"
375                    "pop {r0}\n\t"
376                    "b 5f\n\t"
377                    "2:\tcmp r1, #2\n\t"
378                    "bgt 3f\n\t"
379                    "pop {r0-r1}\n\t"
380                    "b 5f\n\t"
381                    "3:\tcmp r1, #3\n\t"
382                    "bgt 4f\n\t"
383                    "pop {r0-r2}\n\t"
384                    "b 5f\n\t"
385                    "4:\tpop {r0-r3}\n\t"
386                    "5:\tblx r4\n\t"
387                    "mov SP, r5\n\t"
388                    "pop {r4, r5, PC}" )
389 #else
390 __ASM_GLOBAL_FUNC( call_entry_point,
391                    "pushq %rbp\n\t"
392                    __ASM_CFI(".cfi_adjust_cfa_offset 8\n\t")
393                    __ASM_CFI(".cfi_rel_offset %rbp,0\n\t")
394                    "movq %rsp,%rbp\n\t"
395                    __ASM_CFI(".cfi_def_cfa_register %rbp\n\t")
396                    "pushq %rsi\n\t"
397                    __ASM_CFI(".cfi_rel_offset %rsi,-8\n\t")
398                    "pushq %rdi\n\t"
399                    __ASM_CFI(".cfi_rel_offset %rdi,-16\n\t")
400                    "movq %rcx,%rax\n\t"
401                    "movq $4,%rcx\n\t"
402                    "cmp %rcx,%rdx\n\t"
403                    "cmovgq %rdx,%rcx\n\t"
404                    "leaq 0(,%rcx,8),%rdx\n\t"
405                    "subq %rdx,%rsp\n\t"
406                    "andq $~15,%rsp\n\t"
407                    "movq %rsp,%rdi\n\t"
408                    "movq %r8,%rsi\n\t"
409                    "rep; movsq\n\t"
410                    "movq 0(%rsp),%rcx\n\t"
411                    "movq 8(%rsp),%rdx\n\t"
412                    "movq 16(%rsp),%r8\n\t"
413                    "movq 24(%rsp),%r9\n\t"
414                    "movq %rcx,%xmm0\n\t"
415                    "movq %rdx,%xmm1\n\t"
416                    "movq %r8,%xmm2\n\t"
417                    "movq %r9,%xmm3\n\t"
418                    "callq *%rax\n\t"
419                    "leaq -16(%rbp),%rsp\n\t"
420                    "popq %rdi\n\t"
421                    __ASM_CFI(".cfi_same_value %rdi\n\t")
422                    "popq %rsi\n\t"
423                    __ASM_CFI(".cfi_same_value %rsi\n\t")
424                    __ASM_CFI(".cfi_def_cfa_register %rsp\n\t")
425                    "popq %rbp\n\t"
426                    __ASM_CFI(".cfi_adjust_cfa_offset -8\n\t")
427                    __ASM_CFI(".cfi_same_value %rbp\n\t")
428                    "ret")
429 #endif
430
431
432 static void print_timestamp(void)
433 {
434     ULONG ticks = NtGetTickCount();
435     DPRINTF( "%3u.%03u:", ticks / 1000, ticks % 1000 );
436 }
437
438
439 /***********************************************************************
440  *           relay_call
441  *
442  * stack points to the return address, i.e. the first argument is stack[1].
443  */
444 static LONGLONG WINAPI relay_call( struct relay_descr *descr, unsigned int idx, const INT_PTR *stack )
445 {
446     LONGLONG ret;
447     WORD ordinal = LOWORD(idx);
448     BYTE nb_args = LOBYTE(HIWORD(idx));
449     BYTE flags   = HIBYTE(HIWORD(idx));
450     struct relay_private_data *data = descr->private;
451     struct relay_entry_point *entry_point = data->entry_points + ordinal;
452
453     if (!TRACE_ON(relay))
454         ret = call_entry_point( entry_point->orig_func, nb_args, stack + 1, flags );
455     else
456     {
457         if (TRACE_ON(timestamp))
458             print_timestamp();
459         if (entry_point->name)
460             DPRINTF( "%04x:Call %s.%s(", GetCurrentThreadId(), data->dllname, entry_point->name );
461         else
462             DPRINTF( "%04x:Call %s.%u(", GetCurrentThreadId(), data->dllname, data->base + ordinal );
463         RELAY_PrintArgs( stack + 1, nb_args, descr->arg_types[ordinal] );
464         DPRINTF( ") ret=%08lx\n", stack[0] );
465
466         ret = call_entry_point( entry_point->orig_func, nb_args, stack + 1, flags );
467
468         if (TRACE_ON(timestamp))
469             print_timestamp();
470         if (entry_point->name)
471             DPRINTF( "%04x:Ret  %s.%s()", GetCurrentThreadId(), data->dllname, entry_point->name );
472         else
473             DPRINTF( "%04x:Ret  %s.%u()", GetCurrentThreadId(), data->dllname, data->base + ordinal );
474
475         if (flags & 1)  /* 64-bit return value */
476             DPRINTF( " retval=%08x%08x ret=%08lx\n",
477                      (UINT)(ret >> 32), (UINT)ret, stack[0] );
478         else
479             DPRINTF( " retval=%08lx ret=%08lx\n", (UINT_PTR)ret, stack[0] );
480     }
481     return ret;
482 }
483
484
485 /***********************************************************************
486  *           relay_call_regs
487  */
488 #ifdef __i386__
489 void WINAPI __regs_relay_call_regs( struct relay_descr *descr, unsigned int idx,
490                                     unsigned int orig_eax, unsigned int ret_addr,
491                                     CONTEXT *context )
492 {
493     WORD ordinal = LOWORD(idx);
494     BYTE nb_args = LOBYTE(HIWORD(idx));
495     struct relay_private_data *data = descr->private;
496     struct relay_entry_point *entry_point = data->entry_points + ordinal;
497     BYTE *orig_func = entry_point->orig_func;
498     INT_PTR *args = (INT_PTR *)context->Esp;
499     INT_PTR args_copy[32];
500
501     /* restore the context to what it was before the relay thunk */
502     context->Eax = orig_eax;
503     context->Eip = ret_addr;
504     context->Esp += nb_args * sizeof(int);
505
506     if (TRACE_ON(relay))
507     {
508         if (entry_point->name)
509             DPRINTF( "%04x:Call %s.%s(", GetCurrentThreadId(), data->dllname, entry_point->name );
510         else
511             DPRINTF( "%04x:Call %s.%u(", GetCurrentThreadId(), data->dllname, data->base + ordinal );
512         RELAY_PrintArgs( args, nb_args, descr->arg_types[ordinal] );
513         DPRINTF( ") ret=%08x\n", ret_addr );
514
515         DPRINTF( "%04x:  eax=%08x ebx=%08x ecx=%08x edx=%08x esi=%08x edi=%08x "
516                  "ebp=%08x esp=%08x ds=%04x es=%04x fs=%04x gs=%04x flags=%08x\n",
517                  GetCurrentThreadId(), context->Eax, context->Ebx, context->Ecx,
518                  context->Edx, context->Esi, context->Edi, context->Ebp, context->Esp,
519                  context->SegDs, context->SegEs, context->SegFs, context->SegGs, context->EFlags );
520
521         assert( orig_func[0] == 0x68 /* pushl func */ );
522         assert( orig_func[5] == 0x6a /* pushl args */ );
523         assert( orig_func[7] == 0xe8 /* call */ );
524     }
525
526     /* now call the real function */
527
528     memcpy( args_copy, args, nb_args * sizeof(args[0]) );
529     args_copy[nb_args++] = (INT_PTR)context;  /* append context argument */
530
531     call_entry_point( orig_func + 12 + *(int *)(orig_func + 1), nb_args, args_copy, 0 );
532
533
534     if (TRACE_ON(relay))
535     {
536         if (entry_point->name)
537             DPRINTF( "%04x:Ret  %s.%s() retval=%08x ret=%08x\n",
538                      GetCurrentThreadId(), data->dllname, entry_point->name,
539                      context->Eax, context->Eip );
540         else
541             DPRINTF( "%04x:Ret  %s.%u() retval=%08x ret=%08x\n",
542                      GetCurrentThreadId(), data->dllname, data->base + ordinal,
543                      context->Eax, context->Eip );
544         DPRINTF( "%04x:  eax=%08x ebx=%08x ecx=%08x edx=%08x esi=%08x edi=%08x "
545                  "ebp=%08x esp=%08x ds=%04x es=%04x fs=%04x gs=%04x flags=%08x\n",
546                  GetCurrentThreadId(), context->Eax, context->Ebx, context->Ecx,
547                  context->Edx, context->Esi, context->Edi, context->Ebp, context->Esp,
548                  context->SegDs, context->SegEs, context->SegFs, context->SegGs, context->EFlags );
549     }
550 }
551 extern void WINAPI relay_call_regs(void);
552 DEFINE_REGS_ENTRYPOINT( relay_call_regs, 4 )
553
554 #else  /* __i386__ */
555
556 void WINAPI relay_call_regs( struct relay_descr *descr, INT_PTR idx, INT_PTR *stack )
557 {
558     assert(0);  /* should never be called */
559 }
560
561 #endif  /* __i386__ */
562
563
564 /***********************************************************************
565  *           RELAY_GetProcAddress
566  *
567  * Return the proc address to use for a given function.
568  */
569 FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
570                               DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user )
571 {
572     struct relay_private_data *data;
573     const struct relay_descr *descr = (const struct relay_descr *)((const char *)exports + exp_size);
574
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;
580 }
581
582
583 /***********************************************************************
584  *           RELAY_SetupDLL
585  *
586  * Setup relay debugging for a built-in dll.
587  */
588 void RELAY_SetupDLL( HMODULE module )
589 {
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;
597
598     if (!init_done) init_debug_lists();
599
600     exports = RtlImageDirectoryEntryToData( module, TRUE, IMAGE_DIRECTORY_ENTRY_EXPORT, &size );
601     if (!exports) return;
602
603     descr = (struct relay_descr *)((char *)exports + size);
604     if (descr->magic != RELAY_DESCR_MAGIC) return;
605
606     if (!(data = RtlAllocateHeap( GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(*data) +
607                                   (exports->NumberOfFunctions-1) * sizeof(data->entry_points) )))
608         return;
609
610     descr->relay_call = relay_call;
611     descr->relay_call_regs = relay_call_regs;
612     descr->private = data;
613
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;
621
622     /* fetch name pointer for all entry points and store them in the private structure */
623
624     ordptr = (const WORD *)((char *)module + exports->AddressOfNameOrdinals);
625     for (i = 0; i < exports->NumberOfNames; i++, ordptr++)
626     {
627         DWORD name_rva = ((DWORD*)((char *)module + exports->AddressOfNames))[i];
628         data->entry_points[*ordptr].name = (const char *)module + name_rva;
629     }
630
631     /* patch the functions in the export table to point to the relay thunks */
632
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++)
636     {
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 */
640
641         data->entry_points[i].orig_func = (char *)module + *funcs;
642         *funcs = entry_point_rva + descr->entry_point_offsets[i];
643     }
644 }
645
646 #else  /* __i386__ || __x86_64__ */
647
648 FARPROC RELAY_GetProcAddress( HMODULE module, const IMAGE_EXPORT_DIRECTORY *exports,
649                               DWORD exp_size, FARPROC proc, DWORD ordinal, const WCHAR *user )
650 {
651     return proc;
652 }
653
654 void RELAY_SetupDLL( HMODULE module )
655 {
656 }
657
658 #endif  /* __i386__ || __x86_64__ */
659
660
661 /***********************************************************************/
662 /* snoop support */
663 /***********************************************************************/
664
665 #ifdef __i386__
666
667 WINE_DECLARE_DEBUG_CHANNEL(seh);
668 WINE_DECLARE_DEBUG_CHANNEL(snoop);
669
670 #include "pshpack1.h"
671
672 typedef struct
673 {
674         /* code part */
675         BYTE            lcall;          /* 0xe8 call snoopentry (relative) */
676         /* NOTE: If you move snoopentry OR nrofargs fix the relative offset
677          * calculation!
678          */
679         DWORD           snoopentry;     /* SNOOP_Entry relative */
680         /* unreached */
681         int             nrofargs;
682         FARPROC origfun;
683         const char *name;
684 } SNOOP_FUN;
685
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;
694
695 typedef struct
696 {
697         /* code part */
698         BYTE            lcall;          /* 0xe8 call snoopret relative*/
699         /* NOTE: If you move snoopret OR origreturn fix the relative offset
700          * calculation!
701          */
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;
710
711 typedef struct tagSNOOP_RETURNENTRIES {
712         SNOOP_RETURNENTRY entry[4092/sizeof(SNOOP_RETURNENTRY)];
713         struct tagSNOOP_RETURNENTRIES   *next;
714 } SNOOP_RETURNENTRIES;
715
716 #include "poppack.h"
717
718 extern void WINAPI SNOOP_Entry(void);
719 extern void WINAPI SNOOP_Return(void);
720
721 static SNOOP_DLL *firstdll;
722 static SNOOP_RETURNENTRIES *firstrets;
723
724
725 /***********************************************************************
726  *          SNOOP_ShowDebugmsgSnoop
727  *
728  * Simple function to decide if a particular debugging message is
729  * wanted.
730  */
731 static BOOL SNOOP_ShowDebugmsgSnoop(const char *module, int ordinal, const char *func)
732 {
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;
738 }
739
740
741 /***********************************************************************
742  *           SNOOP_SetupDLL
743  *
744  * Setup snoop debugging for a native dll.
745  */
746 void SNOOP_SetupDLL(HMODULE hmod)
747 {
748     SNOOP_DLL **dll = &firstdll;
749     char *p, *name;
750     void *addr;
751     SIZE_T size;
752     ULONG size32;
753     IMAGE_EXPORT_DIRECTORY *exports;
754
755     if (!init_done) init_debug_lists();
756
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;
761
762     TRACE_(snoop)("hmod=%p, name=%s\n", hmod, name);
763
764     while (*dll) {
765         if ((*dll)->hmod == hmod)
766         {
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;
772         }
773         dll = &((*dll)->next);
774     }
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;
789
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;
798     }
799     (*dll)->funs = addr;
800     memset((*dll)->funs,0,size);
801 }
802
803
804 /***********************************************************************
805  *           SNOOP_GetProcAddress
806  *
807  * Return the proc address to use for a given function.
808  */
809 FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports,
810                               DWORD exp_size, FARPROC origfun, DWORD ordinal,
811                               const WCHAR *user)
812 {
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;
820
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 */
824
825     if (!*(LPBYTE)origfun) /* 0x00 is an impossible opcode, possible dataref. */
826         return origfun;
827
828     sec = RtlImageRvaToSection( RtlImageNtHeader(hmod), hmod, (char *)origfun - (char *)hmod );
829
830     if (!sec || !(sec->Characteristics & IMAGE_SCN_CNT_CODE))
831         return origfun;  /* most likely a data reference */
832
833     while (dll) {
834         if (hmod == dll->hmod)
835             break;
836         dll = dll->next;
837     }
838     if (!dll)   /* probably internal */
839         return origfun;
840
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++)
846     {
847         if (ordinals[i] == ordinal)
848         {
849             ename = (const char *)hmod + names[i];
850             break;
851         }
852     }
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)
858     {
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;
865     }
866     return (FARPROC)&(fun->lcall);
867 }
868
869 static void SNOOP_PrintArg(DWORD x)
870 {
871     int i,nostring;
872
873     DPRINTF("%08x",x);
874     if (IS_INTARG(x) || TRACE_ON(seh)) return; /* trivial reject to avoid faults */
875     __TRY
876     {
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++;
884         }
885         if (!nostring && i > 5)
886             DPRINTF(" %s",debugstr_an((LPSTR)x,i));
887         else  /* try unicode */
888         {
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++;
896             }
897             if (!nostring && i > 5) DPRINTF(" %s",debugstr_wn((LPWSTR)x,i));
898         }
899     }
900     __EXCEPT_PAGE_FAULT
901     {
902     }
903     __ENDTRY
904 }
905
906 #define CALLER1REF (*(DWORD*)context->Esp)
907
908 void WINAPI __regs_SNOOP_Entry( CONTEXT *context )
909 {
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;
916
917         while (dll) {
918                 if (    ((char*)entry>=(char*)dll->funs)        &&
919                         ((char*)entry<=(char*)(dll->funs+dll->nrofordinals))
920                 ) {
921                         fun = (SNOOP_FUN*)entry;
922                         ordinal = fun-dll->funs;
923                         break;
924                 }
925                 dll=dll->next;
926         }
927         if (!dll) {
928                 FIXME("entrypoint 0x%08x not found\n",entry);
929                 return; /* oops */
930         }
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)
937                  */
938                 LPBYTE  reteip = (LPBYTE)CALLER1REF;
939
940                 if (reteip) {
941                         if ((reteip[0]==0x83)&&(reteip[1]==0xc4))
942                                 fun->nrofargs=reteip[2]/4;
943                 }
944         }
945
946
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);
954         }
955         if (!*rets) {
956                 SIZE_T size = 4096;
957                 VOID* addr = NULL;
958
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 */
966         }
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;
977
978         context->Eip = (DWORD)fun->origfun;
979
980         if (TRACE_ON(timestamp))
981                 print_timestamp();
982         if (fun->name) DPRINTF("%04x:CALL %s.%s(",GetCurrentThreadId(),dll->name,fun->name);
983         else DPRINTF("%04x:CALL %s.%d(",GetCurrentThreadId(),dll->name,dll->ordbase+ordinal);
984         if (fun->nrofargs>0) {
985                 max = fun->nrofargs; if (max>16) max=16;
986                 for (i=0;i<max;i++)
987                 {
988                     SNOOP_PrintArg(*(DWORD*)(context->Esp + 4 + sizeof(DWORD)*i));
989                     if (i<fun->nrofargs-1) DPRINTF(",");
990                 }
991                 if (max!=fun->nrofargs)
992                         DPRINTF(" ...");
993         } else if (fun->nrofargs<0) {
994                 DPRINTF("<unknown, check return>");
995                 ret->args = RtlAllocateHeap(GetProcessHeap(),
996                                             0,16*sizeof(DWORD));
997                 memcpy(ret->args,(LPBYTE)(context->Esp + 4),sizeof(DWORD)*16);
998         }
999         DPRINTF(") ret=%08x\n",(DWORD)ret->origreturn);
1000 }
1001
1002
1003 void WINAPI __regs_SNOOP_Return( CONTEXT *context )
1004 {
1005         SNOOP_RETURNENTRY       *ret = (SNOOP_RETURNENTRY*)(context->Eip - 5);
1006         SNOOP_FUN *fun = &ret->dll->funs[ret->ordinal];
1007
1008         /* We haven't found out the nrofargs yet. If we called a cdecl
1009          * function it is too late anyway and we can just set '0' (which
1010          * will be the difference between orig and current ESP
1011          * If stdcall -> everything ok.
1012          */
1013         if (ret->dll->funs[ret->ordinal].nrofargs<0)
1014                 ret->dll->funs[ret->ordinal].nrofargs=(context->Esp - ret->origESP-4)/4;
1015         context->Eip = (DWORD)ret->origreturn;
1016         if (TRACE_ON(timestamp))
1017                 print_timestamp();
1018         if (ret->args) {
1019                 int     i,max;
1020
1021                 if (fun->name)
1022                     DPRINTF("%04x:RET  %s.%s(", GetCurrentThreadId(), ret->dll->name, fun->name);
1023                 else
1024                     DPRINTF("%04x:RET  %s.%d(", GetCurrentThreadId(),
1025                             ret->dll->name,ret->dll->ordbase+ret->ordinal);
1026
1027                 max = fun->nrofargs;
1028                 if (max>16) max=16;
1029
1030                 for (i=0;i<max;i++)
1031                 {
1032                     SNOOP_PrintArg(ret->args[i]);
1033                     if (i<max-1) DPRINTF(",");
1034                 }
1035                 DPRINTF(") retval=%08x ret=%08x\n",
1036                         context->Eax,(DWORD)ret->origreturn );
1037                 RtlFreeHeap(GetProcessHeap(),0,ret->args);
1038                 ret->args = NULL;
1039         }
1040         else
1041         {
1042             if (fun->name)
1043                 DPRINTF("%04x:RET  %s.%s() retval=%08x ret=%08x\n",
1044                         GetCurrentThreadId(),
1045                         ret->dll->name, fun->name, context->Eax, (DWORD)ret->origreturn);
1046             else
1047                 DPRINTF("%04x:RET  %s.%d() retval=%08x ret=%08x\n",
1048                         GetCurrentThreadId(),
1049                         ret->dll->name,ret->dll->ordbase+ret->ordinal,
1050                         context->Eax, (DWORD)ret->origreturn);
1051         }
1052         ret->origreturn = NULL; /* mark as empty */
1053 }
1054
1055 /* assembly wrappers that save the context */
1056 DEFINE_REGS_ENTRYPOINT( SNOOP_Entry, 0 )
1057 DEFINE_REGS_ENTRYPOINT( SNOOP_Return, 0 )
1058
1059 #else  /* __i386__ */
1060
1061 FARPROC SNOOP_GetProcAddress( HMODULE hmod, const IMAGE_EXPORT_DIRECTORY *exports, DWORD exp_size,
1062                               FARPROC origfun, DWORD ordinal, const WCHAR *user )
1063 {
1064     return origfun;
1065 }
1066
1067 void SNOOP_SetupDLL( HMODULE hmod )
1068 {
1069     FIXME("snooping works only on i386 for now.\n");
1070 }
1071
1072 #endif /* __i386__ */