2 * 386-specific Win32 relay functions
4 * Copyright 1997 Alexandre Julliard
15 #include "stackframe.h"
17 #include "debugtools.h"
19 DEFAULT_DEBUG_CHANNEL(relay);
21 char **debug_relay_excludelist = NULL, **debug_relay_includelist = NULL;
23 /***********************************************************************
24 * RELAY_ShowDebugmsgRelay
26 * Simple function to decide if a particular debugging message is
27 * wanted. Called from RELAY_CallFrom32 and from in if1632/relay.c
29 int RELAY_ShowDebugmsgRelay(const char *func) {
31 if(debug_relay_excludelist || debug_relay_includelist) {
32 const char *term = strchr(func, ':');
34 int len, len2, itemlen, show;
36 if(debug_relay_excludelist) {
38 listitem = debug_relay_excludelist;
41 listitem = debug_relay_includelist;
44 assert(strlen(term) > 2);
46 len2 = strchr(func, '.') - func;
47 assert(len2 && len2 > 0 && len2 < 64);
49 for(; *listitem; listitem++) {
50 itemlen = strlen(*listitem);
51 if((itemlen == len && !strncasecmp(*listitem, func, len)) ||
52 (itemlen == len2 && !strncasecmp(*listitem, func, len2)) ||
53 !strcasecmp(*listitem, term)) {
68 BYTE call; /* 0xe8 call callfrom32 (relative) */
69 DWORD callfrom32 WINE_PACKED; /* RELAY_CallFrom32 relative addr */
70 BYTE ret; /* 0xc2 ret $n or 0xc3 ret */
71 WORD args; /* nb of args to remove from the stack */
72 void *orig; /* original entry point */
73 DWORD argtypes; /* argument types */
77 /***********************************************************************
80 * Find the name of an exported function.
82 static const char *find_exported_name( const char *module,
83 IMAGE_EXPORT_DIRECTORY *exp, int ordinal )
86 const char *ret = NULL;
88 WORD *ordptr = (WORD *)(module + exp->AddressOfNameOrdinals);
89 for (i = 0; i < exp->NumberOfNames; i++, ordptr++)
90 if (*ordptr + exp->Base == ordinal) break;
91 if (i < exp->NumberOfNames)
92 ret = module + ((DWORD*)(module + exp->AddressOfNames))[i];
97 /***********************************************************************
100 * Get the name of the DLL entry point corresponding to a relay address.
102 static void get_entry_point( char *buffer, DEBUG_ENTRY_POINT *relay )
104 IMAGE_DATA_DIRECTORY *dir;
105 IMAGE_EXPORT_DIRECTORY *exp = NULL;
106 DEBUG_ENTRY_POINT *debug;
112 /* First find the module */
114 for (wm = MODULE_modref_list; wm; wm = wm->next)
116 if (!(wm->flags & WINE_MODREF_INTERNAL)) continue;
117 base = (char *)wm->module;
118 dir = &PE_HEADER(base)->OptionalHeader.DataDirectory[IMAGE_FILE_EXPORT_DIRECTORY];
119 if (!dir->Size) continue;
120 exp = (IMAGE_EXPORT_DIRECTORY *)(base + dir->VirtualAddress);
121 debug = (DEBUG_ENTRY_POINT *)((char *)exp + dir->Size);
122 if (debug <= relay && relay < debug + exp->NumberOfFunctions)
124 ordinal = relay - debug;
129 /* Now find the function */
131 if ((name = find_exported_name( base, exp, ordinal + exp->Base )))
132 sprintf( buffer, "%s.%s", base + exp->Name, name );
134 sprintf( buffer, "%s.%ld", base + exp->Name, ordinal + exp->Base );
138 /***********************************************************************
141 static inline void RELAY_PrintArgs( int *args, int nb_args, unsigned int typemask )
145 if ((typemask & 3) && HIWORD(*args))
148 DPRINTF( "%08x %s", *args, debugstr_w((LPWSTR)*args) );
150 DPRINTF( "%08x %s", *args, debugstr_a((LPCSTR)*args) );
152 else DPRINTF( "%08x", *args );
153 if (nb_args) DPRINTF( "," );
160 typedef LONGLONG (*LONGLONG_CPROC)();
161 typedef LONGLONG WINAPI (*LONGLONG_FARPROC)();
164 /***********************************************************************
165 * call_cdecl_function
167 static LONGLONG call_cdecl_function( LONGLONG_CPROC func, int nb_args, const int *args )
172 case 0: ret = func(); break;
173 case 1: ret = func(args[0]); break;
174 case 2: ret = func(args[0],args[1]); break;
175 case 3: ret = func(args[0],args[1],args[2]); break;
176 case 4: ret = func(args[0],args[1],args[2],args[3]); break;
177 case 5: ret = func(args[0],args[1],args[2],args[3],args[4]); break;
178 case 6: ret = func(args[0],args[1],args[2],args[3],args[4],
180 case 7: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
182 case 8: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
183 args[6],args[7]); break;
184 case 9: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
185 args[6],args[7],args[8]); break;
186 case 10: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
187 args[6],args[7],args[8],args[9]); break;
188 case 11: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
189 args[6],args[7],args[8],args[9],args[10]); break;
190 case 12: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
191 args[6],args[7],args[8],args[9],args[10],
193 case 13: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
194 args[6],args[7],args[8],args[9],args[10],args[11],
196 case 14: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
197 args[6],args[7],args[8],args[9],args[10],args[11],
198 args[12],args[13]); break;
199 case 15: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
200 args[6],args[7],args[8],args[9],args[10],args[11],
201 args[12],args[13],args[14]); break;
202 case 16: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
203 args[6],args[7],args[8],args[9],args[10],args[11],
204 args[12],args[13],args[14],args[15]); break;
206 ERR( "Unsupported nb of args %d\n", nb_args );
213 /***********************************************************************
214 * call_stdcall_function
216 static LONGLONG call_stdcall_function( LONGLONG_FARPROC func, int nb_args, const int *args )
221 case 0: ret = func(); break;
222 case 1: ret = func(args[0]); break;
223 case 2: ret = func(args[0],args[1]); break;
224 case 3: ret = func(args[0],args[1],args[2]); break;
225 case 4: ret = func(args[0],args[1],args[2],args[3]); break;
226 case 5: ret = func(args[0],args[1],args[2],args[3],args[4]); break;
227 case 6: ret = func(args[0],args[1],args[2],args[3],args[4],
229 case 7: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
231 case 8: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
232 args[6],args[7]); break;
233 case 9: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
234 args[6],args[7],args[8]); break;
235 case 10: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
236 args[6],args[7],args[8],args[9]); break;
237 case 11: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
238 args[6],args[7],args[8],args[9],args[10]); break;
239 case 12: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
240 args[6],args[7],args[8],args[9],args[10],
242 case 13: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
243 args[6],args[7],args[8],args[9],args[10],args[11],
245 case 14: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
246 args[6],args[7],args[8],args[9],args[10],args[11],
247 args[12],args[13]); break;
248 case 15: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
249 args[6],args[7],args[8],args[9],args[10],args[11],
250 args[12],args[13],args[14]); break;
251 case 16: ret = func(args[0],args[1],args[2],args[3],args[4],args[5],
252 args[6],args[7],args[8],args[9],args[10],args[11],
253 args[12],args[13],args[14],args[15]); break;
255 ERR( "Unsupported nb of args %d\n", nb_args );
262 /***********************************************************************
265 * Stack layout on entry to this function:
270 * (esp) return addr to relay code
272 static LONGLONG RELAY_CallFrom32( int ret_addr, ... )
278 int *args = &ret_addr + 1;
279 /* Relay addr is the return address for this function */
280 BYTE *relay_addr = (BYTE *)__builtin_return_address(0);
281 DEBUG_ENTRY_POINT *relay = (DEBUG_ENTRY_POINT *)(relay_addr - 5);
282 WORD nb_args = relay->args / sizeof(int);
284 get_entry_point( buffer, relay );
286 DPRINTF( "%08lx:Call %s(", GetCurrentThreadId(), buffer );
287 RELAY_PrintArgs( args, nb_args, relay->argtypes );
288 DPRINTF( ") ret=%08x\n", ret_addr );
289 ret64 = (relay->argtypes & 0x80000000) && (nb_args < 16);
291 if (relay->ret == 0xc3) /* cdecl */
293 ret = call_cdecl_function( (LONGLONG_CPROC)relay->orig, nb_args, args );
297 ret = call_stdcall_function( (LONGLONG_FARPROC)relay->orig, nb_args, args );
301 DPRINTF( "%08lx:Ret %s() retval=%08x%08x ret=%08x\n",
302 GetCurrentThreadId(),
303 buffer, (UINT)(ret >> 32), (UINT)ret, ret_addr );
305 DPRINTF( "%08lx:Ret %s() retval=%08x ret=%08x\n",
306 GetCurrentThreadId(),
307 buffer, (UINT)ret, ret_addr );
313 /***********************************************************************
314 * RELAY_CallFrom32Regs
316 * Stack layout (esp is context->Esp, not the current %esp):
320 * (esp) return addr to caller
321 * (esp-4) return addr to DEBUG_ENTRY_POINT
322 * (esp-8) ptr to relay entry code for RELAY_CallFrom32Regs
323 * ... >128 bytes space free to be modified (ensured by the assembly glue)
325 void WINAPI RELAY_DoCallFrom32Regs( CONTEXT86 *context )
332 BYTE *relay_addr = *((BYTE **)context->Esp - 1);
333 DEBUG_ENTRY_POINT *relay = (DEBUG_ENTRY_POINT *)(relay_addr - 5);
334 WORD nb_args = (relay->args & ~0x8000) / sizeof(int);
336 /* remove extra stuff from the stack */
337 context->Eip = stack32_pop(context);
338 args = (int *)context->Esp;
339 context->Esp += 4 * nb_args;
341 assert(TRACE_ON(relay));
343 entry_point = (BYTE *)relay->orig;
344 assert( *entry_point == 0xe8 /* lcall */ );
346 get_entry_point( buffer, relay );
348 DPRINTF( "%08lx:Call %s(", GetCurrentThreadId(), buffer );
349 RELAY_PrintArgs( args, nb_args, relay->argtypes );
350 DPRINTF( ") ret=%08lx fs=%04lx\n", context->Eip, context->SegFs );
352 DPRINTF(" eax=%08lx ebx=%08lx ecx=%08lx edx=%08lx esi=%08lx edi=%08lx\n",
353 context->Eax, context->Ebx, context->Ecx,
354 context->Edx, context->Esi, context->Edi );
355 DPRINTF(" ebp=%08lx esp=%08lx ds=%04lx es=%04lx gs=%04lx flags=%08lx\n",
356 context->Ebp, context->Esp, context->SegDs,
357 context->SegEs, context->SegGs, context->EFlags );
359 /* Now call the real function */
361 memcpy( args_copy, args, nb_args * sizeof(args[0]) );
362 args_copy[nb_args] = (int)context; /* append context argument */
363 if (relay->ret == 0xc3) /* cdecl */
365 call_cdecl_function( *(LONGLONG_CPROC *)(entry_point + 5), nb_args+1, args_copy );
369 call_stdcall_function( *(LONGLONG_FARPROC *)(entry_point + 5), nb_args+1, args_copy );
372 DPRINTF( "%08lx:Ret %s() retval=%08lx ret=%08lx fs=%04lx\n",
373 GetCurrentThreadId(),
374 buffer, context->Eax, context->Eip, context->SegFs );
376 DPRINTF(" eax=%08lx ebx=%08lx ecx=%08lx edx=%08lx esi=%08lx edi=%08lx\n",
377 context->Eax, context->Ebx, context->Ecx,
378 context->Edx, context->Esi, context->Edi );
379 DPRINTF(" ebp=%08lx esp=%08lx ds=%04lx es=%04lx gs=%04lx flags=%08lx\n",
380 context->Ebp, context->Esp, context->SegDs,
381 context->SegEs, context->SegGs, context->EFlags );
384 void WINAPI RELAY_CallFrom32Regs(void);
385 __ASM_GLOBAL_FUNC( RELAY_CallFrom32Regs,
386 "call " __ASM_NAME("__wine_call_from_32_regs") "\n\t"
387 ".long " __ASM_NAME("RELAY_DoCallFrom32Regs") ",0" );
389 /***********************************************************************
392 * Setup relay debugging for a built-in dll.
394 void RELAY_SetupDLL( const char *module )
396 IMAGE_DATA_DIRECTORY *dir;
397 IMAGE_EXPORT_DIRECTORY *exports;
398 DEBUG_ENTRY_POINT *debug;
401 const char *name, *dllname;
403 dir = &PE_HEADER(module)->OptionalHeader.DataDirectory[IMAGE_FILE_EXPORT_DIRECTORY];
404 if (!dir->Size) return;
405 exports = (IMAGE_EXPORT_DIRECTORY *)(module + dir->VirtualAddress);
406 debug = (DEBUG_ENTRY_POINT *)((char *)exports + dir->Size);
407 funcs = (DWORD *)(module + exports->AddressOfFunctions);
408 dllname = module + exports->Name;
410 for (i = 0; i < exports->NumberOfFunctions; i++, funcs++, debug++)
414 if (!debug->call) continue; /* not a normal function */
415 if (debug->call != 0xe8 && debug->call != 0xe9) break; /* not a debug thunk at all */
417 if ((name = find_exported_name( module, exports, i + exports->Base )))
420 sprintf( buffer, "%s.%d: %s", dllname, i, name );
421 on = RELAY_ShowDebugmsgRelay(buffer);
426 debug->call = 0xe8; /* call relative */
427 if (debug->args & 0x8000) /* register func */
428 debug->callfrom32 = (char *)RELAY_CallFrom32Regs - (char *)&debug->ret;
430 debug->callfrom32 = (char *)RELAY_CallFrom32 - (char *)&debug->ret;
434 debug->call = 0xe9; /* jmp relative */
435 debug->callfrom32 = (char *)debug->orig - (char *)&debug->ret;
438 debug->orig = (FARPROC)(module + (DWORD)*funcs);
439 *funcs = (char *)debug - module;
445 void RELAY_SetupDLL( const char *module )
449 #endif /* __i386__ */