2 * 386-specific Win32 relay functions
4 * Copyright 1997 Alexandre Julliard
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"
31 #include "stackframe.h"
33 #include "wine/debug.h"
35 WINE_DEFAULT_DEBUG_CHANNEL(relay
);
36 WINE_DECLARE_DEBUG_CHANNEL(snoop
);
38 const char **debug_relay_excludelist
= NULL
;
39 const char **debug_relay_includelist
= NULL
;
40 const char **debug_snoop_excludelist
= NULL
;
41 const char **debug_snoop_includelist
= NULL
;
43 /***********************************************************************
46 * Build a function list from a ';'-separated string.
48 static const char **build_list( const char *buffer
)
51 const char *p
= buffer
;
54 while ((p
= strchr( p
, ';' )))
59 /* allocate count+1 pointers, plus the space for a copy of the string */
60 if ((ret
= HeapAlloc( GetProcessHeap(), 0, (count
+1) * sizeof(char*) + strlen(buffer
) + 1 )))
62 char *str
= (char *)(ret
+ count
+ 1);
65 strcpy( str
, buffer
);
70 if (!(p
= strchr( p
, ';' ))) break;
79 /***********************************************************************
80 * RELAY_InitDebugLists
82 * Build the relay include/exclude function lists.
84 void RELAY_InitDebugLists(void)
90 if (RegOpenKeyA( HKEY_LOCAL_MACHINE
, "Software\\Wine\\Wine\\Config\\Debug", &hkey
)) return;
92 count
= sizeof(buffer
);
93 if (!RegQueryValueExA( hkey
, "RelayInclude", NULL
, &type
, buffer
, &count
))
95 TRACE("RelayInclude = %s\n", buffer
);
96 debug_relay_includelist
= build_list( buffer
);
99 count
= sizeof(buffer
);
100 if (!RegQueryValueExA( hkey
, "RelayExclude", NULL
, &type
, buffer
, &count
))
102 TRACE( "RelayExclude = %s\n", buffer
);
103 debug_relay_excludelist
= build_list( buffer
);
106 count
= sizeof(buffer
);
107 if (!RegQueryValueExA( hkey
, "SnoopInclude", NULL
, &type
, buffer
, &count
))
109 TRACE_(snoop
)( "SnoopInclude = %s\n", buffer
);
110 debug_snoop_includelist
= build_list( buffer
);
113 count
= sizeof(buffer
);
114 if (!RegQueryValueExA( hkey
, "SnoopExclude", NULL
, &type
, buffer
, &count
))
116 TRACE_(snoop
)( "SnoopExclude = %s\n", buffer
);
117 debug_snoop_excludelist
= build_list( buffer
);
128 BYTE call
; /* 0xe8 call callfrom32 (relative) */
129 DWORD callfrom32 WINE_PACKED
; /* RELAY_CallFrom32 relative addr */
130 BYTE ret
; /* 0xc2 ret $n or 0xc3 ret */
131 WORD args
; /* nb of args to remove from the stack */
132 void *orig
; /* original entry point */
133 DWORD argtypes
; /* argument types */
137 /***********************************************************************
138 * check_relay_include
140 * Check if a given function must be included in the relay output.
142 static BOOL
check_relay_include( const char *module
, const char *func
)
144 const char **listitem
;
147 if (!debug_relay_excludelist
&& !debug_relay_includelist
) return TRUE
;
148 if (debug_relay_excludelist
)
151 listitem
= debug_relay_excludelist
;
156 listitem
= debug_relay_includelist
;
158 for(; *listitem
; listitem
++)
160 char *p
= strrchr( *listitem
, '.' );
161 if (p
&& p
> *listitem
) /* check module and function */
163 int len
= p
- *listitem
;
164 if (strncasecmp( *listitem
, module
, len
-1 ) || module
[len
]) continue;
165 if (!strcmp( p
+ 1, func
) || !strcmp( p
+ 1, "*" )) return !show
;
167 else /* function only */
169 if (!strcmp( *listitem
, func
)) return !show
;
176 /***********************************************************************
179 * Find the name of an exported function.
181 static const char *find_exported_name( const char *module
,
182 IMAGE_EXPORT_DIRECTORY
*exp
, int ordinal
)
185 const char *ret
= NULL
;
187 WORD
*ordptr
= (WORD
*)(module
+ exp
->AddressOfNameOrdinals
);
188 for (i
= 0; i
< exp
->NumberOfNames
; i
++, ordptr
++)
189 if (*ordptr
+ exp
->Base
== ordinal
) break;
190 if (i
< exp
->NumberOfNames
)
191 ret
= module
+ ((DWORD
*)(module
+ exp
->AddressOfNames
))[i
];
196 /***********************************************************************
199 * Get the name of the DLL entry point corresponding to a relay address.
201 static void get_entry_point( char *buffer
, DEBUG_ENTRY_POINT
*relay
)
203 IMAGE_EXPORT_DIRECTORY
*exp
= NULL
;
204 DEBUG_ENTRY_POINT
*debug
;
205 char *p
, *base
= NULL
;
211 /* First find the module */
213 for (wm
= MODULE_modref_list
; wm
; wm
= wm
->next
)
215 if (!(wm
->flags
& WINE_MODREF_INTERNAL
)) continue;
216 exp
= RtlImageDirectoryEntryToData( wm
->module
, TRUE
, IMAGE_DIRECTORY_ENTRY_EXPORT
, &size
);
218 debug
= (DEBUG_ENTRY_POINT
*)((char *)exp
+ size
);
219 if (debug
<= relay
&& relay
< debug
+ exp
->NumberOfFunctions
)
221 ordinal
= relay
- debug
;
226 /* Now find the function */
228 base
= (char *)wm
->module
;
229 strcpy( buffer
, base
+ exp
->Name
);
230 p
= buffer
+ strlen(buffer
);
231 if (p
> buffer
+ 4 && !strcasecmp( p
- 4, ".dll" )) p
-= 4;
233 if ((name
= find_exported_name( base
, exp
, ordinal
+ exp
->Base
)))
234 sprintf( p
, ".%s", name
);
236 sprintf( p
, ".%ld", ordinal
+ exp
->Base
);
240 /***********************************************************************
243 static inline void RELAY_PrintArgs( int *args
, int nb_args
, unsigned int typemask
)
247 if ((typemask
& 3) && HIWORD(*args
))
250 DPRINTF( "%08x %s", *args
, debugstr_w((LPWSTR
)*args
) );
252 DPRINTF( "%08x %s", *args
, debugstr_a((LPCSTR
)*args
) );
254 else DPRINTF( "%08x", *args
);
255 if (nb_args
) DPRINTF( "," );
262 typedef LONGLONG (*LONGLONG_CPROC
)();
263 typedef LONGLONG (WINAPI
*LONGLONG_FARPROC
)();
266 /***********************************************************************
267 * call_cdecl_function
269 static LONGLONG
call_cdecl_function( LONGLONG_CPROC func
, int nb_args
, const int *args
)
274 case 0: ret
= func(); break;
275 case 1: ret
= func(args
[0]); break;
276 case 2: ret
= func(args
[0],args
[1]); break;
277 case 3: ret
= func(args
[0],args
[1],args
[2]); break;
278 case 4: ret
= func(args
[0],args
[1],args
[2],args
[3]); break;
279 case 5: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4]); break;
280 case 6: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],
282 case 7: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
284 case 8: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
285 args
[6],args
[7]); break;
286 case 9: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
287 args
[6],args
[7],args
[8]); break;
288 case 10: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
289 args
[6],args
[7],args
[8],args
[9]); break;
290 case 11: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
291 args
[6],args
[7],args
[8],args
[9],args
[10]); break;
292 case 12: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
293 args
[6],args
[7],args
[8],args
[9],args
[10],
295 case 13: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
296 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
298 case 14: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
299 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
300 args
[12],args
[13]); break;
301 case 15: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
302 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
303 args
[12],args
[13],args
[14]); break;
304 case 16: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
305 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
306 args
[12],args
[13],args
[14],args
[15]); break;
308 ERR( "Unsupported nb of args %d\n", nb_args
);
315 /***********************************************************************
316 * call_stdcall_function
318 static LONGLONG
call_stdcall_function( LONGLONG_FARPROC func
, int nb_args
, const int *args
)
323 case 0: ret
= func(); break;
324 case 1: ret
= func(args
[0]); break;
325 case 2: ret
= func(args
[0],args
[1]); break;
326 case 3: ret
= func(args
[0],args
[1],args
[2]); break;
327 case 4: ret
= func(args
[0],args
[1],args
[2],args
[3]); break;
328 case 5: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4]); break;
329 case 6: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],
331 case 7: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
333 case 8: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
334 args
[6],args
[7]); break;
335 case 9: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
336 args
[6],args
[7],args
[8]); break;
337 case 10: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
338 args
[6],args
[7],args
[8],args
[9]); break;
339 case 11: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
340 args
[6],args
[7],args
[8],args
[9],args
[10]); break;
341 case 12: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
342 args
[6],args
[7],args
[8],args
[9],args
[10],
344 case 13: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
345 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
347 case 14: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
348 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
349 args
[12],args
[13]); break;
350 case 15: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
351 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
352 args
[12],args
[13],args
[14]); break;
353 case 16: ret
= func(args
[0],args
[1],args
[2],args
[3],args
[4],args
[5],
354 args
[6],args
[7],args
[8],args
[9],args
[10],args
[11],
355 args
[12],args
[13],args
[14],args
[15]); break;
357 ERR( "Unsupported nb of args %d\n", nb_args
);
364 /***********************************************************************
367 * Stack layout on entry to this function:
372 * (esp) return addr to relay code
374 static LONGLONG
RELAY_CallFrom32( int ret_addr
, ... )
379 int *args
= &ret_addr
+ 1;
380 /* Relay addr is the return address for this function */
381 BYTE
*relay_addr
= (BYTE
*)__builtin_return_address(0);
382 DEBUG_ENTRY_POINT
*relay
= (DEBUG_ENTRY_POINT
*)(relay_addr
- 5);
383 WORD nb_args
= relay
->args
/ sizeof(int);
387 get_entry_point( buffer
, relay
);
389 DPRINTF( "%08lx:Call %s(", GetCurrentThreadId(), buffer
);
390 RELAY_PrintArgs( args
, nb_args
, relay
->argtypes
);
391 DPRINTF( ") ret=%08x\n", ret_addr
);
394 if (relay
->ret
== 0xc3) /* cdecl */
396 ret
= call_cdecl_function( (LONGLONG_CPROC
)relay
->orig
, nb_args
, args
);
400 ret
= call_stdcall_function( (LONGLONG_FARPROC
)relay
->orig
, nb_args
, args
);
405 BOOL ret64
= (relay
->argtypes
& 0x80000000) && (nb_args
< 16);
407 DPRINTF( "%08lx:Ret %s() retval=%08x%08x ret=%08x\n",
408 GetCurrentThreadId(),
409 buffer
, (UINT
)(ret
>> 32), (UINT
)ret
, ret_addr
);
411 DPRINTF( "%08lx:Ret %s() retval=%08x ret=%08x\n",
412 GetCurrentThreadId(),
413 buffer
, (UINT
)ret
, ret_addr
);
419 /***********************************************************************
420 * RELAY_CallFrom32Regs
422 * Stack layout (esp is context->Esp, not the current %esp):
426 * (esp) return addr to caller
427 * (esp-4) return addr to DEBUG_ENTRY_POINT
428 * (esp-8) ptr to relay entry code for RELAY_CallFrom32Regs
429 * ... >128 bytes space free to be modified (ensured by the assembly glue)
431 void WINAPI
RELAY_DoCallFrom32Regs( CONTEXT86
*context
)
438 BYTE
*relay_addr
= *((BYTE
**)context
->Esp
- 1);
439 DEBUG_ENTRY_POINT
*relay
= (DEBUG_ENTRY_POINT
*)(relay_addr
- 5);
440 WORD nb_args
= (relay
->args
& ~0x8000) / sizeof(int);
442 /* remove extra stuff from the stack */
443 context
->Eip
= stack32_pop(context
);
444 args
= (int *)context
->Esp
;
445 if (relay
->ret
== 0xc2) /* stdcall */
446 context
->Esp
+= nb_args
* sizeof(int);
448 entry_point
= (BYTE
*)relay
->orig
;
449 assert( *entry_point
== 0xe8 /* lcall */ );
453 get_entry_point( buffer
, relay
);
455 DPRINTF( "%08lx:Call %s(", GetCurrentThreadId(), buffer
);
456 RELAY_PrintArgs( args
, nb_args
, relay
->argtypes
);
457 DPRINTF( ") ret=%08lx fs=%04lx\n", context
->Eip
, context
->SegFs
);
459 DPRINTF(" eax=%08lx ebx=%08lx ecx=%08lx edx=%08lx esi=%08lx edi=%08lx\n",
460 context
->Eax
, context
->Ebx
, context
->Ecx
,
461 context
->Edx
, context
->Esi
, context
->Edi
);
462 DPRINTF(" ebp=%08lx esp=%08lx ds=%04lx es=%04lx gs=%04lx flags=%08lx\n",
463 context
->Ebp
, context
->Esp
, context
->SegDs
,
464 context
->SegEs
, context
->SegGs
, context
->EFlags
);
467 /* Now call the real function */
469 memcpy( args_copy
, args
, nb_args
* sizeof(args
[0]) );
470 args_copy
[nb_args
] = (int)context
; /* append context argument */
471 if (relay
->ret
== 0xc3) /* cdecl */
473 call_cdecl_function( *(LONGLONG_CPROC
*)(entry_point
+ 5), nb_args
+1, args_copy
);
477 call_stdcall_function( *(LONGLONG_FARPROC
*)(entry_point
+ 5), nb_args
+1, args_copy
);
482 DPRINTF( "%08lx:Ret %s() retval=%08lx ret=%08lx fs=%04lx\n",
483 GetCurrentThreadId(),
484 buffer
, context
->Eax
, context
->Eip
, context
->SegFs
);
486 DPRINTF(" eax=%08lx ebx=%08lx ecx=%08lx edx=%08lx esi=%08lx edi=%08lx\n",
487 context
->Eax
, context
->Ebx
, context
->Ecx
,
488 context
->Edx
, context
->Esi
, context
->Edi
);
489 DPRINTF(" ebp=%08lx esp=%08lx ds=%04lx es=%04lx gs=%04lx flags=%08lx\n",
490 context
->Ebp
, context
->Esp
, context
->SegDs
,
491 context
->SegEs
, context
->SegGs
, context
->EFlags
);
495 void WINAPI
RELAY_CallFrom32Regs(void);
496 __ASM_GLOBAL_FUNC( RELAY_CallFrom32Regs
,
497 "call " __ASM_NAME("__wine_call_from_32_regs") "\n\t"
498 ".long " __ASM_NAME("RELAY_DoCallFrom32Regs") ",0" );
500 /***********************************************************************
503 * Setup relay debugging for a built-in dll.
505 void RELAY_SetupDLL( const char *module
)
507 IMAGE_EXPORT_DIRECTORY
*exports
;
508 DEBUG_ENTRY_POINT
*debug
;
512 char *p
, dllname
[80];
515 exports
= RtlImageDirectoryEntryToData( (HMODULE
)module
, TRUE
,
516 IMAGE_DIRECTORY_ENTRY_EXPORT
, &size
);
517 if (!exports
) return;
518 debug
= (DEBUG_ENTRY_POINT
*)((char *)exports
+ size
);
519 funcs
= (DWORD
*)(module
+ exports
->AddressOfFunctions
);
520 strcpy( dllname
, module
+ exports
->Name
);
521 p
= dllname
+ strlen(dllname
) - 4;
522 if (p
> dllname
&& !strcasecmp( p
, ".dll" )) *p
= 0;
524 for (i
= 0; i
< exports
->NumberOfFunctions
; i
++, funcs
++, debug
++)
528 if (!debug
->call
) continue; /* not a normal function */
529 if (debug
->call
!= 0xe8 && debug
->call
!= 0xe9) break; /* not a debug thunk at all */
531 if ((name
= find_exported_name( module
, exports
, i
+ exports
->Base
)))
532 on
= check_relay_include( dllname
, name
);
536 debug
->call
= 0xe8; /* call relative */
537 if (debug
->args
& 0x8000) /* register func */
538 debug
->callfrom32
= (char *)RELAY_CallFrom32Regs
- (char *)&debug
->ret
;
540 debug
->callfrom32
= (char *)RELAY_CallFrom32
- (char *)&debug
->ret
;
544 debug
->call
= 0xe9; /* jmp relative */
545 debug
->callfrom32
= (char *)debug
->orig
- (char *)&debug
->ret
;
548 debug
->orig
= (FARPROC
)(module
+ (DWORD
)*funcs
);
549 *funcs
= (char *)debug
- module
;
555 void RELAY_SetupDLL( const char *module
)
559 #endif /* __i386__ */