dbghelp: Internal search routines can now be case sensitive/insensitive.
[wine] / dlls / dbghelp / symbol.c
1 /*
2  * File symbol.c - management of symbols (lexical tree)
3  *
4  * Copyright (C) 1993, Eric Youngdale.
5  *               2004, Eric Pouech
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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
20  */
21
22 #define NONAMELESSUNION
23 #define NONAMELESSSTRUCT
24
25 #include "config.h"
26
27 #include <stdlib.h>
28 #include <stdio.h>
29 #include <string.h>
30 #include <limits.h>
31 #include <sys/types.h>
32 #include <assert.h>
33 #ifdef HAVE_REGEX_H
34 # include <regex.h>
35 #endif
36
37 #include "wine/debug.h"
38 #include "dbghelp_private.h"
39
40 WINE_DEFAULT_DEBUG_CHANNEL(dbghelp);
41 WINE_DECLARE_DEBUG_CHANNEL(dbghelp_symt);
42
43 inline static int cmp_addr(ULONG64 a1, ULONG64 a2)
44 {
45     if (a1 > a2) return 1;
46     if (a1 < a2) return -1;
47     return 0;
48 }
49
50 inline static int cmp_sorttab_addr(const struct module* module, int idx, ULONG64 addr)
51 {
52     ULONG64     ref;
53
54     symt_get_info(&module->addr_sorttab[idx]->symt, TI_GET_ADDRESS, &ref);
55     return cmp_addr(ref, addr);
56 }
57
58 int symt_cmp_addr(const void* p1, const void* p2)
59 {
60     const struct symt*  sym1 = *(const struct symt* const *)p1;
61     const struct symt*  sym2 = *(const struct symt* const *)p2;
62     ULONG64     a1, a2;
63
64     symt_get_info(sym1, TI_GET_ADDRESS, &a1);
65     symt_get_info(sym2, TI_GET_ADDRESS, &a2);
66     return cmp_addr(a1, a2);
67 }
68
69 static inline void re_append(char** mask, unsigned* len, char ch)
70 {
71     *mask = HeapReAlloc(GetProcessHeap(), 0, *mask, ++(*len));
72     (*mask)[*len - 2] = ch;
73 }
74
75 /* transforms a dbghelp's regular expression into a POSIX one
76  * Here are the valid dbghelp reg ex characters:
77  *      *       0 or more characters
78  *      ?       a single character
79  *      []      list
80  *      #       0 or more of preceding char
81  *      +       1 or more of preceding char
82  *      escapes \ on #, ?, [, ], *, +. don't work on -
83  */
84 static void compile_regex(const char* str, int numchar, regex_t* re, BOOL _case)
85 {
86     char*       mask = HeapAlloc(GetProcessHeap(), 0, 1);
87     unsigned    len = 1;
88     BOOL        in_escape = FALSE;
89     unsigned    flags = REG_NOSUB;
90
91     re_append(&mask, &len, '^');
92
93     while (*str && numchar--)
94     {
95         /* FIXME: this shouldn't be valid on '-' */
96         if (in_escape)
97         {
98             re_append(&mask, &len, '\\');
99             re_append(&mask, &len, *str);
100             in_escape = FALSE;
101         }
102         else switch (*str)
103         {
104         case '\\': in_escape = TRUE; break;
105         case '*':  re_append(&mask, &len, '.'); re_append(&mask, &len, '*'); break;
106         case '?':  re_append(&mask, &len, '.'); break;
107         case '#':  re_append(&mask, &len, '*'); break;
108         /* escape some valid characters in dbghelp reg exp:s */
109         case '$':  re_append(&mask, &len, '\\'); re_append(&mask, &len, '$'); break;
110         /* +, [, ], - are the same in dbghelp & POSIX, use them as any other char */
111         default:   re_append(&mask, &len, *str); break;
112         }
113         str++;
114     }
115     if (in_escape)
116     {
117         re_append(&mask, &len, '\\');
118         re_append(&mask, &len, '\\');
119     }
120     re_append(&mask, &len, '$');
121     mask[len - 1] = '\0';
122     if (_case) flags |= REG_ICASE;
123     if (regcomp(re, mask, flags)) FIXME("Couldn't compile %s\n", mask);
124     HeapFree(GetProcessHeap(), 0, mask);
125 }
126
127 struct symt_compiland* symt_new_compiland(struct module* module, const char* name)
128 {
129     struct symt_compiland*    sym;
130
131     TRACE_(dbghelp_symt)("Adding compiland symbol %s:%s\n", 
132                          module->module.ModuleName, name);
133     if ((sym = pool_alloc(&module->pool, sizeof(*sym))))
134     {
135         sym->symt.tag = SymTagCompiland;
136         sym->source   = source_new(module, name);
137         vector_init(&sym->vchildren, sizeof(struct symt*), 32);
138     }
139     return sym;
140 }
141
142 struct symt_public* symt_new_public(struct module* module, 
143                                     struct symt_compiland* compiland,
144                                     const char* name,
145                                     unsigned long address, unsigned size,
146                                     BOOL in_code, BOOL is_func)
147 {
148     struct symt_public* sym;
149     struct symt**       p;
150
151     TRACE_(dbghelp_symt)("Adding public symbol %s:%s @%lx\n", 
152                          module->module.ModuleName, name, address);
153     if ((dbghelp_options & SYMOPT_AUTO_PUBLICS) && 
154         symt_find_nearest(module, address) != -1)
155         return NULL;
156     if ((sym = pool_alloc(&module->pool, sizeof(*sym))))
157     {
158         sym->symt.tag      = SymTagPublicSymbol;
159         sym->hash_elt.name = pool_strdup(&module->pool, name);
160         hash_table_add(&module->ht_symbols, &sym->hash_elt);
161         module->sortlist_valid = FALSE;
162         sym->container     = compiland ? &compiland->symt : NULL;
163         sym->address       = address;
164         sym->size          = size;
165         sym->in_code       = in_code;
166         sym->is_function   = is_func;
167         if (compiland)
168         {
169             p = vector_add(&compiland->vchildren, &module->pool);
170             *p = &sym->symt;
171         }
172     }
173     return sym;
174 }
175
176 struct symt_data* symt_new_global_variable(struct module* module, 
177                                            struct symt_compiland* compiland, 
178                                            const char* name, unsigned is_static,
179                                            unsigned long addr, unsigned long size,
180                                            struct symt* type)
181 {
182     struct symt_data*   sym;
183     struct symt**       p;
184     DWORD64             tsz;
185
186     TRACE_(dbghelp_symt)("Adding global symbol %s:%s @%lx %p\n", 
187                          module->module.ModuleName, name, addr, type);
188     if ((sym = pool_alloc(&module->pool, sizeof(*sym))))
189     {
190         sym->symt.tag      = SymTagData;
191         sym->hash_elt.name = pool_strdup(&module->pool, name);
192         hash_table_add(&module->ht_symbols, &sym->hash_elt);
193         module->sortlist_valid = FALSE;
194         sym->kind          = is_static ? DataIsFileStatic : DataIsGlobal;
195         sym->container     = compiland ? &compiland->symt : NULL;
196         sym->type          = type;
197         sym->u.address     = addr;
198         if (type && size && symt_get_info(type, TI_GET_LENGTH, &tsz))
199         {
200             if (tsz != size)
201                 FIXME("Size mismatch for %s.%s between type (%s) and src (%lu)\n",
202                       module->module.ModuleName, name, 
203                       wine_dbgstr_longlong(tsz), size);
204         }
205         if (compiland)
206         {
207             p = vector_add(&compiland->vchildren, &module->pool);
208             *p = &sym->symt;
209         }
210     }
211     return sym;
212 }
213
214 struct symt_function* symt_new_function(struct module* module, 
215                                         struct symt_compiland* compiland, 
216                                         const char* name,
217                                         unsigned long addr, unsigned long size,
218                                         struct symt* sig_type)
219 {
220     struct symt_function*       sym;
221     struct symt**               p;
222
223     TRACE_(dbghelp_symt)("Adding global function %s:%s @%lx-%lx\n", 
224                          module->module.ModuleName, name, addr, addr + size - 1);
225
226     assert(!sig_type || sig_type->tag == SymTagFunctionType);
227     if ((sym = pool_alloc(&module->pool, sizeof(*sym))))
228     {
229         sym->symt.tag  = SymTagFunction;
230         sym->hash_elt.name = pool_strdup(&module->pool, name);
231         hash_table_add(&module->ht_symbols, &sym->hash_elt);
232         module->sortlist_valid = FALSE;
233         sym->container = &compiland->symt;
234         sym->address   = addr;
235         sym->type      = sig_type;
236         sym->size      = size;
237         vector_init(&sym->vlines,  sizeof(struct line_info), 64);
238         vector_init(&sym->vchildren, sizeof(struct symt*), 8);
239         if (compiland)
240         {
241             p = vector_add(&compiland->vchildren, &module->pool);
242             *p = &sym->symt;
243         }
244     }
245     return sym;
246 }
247
248 void symt_add_func_line(struct module* module, struct symt_function* func,
249                         unsigned source_idx, int line_num, unsigned long offset)
250 {
251     struct line_info*   dli;
252     BOOL                last_matches = FALSE;
253
254     if (func == NULL || !(dbghelp_options & SYMOPT_LOAD_LINES)) return;
255
256     TRACE_(dbghelp_symt)("(%p)%s:%lx %s:%u\n", 
257                          func, func->hash_elt.name, offset, 
258                          source_get(module, source_idx), line_num);
259
260     assert(func->symt.tag == SymTagFunction);
261
262     dli = NULL;
263     while ((dli = vector_iter_down(&func->vlines, dli)))
264     {
265         if (dli->is_source_file)
266         {
267             last_matches = (source_idx == dli->u.source_file);
268             break;
269         }
270     }
271
272     if (!last_matches)
273     {
274         /* we shouldn't have line changes on first line of function */
275         dli = vector_add(&func->vlines, &module->pool);
276         dli->is_source_file = 1;
277         dli->is_first       = dli->is_last = 0;
278         dli->line_number    = 0;
279         dli->u.source_file  = source_idx;
280     }
281     dli = vector_add(&func->vlines, &module->pool);
282     dli->is_source_file = 0;
283     dli->is_first       = dli->is_last = 0;
284     dli->line_number    = line_num;
285     dli->u.pc_offset    = func->address + offset;
286 }
287
288 struct symt_data* symt_add_func_local(struct module* module, 
289                                       struct symt_function* func, 
290                                       int regno, int offset, 
291                                       struct symt_block* block, 
292                                       struct symt* type, const char* name)
293 {
294     struct symt_data*   locsym;
295     struct symt**       p;
296
297     assert(func);
298     assert(func->symt.tag == SymTagFunction);
299
300     TRACE_(dbghelp_symt)("Adding local symbol (%s:%s): %s %p\n", 
301                          module->module.ModuleName, func->hash_elt.name, 
302                          name, type);
303     locsym = pool_alloc(&module->pool, sizeof(*locsym));
304     locsym->symt.tag      = SymTagData;
305     locsym->hash_elt.name = pool_strdup(&module->pool, name);
306     locsym->hash_elt.next = NULL;
307     locsym->kind          = (offset < 0) ? DataIsParam : DataIsLocal;
308     locsym->container     = &block->symt;
309     locsym->type          = type;
310     if (regno)
311     {
312         locsym->u.s.reg_id = regno;
313         locsym->u.s.offset = 0;
314         locsym->u.s.length = 0;
315     }
316     else
317     {
318         locsym->u.s.reg_id = 0;
319         locsym->u.s.offset = offset * 8;
320         locsym->u.s.length = 0;
321     }
322     if (block)
323         p = vector_add(&block->vchildren, &module->pool);
324     else
325         p = vector_add(&func->vchildren, &module->pool);
326     *p = &locsym->symt;
327     return locsym;
328 }
329
330 struct symt_block* symt_open_func_block(struct module* module, 
331                                         struct symt_function* func,
332                                         struct symt_block* parent_block, 
333                                         unsigned pc, unsigned len)
334 {
335     struct symt_block*  block;
336     struct symt**       p;
337
338     assert(func);
339     assert(func->symt.tag == SymTagFunction);
340
341     assert(!parent_block || parent_block->symt.tag == SymTagBlock);
342     block = pool_alloc(&module->pool, sizeof(*block));
343     block->symt.tag = SymTagBlock;
344     block->address  = func->address + pc;
345     block->size     = len;
346     block->container = parent_block ? &parent_block->symt : &func->symt;
347     vector_init(&block->vchildren, sizeof(struct symt*), 4);
348     if (parent_block)
349         p = vector_add(&parent_block->vchildren, &module->pool);
350     else
351         p = vector_add(&func->vchildren, &module->pool);
352     *p = &block->symt;
353
354     return block;
355 }
356
357 struct symt_block* symt_close_func_block(struct module* module, 
358                                          struct symt_function* func,
359                                          struct symt_block* block, unsigned pc)
360 {
361     assert(func->symt.tag == SymTagFunction);
362
363     if (pc) block->size = func->address + pc - block->address;
364     return (block->container->tag == SymTagBlock) ? 
365         GET_ENTRY(block->container, struct symt_block, symt) : NULL;
366 }
367
368 struct symt_function_point* symt_add_function_point(struct module* module, 
369                                                     struct symt_function* func,
370                                                     enum SymTagEnum point, 
371                                                     unsigned offset, const char* name)
372 {
373     struct symt_function_point* sym;
374     struct symt**               p;
375
376     if ((sym = pool_alloc(&module->pool, sizeof(*sym))))
377     {
378         sym->symt.tag = point;
379         sym->parent   = func;
380         sym->offset   = offset;
381         sym->name     = name ? pool_strdup(&module->pool, name) : NULL;
382         p = vector_add(&func->vchildren, &module->pool);
383         *p = &sym->symt;
384     }
385     return sym;
386 }
387
388 BOOL symt_normalize_function(struct module* module, struct symt_function* func)
389 {
390     unsigned            len;
391     struct line_info*   dli;
392
393     assert(func);
394     /* We aren't adding any more locals or line numbers to this function.
395      * Free any spare memory that we might have allocated.
396      */
397     assert(func->symt.tag == SymTagFunction);
398
399 /* EPP     vector_pool_normalize(&func->vlines,    &module->pool); */
400 /* EPP     vector_pool_normalize(&func->vchildren, &module->pool); */
401
402     len = vector_length(&func->vlines);
403     if (len--)
404     {
405         dli = vector_at(&func->vlines,   0);  dli->is_first = 1;
406         dli = vector_at(&func->vlines, len);  dli->is_last  = 1;
407     }
408     return TRUE;
409 }
410
411 struct symt_thunk* symt_new_thunk(struct module* module, 
412                                   struct symt_compiland* compiland, 
413                                   const char* name, THUNK_ORDINAL ord,
414                                   unsigned long addr, unsigned long size)
415 {
416     struct symt_thunk*  sym;
417
418     TRACE_(dbghelp_symt)("Adding global thunk %s:%s @%lx-%lx\n", 
419                          module->module.ModuleName, name, addr, addr + size - 1);
420
421     if ((sym = pool_alloc(&module->pool, sizeof(*sym))))
422     {
423         sym->symt.tag  = SymTagThunk;
424         sym->hash_elt.name = pool_strdup(&module->pool, name);
425         hash_table_add(&module->ht_symbols, &sym->hash_elt);
426         module->sortlist_valid = FALSE;
427         sym->container = &compiland->symt;
428         sym->address   = addr;
429         sym->size      = size;
430         sym->ordinal   = ord;
431         if (compiland)
432         {
433             struct symt**       p;
434             p = vector_add(&compiland->vchildren, &module->pool);
435             *p = &sym->symt;
436         }
437     }
438     return sym;
439 }
440
441 /* expect sym_info->MaxNameLen to be set before being called */
442 static void symt_fill_sym_info(const struct module* module, 
443                                const struct symt* sym, SYMBOL_INFO* sym_info)
444 {
445     const char* name;
446     DWORD64 size;
447
448     if (!symt_get_info(sym, TI_GET_TYPE, &sym_info->TypeIndex))
449         sym_info->TypeIndex = 0;
450     sym_info->info = (DWORD)sym;
451     if (!symt_get_info(sym, TI_GET_LENGTH, &size) &&
452         sym_info->TypeIndex &&
453         !symt_get_info((struct symt*)sym_info->TypeIndex, TI_GET_LENGTH, &size))
454         size = 0;
455     sym_info->Size = (DWORD)size;
456     sym_info->ModBase = module->module.BaseOfImage;
457     sym_info->Flags = 0;
458     switch (sym->tag)
459     {
460     case SymTagData:
461         {
462             const struct symt_data*  data = (const struct symt_data*)sym;
463             switch (data->kind)
464             {
465             case DataIsLocal:
466             case DataIsParam:
467                 if (data->u.s.reg_id)
468                 {
469                     sym_info->Flags |= SYMFLAG_REGISTER;
470                     sym_info->Register = data->u.s.reg_id;
471                     sym_info->Address = 0;
472                 }
473                 else
474                 {
475                     if (data->u.s.offset < 0)
476                         sym_info->Flags |= SYMFLAG_LOCAL | SYMFLAG_FRAMEREL;
477                     else
478                         sym_info->Flags |= SYMFLAG_LOCAL | SYMFLAG_PARAMETER | SYMFLAG_FRAMEREL;
479                     /* FIXME: needed ? moreover, it's i386 dependent !!! */
480                     sym_info->Register = CV_REG_EBP;
481                     sym_info->Address = data->u.s.offset / 8;
482                 }
483                 break;
484             case DataIsGlobal:
485             case DataIsFileStatic:
486                 symt_get_info(sym, TI_GET_ADDRESS, &sym_info->Address);
487                 sym_info->Register = 0;
488                 break;
489             case DataIsConstant:
490                 sym_info->Flags |= SYMFLAG_VALUEPRESENT;
491                 switch (data->u.value.n1.n2.vt)
492                 {
493                 case VT_I4:  sym_info->Value = (ULONG)data->u.value.n1.n2.n3.lVal; break;
494                 case VT_I2:  sym_info->Value = (ULONG)(long)data->u.value.n1.n2.n3.iVal; break;
495                 case VT_I1:  sym_info->Value = (ULONG)(long)data->u.value.n1.n2.n3.cVal; break;
496                 case VT_UI4: sym_info->Value = (ULONG)data->u.value.n1.n2.n3.ulVal; break;
497                 case VT_UI2: sym_info->Value = (ULONG)data->u.value.n1.n2.n3.uiVal; break;
498                 case VT_UI1: sym_info->Value = (ULONG)data->u.value.n1.n2.n3.bVal; break;
499                 default:        
500                     FIXME("Unsupported variant type (%u)\n", data->u.value.n1.n2.vt);
501                 }
502                 break;
503             default:
504                 FIXME("Unhandled kind (%u) in sym data\n", data->kind);
505             }
506         }
507         break;
508     case SymTagPublicSymbol:
509         sym_info->Flags |= SYMFLAG_EXPORT;
510         symt_get_info(sym, TI_GET_ADDRESS, &sym_info->Address);
511         break;
512     case SymTagFunction:
513         sym_info->Flags |= SYMFLAG_FUNCTION;
514         symt_get_info(sym, TI_GET_ADDRESS, &sym_info->Address);
515         break;
516     case SymTagThunk:
517         sym_info->Flags |= SYMFLAG_THUNK;
518         symt_get_info(sym, TI_GET_ADDRESS, &sym_info->Address);
519         break;
520     default:
521         symt_get_info(sym, TI_GET_ADDRESS, &sym_info->Address);
522         sym_info->Register = 0;
523         break;
524     }
525     sym_info->Scope = 0; /* FIXME */
526     sym_info->Tag = sym->tag;
527     name = symt_get_name(sym);
528     if (sym_info->MaxNameLen)
529     {
530         if (sym->tag != SymTagPublicSymbol || !(dbghelp_options & SYMOPT_UNDNAME) ||
531             (sym_info->NameLen = UnDecorateSymbolName(name, sym_info->Name, 
532                                                       sym_info->MaxNameLen, UNDNAME_COMPLETE) == 0))
533         {
534             sym_info->NameLen = min(strlen(name), sym_info->MaxNameLen - 1);
535             memcpy(sym_info->Name, name, sym_info->NameLen);
536             sym_info->Name[sym_info->NameLen] = '\0';
537         }
538     }
539     TRACE_(dbghelp_symt)("%p => %s %lu %s\n",
540                          sym, sym_info->Name, sym_info->Size,
541                          wine_dbgstr_longlong(sym_info->Address));
542 }
543
544 static BOOL symt_enum_module(struct module* module, regex_t* regex,
545                              PSYM_ENUMERATESYMBOLS_CALLBACK cb, PVOID user)
546 {
547     char                        buffer[sizeof(SYMBOL_INFO) + 256];
548     SYMBOL_INFO*                sym_info = (SYMBOL_INFO*)buffer;
549     void*                       ptr;
550     struct symt_ht*             sym = NULL;
551     struct hash_table_iter      hti;
552
553     hash_table_iter_init(&module->ht_symbols, &hti, NULL);
554     while ((ptr = hash_table_iter_up(&hti)))
555     {
556         sym = GET_ENTRY(ptr, struct symt_ht, hash_elt);
557         if (sym->hash_elt.name &&
558             regexec(regex, sym->hash_elt.name, 0, NULL, 0) == 0)
559         {
560             sym_info->SizeOfStruct = sizeof(SYMBOL_INFO);
561             sym_info->MaxNameLen = sizeof(buffer) - sizeof(SYMBOL_INFO);
562             symt_fill_sym_info(module, &sym->symt, sym_info);
563             if (!cb(sym_info, sym_info->Size, user)) return TRUE;
564         }
565     }   
566     return FALSE;
567 }
568
569 /***********************************************************************
570  *              resort_symbols
571  *
572  * Rebuild sorted list of symbols for a module.
573  */
574 static BOOL resort_symbols(struct module* module)
575 {
576     int                         nsym = 0;
577     void*                       ptr;
578     struct symt_ht*             sym;
579     struct hash_table_iter      hti;
580
581     hash_table_iter_init(&module->ht_symbols, &hti, NULL);
582     while ((ptr = hash_table_iter_up(&hti)))
583         nsym++;
584
585     if (!(module->module.NumSyms = nsym)) return FALSE;
586     
587     if (module->addr_sorttab)
588         module->addr_sorttab = HeapReAlloc(GetProcessHeap(), 0,
589                                            module->addr_sorttab, 
590                                            nsym * sizeof(struct symt_ht*));
591     else
592         module->addr_sorttab = HeapAlloc(GetProcessHeap(), 0,
593                                          nsym * sizeof(struct symt_ht*));
594     if (!module->addr_sorttab) return FALSE;
595
596     nsym = 0;
597     hash_table_iter_init(&module->ht_symbols, &hti, NULL);
598     while ((ptr = hash_table_iter_up(&hti)))
599     {
600         sym = GET_ENTRY(ptr, struct symt_ht, hash_elt);
601         assert(sym);
602         module->addr_sorttab[nsym++] = sym;
603     }
604     
605     qsort(module->addr_sorttab, nsym, sizeof(struct symt_ht*), symt_cmp_addr);
606     return module->sortlist_valid = TRUE;
607 }
608
609 /* assume addr is in module */
610 int symt_find_nearest(struct module* module, DWORD addr)
611 {
612     int         mid, high, low;
613     ULONG64     ref_addr, ref_size;
614
615     if (!module->sortlist_valid || !module->addr_sorttab)
616     {
617         if (!resort_symbols(module)) return -1;
618     }
619
620     /*
621      * Binary search to find closest symbol.
622      */
623     low = 0;
624     high = module->module.NumSyms;
625
626     symt_get_info(&module->addr_sorttab[0]->symt, TI_GET_ADDRESS, &ref_addr);
627     if (addr < ref_addr) return -1;
628     if (high)
629     {
630         symt_get_info(&module->addr_sorttab[high - 1]->symt, TI_GET_ADDRESS, &ref_addr);
631         if (!symt_get_info(&module->addr_sorttab[high - 1]->symt,  TI_GET_LENGTH, &ref_size) || !ref_size)
632             ref_size = 0x1000; /* arbitrary value */
633         if (addr >= ref_addr + ref_size) return -1;
634     }
635     
636     while (high > low + 1)
637     {
638         mid = (high + low) / 2;
639         if (cmp_sorttab_addr(module, mid, addr) < 0)
640             low = mid;
641         else
642             high = mid;
643     }
644     if (low != high && high != module->module.NumSyms && 
645         cmp_sorttab_addr(module, high, addr) <= 0)
646         low = high;
647
648     /* If found symbol is a public symbol, check if there are any other entries that
649      * might also have the same address, but would get better information
650      */
651     if (module->addr_sorttab[low]->symt.tag == SymTagPublicSymbol)
652     {   
653         symt_get_info(&module->addr_sorttab[low]->symt, TI_GET_ADDRESS, &ref_addr);
654         if (low > 0 &&
655             module->addr_sorttab[low - 1]->symt.tag != SymTagPublicSymbol &&
656             !cmp_sorttab_addr(module, low - 1, ref_addr))
657             low--;
658         else if (low < module->module.NumSyms - 1 && 
659                  module->addr_sorttab[low + 1]->symt.tag != SymTagPublicSymbol &&
660                  !cmp_sorttab_addr(module, low + 1, ref_addr))
661             low++;
662     }
663     /* finally check that we fit into the found symbol */
664     symt_get_info(&module->addr_sorttab[low]->symt, TI_GET_ADDRESS, &ref_addr);
665     if (addr < ref_addr) return -1;
666     if (!symt_get_info(&module->addr_sorttab[high - 1]->symt, TI_GET_LENGTH, &ref_size) || !ref_size)
667         ref_size = 0x1000; /* arbitrary value */
668     if (addr >= ref_addr + ref_size) return -1;
669
670     return low;
671 }
672
673 static BOOL symt_enum_locals_helper(struct process* pcs, struct module* module,
674                                     regex_t* preg, PSYM_ENUMERATESYMBOLS_CALLBACK cb,
675                                     PVOID user, SYMBOL_INFO* sym_info,
676                                     struct vector* v)
677 {
678     struct symt**       plsym = NULL;
679     struct symt*        lsym = NULL;
680     DWORD               pc = pcs->ctx_frame.InstructionOffset;
681
682     while ((plsym = vector_iter_up(v, plsym)))
683     {
684         lsym = *plsym;
685         switch (lsym->tag)
686         {
687         case SymTagBlock:
688             {
689                 struct symt_block*  block = (struct symt_block*)lsym;
690                 if (pc < block->address || block->address + block->size <= pc)
691                     continue;
692                 if (!symt_enum_locals_helper(pcs, module, preg, cb, user, 
693                                              sym_info, &block->vchildren))
694                     return FALSE;
695             }
696             break;
697         case SymTagData:
698             if (regexec(preg, symt_get_name(lsym), 0, NULL, 0) == 0)
699             {
700                 symt_fill_sym_info(module, lsym, sym_info);
701                 if (!cb(sym_info, sym_info->Size, user))
702                     return FALSE;
703             }
704             break;
705         case SymTagLabel:
706         case SymTagFuncDebugStart:
707         case SymTagFuncDebugEnd:
708             break;
709         default:
710             FIXME("Unknown type: %u (%x)\n", lsym->tag, lsym->tag);
711             assert(0);
712         }
713     }
714     return TRUE;
715 }
716
717 static BOOL symt_enum_locals(struct process* pcs, const char* mask,
718                              PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
719                              PVOID UserContext)
720 {
721     struct module*      module;
722     struct symt_ht*     sym;
723     char                buffer[sizeof(SYMBOL_INFO) + 256];
724     SYMBOL_INFO*        sym_info = (SYMBOL_INFO*)buffer;
725     DWORD               pc = pcs->ctx_frame.InstructionOffset;
726     int                 idx;
727
728     sym_info->SizeOfStruct = sizeof(*sym_info);
729     sym_info->MaxNameLen = sizeof(buffer) - sizeof(SYMBOL_INFO);
730
731     module = module_find_by_addr(pcs, pc, DMT_UNKNOWN);
732     if (!(module = module_get_debug(pcs, module))) return FALSE;
733     if ((idx = symt_find_nearest(module, pc)) == -1) return FALSE;
734
735     sym = module->addr_sorttab[idx];
736     if (sym->symt.tag == SymTagFunction)
737     {
738         BOOL            ret;
739         regex_t         preg;
740
741         compile_regex(mask ? mask : "*", -1, &preg,
742                       dbghelp_options & SYMOPT_CASE_INSENSITIVE);
743         ret = symt_enum_locals_helper(pcs, module, &preg, EnumSymbolsCallback, 
744                                       UserContext, sym_info, 
745                                       &((struct symt_function*)sym)->vchildren);
746         regfree(&preg);
747         return ret;
748         
749     }
750     symt_fill_sym_info(module, &sym->symt, sym_info);
751     return EnumSymbolsCallback(sym_info, sym_info->Size, UserContext);
752 }
753
754 /******************************************************************
755  *              SymEnumSymbols (DBGHELP.@)
756  *
757  * cases BaseOfDll = 0
758  *      !foo fails always (despite what MSDN states)
759  *      RE1!RE2 looks up all modules matching RE1, and in all these modules, lookup RE2
760  *      no ! in Mask, lookup in local Context
761  * cases BaseOfDll != 0
762  *      !foo fails always (despite what MSDN states)
763  *      RE1!RE2 gets RE2 from BaseOfDll (whatever RE1 is)
764  */
765 BOOL WINAPI SymEnumSymbols(HANDLE hProcess, ULONG64 BaseOfDll, PCSTR Mask,
766                            PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
767                            PVOID UserContext)
768 {
769     struct process*     pcs = process_find_by_handle(hProcess);
770     struct module*      module;
771     struct module*      dbg_module;
772     const char*         bang;
773     regex_t             mod_regex, sym_regex;
774
775     TRACE("(%p %s %s %p %p)\n", 
776           hProcess, wine_dbgstr_longlong(BaseOfDll), debugstr_a(Mask),
777           EnumSymbolsCallback, UserContext);
778
779     if (!pcs) return FALSE;
780
781     if (BaseOfDll == 0)
782     {
783         /* do local variables ? */
784         if (!Mask || !(bang = strchr(Mask, '!')))
785             return symt_enum_locals(pcs, Mask, EnumSymbolsCallback, UserContext);
786
787         if (bang == Mask) return FALSE;
788
789         compile_regex(Mask, bang - Mask, &mod_regex, 
790                       dbghelp_options & SYMOPT_CASE_INSENSITIVE);
791         compile_regex(bang + 1, -1, &sym_regex, 
792                       dbghelp_options & SYMOPT_CASE_INSENSITIVE);
793         
794         for (module = pcs->lmodules; module; module = module->next)
795         {
796             if (module->type == DMT_PE && (dbg_module = module_get_debug(pcs, module)))
797             {
798                 if (regexec(&mod_regex, module->module.ModuleName, 0, NULL, 0) == 0 &&
799                     symt_enum_module(dbg_module, &sym_regex, 
800                                      EnumSymbolsCallback, UserContext))
801                     break;
802             }
803         }
804         /* not found in PE modules, retry on the ELF ones
805          */
806         if (!module && (dbghelp_options & SYMOPT_WINE_WITH_ELF_MODULES))
807         {
808             for (module = pcs->lmodules; module; module = module->next)
809             {
810                 if (module->type == DMT_ELF &&
811                     !module_get_containee(pcs, module) &&
812                     (dbg_module = module_get_debug(pcs, module)))
813                 {
814                     if (regexec(&mod_regex, module->module.ModuleName, 0, NULL, 0) == 0 &&
815                         symt_enum_module(dbg_module, &sym_regex, EnumSymbolsCallback, UserContext))
816                     break;
817                 }
818             }
819         }
820         regfree(&mod_regex);
821         regfree(&sym_regex);
822         return TRUE;
823     }
824     module = module_find_by_addr(pcs, BaseOfDll, DMT_UNKNOWN);
825     if (!(module = module_get_debug(pcs, module)))
826         return FALSE;
827
828     /* we always ignore module name from Mask when BaseOfDll is defined */
829     if (Mask && (bang = strchr(Mask, '!')))
830     {
831         if (bang == Mask) return FALSE;
832         Mask = bang + 1;
833     }
834
835     compile_regex(Mask ? Mask : "*", -1, &sym_regex, 
836                       dbghelp_options & SYMOPT_CASE_INSENSITIVE);
837     symt_enum_module(module, &sym_regex, EnumSymbolsCallback, UserContext);
838     regfree(&sym_regex);
839
840     return TRUE;
841 }
842
843 struct sym_enumerate
844 {
845     void*                       ctx;
846     PSYM_ENUMSYMBOLS_CALLBACK   cb;
847 };
848
849 static BOOL CALLBACK sym_enumerate_cb(PSYMBOL_INFO syminfo, ULONG size, void* ctx)
850 {
851     struct sym_enumerate*       se = (struct sym_enumerate*)ctx;
852     return (se->cb)(syminfo->Name, syminfo->Address, syminfo->Size, se->ctx);
853 }
854
855 /***********************************************************************
856  *              SymEnumerateSymbols (DBGHELP.@)
857  */
858 BOOL WINAPI SymEnumerateSymbols(HANDLE hProcess, DWORD BaseOfDll,
859                                 PSYM_ENUMSYMBOLS_CALLBACK EnumSymbolsCallback, 
860                                 PVOID UserContext)
861 {
862     struct sym_enumerate        se;
863
864     se.ctx = UserContext;
865     se.cb  = EnumSymbolsCallback;
866     
867     return SymEnumSymbols(hProcess, BaseOfDll, NULL, sym_enumerate_cb, &se);
868 }
869
870 /******************************************************************
871  *              SymFromAddr (DBGHELP.@)
872  *
873  */
874 BOOL WINAPI SymFromAddr(HANDLE hProcess, DWORD64 Address, 
875                         DWORD64* Displacement, PSYMBOL_INFO Symbol)
876 {
877     struct process*     pcs = process_find_by_handle(hProcess);
878     struct module*      module;
879     struct symt_ht*     sym;
880     int                 idx;
881
882     if (!pcs) return FALSE;
883     module = module_find_by_addr(pcs, Address, DMT_UNKNOWN);
884     if (!(module = module_get_debug(pcs, module))) return FALSE;
885     if ((idx = symt_find_nearest(module, Address)) == -1) return FALSE;
886
887     sym = module->addr_sorttab[idx];
888
889     symt_fill_sym_info(module, &sym->symt, Symbol);
890     *Displacement = Address - Symbol->Address;
891     return TRUE;
892 }
893
894 /******************************************************************
895  *              SymGetSymFromAddr (DBGHELP.@)
896  *
897  */
898 BOOL WINAPI SymGetSymFromAddr(HANDLE hProcess, DWORD Address,
899                               PDWORD Displacement, PIMAGEHLP_SYMBOL Symbol)
900 {
901     char        buffer[sizeof(SYMBOL_INFO) + 256];
902     SYMBOL_INFO*si = (SYMBOL_INFO*)buffer;
903     size_t      len;
904     DWORD64     Displacement64;
905
906     if (Symbol->SizeOfStruct < sizeof(*Symbol)) return FALSE;
907     si->SizeOfStruct = sizeof(*si);
908     si->MaxNameLen = 256;
909     if (!SymFromAddr(hProcess, Address, &Displacement64, si))
910         return FALSE;
911
912     if (Displacement)
913         *Displacement = Displacement64;
914     Symbol->Address = si->Address;
915     Symbol->Size    = si->Size;
916     Symbol->Flags   = si->Flags;
917     len = min(Symbol->MaxNameLength, si->MaxNameLen);
918     lstrcpynA(Symbol->Name, si->Name, len);
919     return TRUE;
920 }
921
922 /******************************************************************
923  *              SymFromName (DBGHELP.@)
924  *
925  */
926 BOOL WINAPI SymFromName(HANDLE hProcess, LPSTR Name, PSYMBOL_INFO Symbol)
927 {
928     struct process*             pcs = process_find_by_handle(hProcess);
929     struct module*              module;
930     struct hash_table_iter      hti;
931     void*                       ptr;
932     struct symt_ht*             sym = NULL;
933     const char*                 name;
934
935     TRACE("(%p, %s, %p)\n", hProcess, Name, Symbol);
936     if (!pcs) return FALSE;
937     if (Symbol->SizeOfStruct < sizeof(*Symbol)) return FALSE;
938     name = strchr(Name, '!');
939     if (name)
940     {
941         char    tmp[128];
942         assert(name - Name < sizeof(tmp));
943         memcpy(tmp, Name, name - Name);
944         tmp[name - Name] = '\0';
945         module = module_find_by_name(pcs, tmp, DMT_UNKNOWN);
946         if (!module) return FALSE;
947         Name = (char*)(name + 1);
948     }
949     else module = pcs->lmodules;
950
951     /* FIXME: Name could be made out of a regular expression */
952     for (; module; module = (name) ? NULL : module->next)
953     {
954         if (module->module.SymType == SymNone) continue;
955         if (module->module.SymType == SymDeferred)
956         {
957             struct module*      xmodule = module_get_debug(pcs, module);
958             if (!xmodule || xmodule != module) continue;
959         }
960         hash_table_iter_init(&module->ht_symbols, &hti, Name);
961         while ((ptr = hash_table_iter_up(&hti)))
962         {
963             sym = GET_ENTRY(ptr, struct symt_ht, hash_elt);
964
965             if (!strcmp(sym->hash_elt.name, Name))
966             {
967                 symt_fill_sym_info(module, &sym->symt, Symbol);
968                 return TRUE;
969             }
970         }
971     }
972     return FALSE;
973 }
974
975 /***********************************************************************
976  *              SymGetSymFromName (DBGHELP.@)
977  */
978 BOOL WINAPI SymGetSymFromName(HANDLE hProcess, LPSTR Name, PIMAGEHLP_SYMBOL Symbol)
979 {
980     char        buffer[sizeof(SYMBOL_INFO) + 256];
981     SYMBOL_INFO*si = (SYMBOL_INFO*)buffer;
982     size_t      len;
983
984     if (Symbol->SizeOfStruct < sizeof(*Symbol)) return FALSE;
985     si->SizeOfStruct = sizeof(*si);
986     si->MaxNameLen = 256;
987     if (!SymFromName(hProcess, Name, si)) return FALSE;
988
989     Symbol->Address = si->Address;
990     Symbol->Size    = si->Size;
991     Symbol->Flags   = si->Flags;
992     len = min(Symbol->MaxNameLength, si->MaxNameLen);
993     lstrcpynA(Symbol->Name, si->Name, len);
994     return TRUE;
995 }
996
997 /******************************************************************
998  *              sym_fill_func_line_info
999  *
1000  * fills information about a file
1001  */
1002 BOOL symt_fill_func_line_info(struct module* module, struct symt_function* func, 
1003                               DWORD addr, IMAGEHLP_LINE* line)
1004 {
1005     struct line_info*   dli = NULL;
1006     BOOL                found = FALSE;
1007
1008     assert(func->symt.tag == SymTagFunction);
1009
1010     while ((dli = vector_iter_down(&func->vlines, dli)))
1011     {
1012         if (!dli->is_source_file)
1013         {
1014             if (found || dli->u.pc_offset > addr) continue;
1015             line->LineNumber = dli->line_number;
1016             line->Address    = dli->u.pc_offset;
1017             line->Key        = dli;
1018             found = TRUE;
1019             continue;
1020         }
1021         if (found)
1022         {
1023             line->FileName = (char*)source_get(module, dli->u.source_file);
1024             return TRUE;
1025         }
1026     }
1027     return FALSE;
1028 }
1029
1030 /***********************************************************************
1031  *              SymGetSymNext (DBGHELP.@)
1032  */
1033 BOOL WINAPI SymGetSymNext(HANDLE hProcess, PIMAGEHLP_SYMBOL Symbol)
1034 {
1035     /* algo:
1036      * get module from Symbol.Address
1037      * get index in module.addr_sorttab of Symbol.Address
1038      * increment index
1039      * if out of module bounds, move to next module in process address space
1040      */
1041     FIXME("(%p, %p): stub\n", hProcess, Symbol);
1042     SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
1043     return FALSE;
1044 }
1045
1046 /***********************************************************************
1047  *              SymGetSymPrev (DBGHELP.@)
1048  */
1049
1050 BOOL WINAPI SymGetSymPrev(HANDLE hProcess, PIMAGEHLP_SYMBOL Symbol)
1051 {
1052     FIXME("(%p, %p): stub\n", hProcess, Symbol);
1053     SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
1054     return FALSE;
1055 }
1056
1057 /******************************************************************
1058  *              SymGetLineFromAddr (DBGHELP.@)
1059  *
1060  */
1061 BOOL WINAPI SymGetLineFromAddr(HANDLE hProcess, DWORD dwAddr, 
1062                                PDWORD pdwDisplacement, PIMAGEHLP_LINE Line)
1063 {
1064     struct process*     pcs = process_find_by_handle(hProcess);
1065     struct module*      module;
1066     int                 idx;
1067
1068     TRACE("%p %08lx %p %p\n", hProcess, dwAddr, pdwDisplacement, Line);
1069
1070     if (Line->SizeOfStruct < sizeof(*Line)) return FALSE;
1071
1072     if (!pcs) return FALSE;
1073     module = module_find_by_addr(pcs, dwAddr, DMT_UNKNOWN);
1074     if (!(module = module_get_debug(pcs, module))) return FALSE;
1075     if ((idx = symt_find_nearest(module, dwAddr)) == -1) return FALSE;
1076
1077     if (module->addr_sorttab[idx]->symt.tag != SymTagFunction) return FALSE;
1078     if (!symt_fill_func_line_info(module, 
1079                                   (struct symt_function*)module->addr_sorttab[idx],
1080                                   dwAddr, Line)) return FALSE;
1081     *pdwDisplacement = dwAddr - Line->Address;
1082     return TRUE;
1083 }
1084
1085 /******************************************************************
1086  *              copy_line_64_from_32 (internal)
1087  *
1088  */
1089 static void copy_line_64_from_32(IMAGEHLP_LINE64* l64, const IMAGEHLP_LINE* l32)
1090
1091 {
1092     l64->Key = l32->Key;
1093     l64->LineNumber = l32->LineNumber;
1094     l64->FileName = l32->FileName;
1095     l64->Address = l32->Address;
1096 }
1097
1098 /******************************************************************
1099  *              copy_line_32_from_64 (internal)
1100  *
1101  */
1102 static void copy_line_32_from_64(IMAGEHLP_LINE* l32, const IMAGEHLP_LINE64* l64)
1103
1104 {
1105     l32->Key = l64->Key;
1106     l32->LineNumber = l64->LineNumber;
1107     l32->FileName = l64->FileName;
1108     l32->Address = l64->Address;
1109 }
1110
1111 /******************************************************************
1112  *              SymGetLineFromAddr64 (DBGHELP.@)
1113  *
1114  */
1115 BOOL WINAPI SymGetLineFromAddr64(HANDLE hProcess, DWORD64 dwAddr, 
1116                                  PDWORD pdwDisplacement, PIMAGEHLP_LINE64 Line)
1117 {
1118     IMAGEHLP_LINE       line32;
1119
1120     if (Line->SizeOfStruct < sizeof(*Line)) return FALSE;
1121     if (!validate_addr64(dwAddr)) return FALSE;
1122     line32.SizeOfStruct = sizeof(line32);
1123     if (!SymGetLineFromAddr(hProcess, (DWORD)dwAddr, pdwDisplacement, &line32))
1124         return FALSE;
1125     copy_line_64_from_32(Line, &line32);
1126     return TRUE;
1127 }
1128
1129 /******************************************************************
1130  *              SymGetLinePrev (DBGHELP.@)
1131  *
1132  */
1133 BOOL WINAPI SymGetLinePrev(HANDLE hProcess, PIMAGEHLP_LINE Line)
1134 {
1135     struct process*     pcs = process_find_by_handle(hProcess);
1136     struct module*      module;
1137     struct line_info*   li;
1138     BOOL                in_search = FALSE;
1139
1140     TRACE("(%p %p)\n", hProcess, Line);
1141
1142     if (Line->SizeOfStruct < sizeof(*Line)) return FALSE;
1143
1144     if (!pcs) return FALSE;
1145     module = module_find_by_addr(pcs, Line->Address, DMT_UNKNOWN);
1146     if (!(module = module_get_debug(pcs, module))) return FALSE;
1147
1148     if (Line->Key == 0) return FALSE;
1149     li = (struct line_info*)Line->Key;
1150     /* things are a bit complicated because when we encounter a DLIT_SOURCEFILE
1151      * element we have to go back until we find the prev one to get the real
1152      * source file name for the DLIT_OFFSET element just before 
1153      * the first DLIT_SOURCEFILE
1154      */
1155     while (!li->is_first)
1156     {
1157         li--;
1158         if (!li->is_source_file)
1159         {
1160             Line->LineNumber = li->line_number;
1161             Line->Address    = li->u.pc_offset;
1162             Line->Key        = li;
1163             if (!in_search) return TRUE;
1164         }
1165         else
1166         {
1167             if (in_search)
1168             {
1169                 Line->FileName = (char*)source_get(module, li->u.source_file);
1170                 return TRUE;
1171             }
1172             in_search = TRUE;
1173         }
1174     }
1175     SetLastError(ERROR_NO_MORE_ITEMS); /* FIXME */
1176     return FALSE;
1177 }
1178
1179 /******************************************************************
1180  *              SymGetLinePrev64 (DBGHELP.@)
1181  *
1182  */
1183 BOOL WINAPI SymGetLinePrev64(HANDLE hProcess, PIMAGEHLP_LINE64 Line)
1184 {
1185     IMAGEHLP_LINE       line32;
1186
1187     line32.SizeOfStruct = sizeof(line32);
1188     copy_line_32_from_64(&line32, Line);
1189     if (!SymGetLinePrev(hProcess, &line32)) return FALSE;
1190     copy_line_64_from_32(Line, &line32);
1191     return TRUE;
1192 }
1193     
1194 BOOL symt_get_func_line_next(struct module* module, PIMAGEHLP_LINE line)
1195 {
1196     struct line_info*   li;
1197
1198     if (line->Key == 0) return FALSE;
1199     li = (struct line_info*)line->Key;
1200     while (!li->is_last)
1201     {
1202         li++;
1203         if (!li->is_source_file)
1204         {
1205             line->LineNumber = li->line_number;
1206             line->Address    = li->u.pc_offset;
1207             line->Key        = li;
1208             return TRUE;
1209         }
1210         line->FileName = (char*)source_get(module, li->u.source_file);
1211     }
1212     return FALSE;
1213 }
1214
1215 /******************************************************************
1216  *              SymGetLineNext (DBGHELP.@)
1217  *
1218  */
1219 BOOL WINAPI SymGetLineNext(HANDLE hProcess, PIMAGEHLP_LINE Line)
1220 {
1221     struct process*     pcs = process_find_by_handle(hProcess);
1222     struct module*      module;
1223
1224     TRACE("(%p %p)\n", hProcess, Line);
1225
1226     if (Line->SizeOfStruct < sizeof(*Line)) return FALSE;
1227     if (!pcs) return FALSE;
1228     module = module_find_by_addr(pcs, Line->Address, DMT_UNKNOWN);
1229     if (!(module = module_get_debug(pcs, module))) return FALSE;
1230
1231     if (symt_get_func_line_next(module, Line)) return TRUE;
1232     SetLastError(ERROR_NO_MORE_ITEMS); /* FIXME */
1233     return FALSE;
1234 }
1235
1236 /******************************************************************
1237  *              SymGetLineNext64 (DBGHELP.@)
1238  *
1239  */
1240 BOOL WINAPI SymGetLineNext64(HANDLE hProcess, PIMAGEHLP_LINE64 Line)
1241 {
1242     IMAGEHLP_LINE       line32;
1243
1244     line32.SizeOfStruct = sizeof(line32);
1245     copy_line_32_from_64(&line32, Line);
1246     if (!SymGetLineNext(hProcess, &line32)) return FALSE;
1247     copy_line_64_from_32(Line, &line32);
1248     return TRUE;
1249 }
1250     
1251 /***********************************************************************
1252  *              SymFunctionTableAccess (DBGHELP.@)
1253  */
1254 PVOID WINAPI SymFunctionTableAccess(HANDLE hProcess, DWORD AddrBase)
1255 {
1256     FIXME("(%p, 0x%08lx): stub\n", hProcess, AddrBase);
1257     SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
1258     return FALSE;
1259 }
1260
1261 /***********************************************************************
1262  *              SymUnDName (DBGHELP.@)
1263  */
1264 BOOL WINAPI SymUnDName(PIMAGEHLP_SYMBOL sym, LPSTR UnDecName, DWORD UnDecNameLength)
1265 {
1266     TRACE("(%p %s %lu): stub\n", sym, UnDecName, UnDecNameLength);
1267     return UnDecorateSymbolName(sym->Name, UnDecName, UnDecNameLength, 
1268                                 UNDNAME_COMPLETE) != 0;
1269 }
1270
1271 static void* und_alloc(size_t len) { return HeapAlloc(GetProcessHeap(), 0, len); }
1272 static void  und_free (void* ptr)  { HeapFree(GetProcessHeap(), 0, ptr); }
1273
1274 /***********************************************************************
1275  *              UnDecorateSymbolName (DBGHELP.@)
1276  */
1277 DWORD WINAPI UnDecorateSymbolName(LPCSTR DecoratedName, LPSTR UnDecoratedName,
1278                                   DWORD UndecoratedLength, DWORD Flags)
1279 {
1280     /* undocumented from msvcrt */
1281     static char* (*p_undname)(char*, const char*, int, void* (*)(size_t), void (*)(void*), unsigned short);
1282     static WCHAR szMsvcrt[] = {'m','s','v','c','r','t','.','d','l','l',0};
1283
1284     TRACE("(%s, %p, %ld, 0x%08lx): stub\n",
1285           debugstr_a(DecoratedName), UnDecoratedName, UndecoratedLength, Flags);
1286
1287     if (!p_undname)
1288     {
1289         if (!hMsvcrt) hMsvcrt = LoadLibraryW(szMsvcrt);
1290         if (hMsvcrt) p_undname = (void*)GetProcAddress(hMsvcrt, "__unDName");
1291         if (!p_undname) return 0;
1292     }
1293
1294     if (!UnDecoratedName) return 0;
1295     if (!p_undname(UnDecoratedName, DecoratedName, UndecoratedLength, 
1296                    und_alloc, und_free, Flags))
1297         return 0;
1298     return strlen(UnDecoratedName);
1299 }
1300
1301 /******************************************************************
1302  *              SymMatchString (DBGHELP.@)
1303  *
1304  */
1305 BOOL WINAPI SymMatchString(PCSTR string, PCSTR re, BOOL _case)
1306 {
1307     regex_t     preg;
1308     BOOL        ret;
1309
1310     TRACE("%s %s %c\n", string, re, _case ? 'Y' : 'N');
1311
1312     compile_regex(re, -1, &preg, _case);
1313     ret = regexec(&preg, string, 0, NULL, 0) == 0;
1314     regfree(&preg);
1315     return ret;
1316 }
1317
1318 /******************************************************************
1319  *              SymSearch (DBGHELP.@)
1320  */
1321 BOOL WINAPI SymSearch(HANDLE hProcess, ULONG64 BaseOfDll, DWORD Index,
1322                       DWORD SymTag, PCSTR Mask, DWORD64 Address,
1323                       PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
1324                       PVOID UserContext, DWORD Options)
1325 {
1326     TRACE("(%p %s %lu %lu %s %s %p %p %lx)\n",
1327           hProcess, wine_dbgstr_longlong(BaseOfDll), Index, SymTag, Mask, 
1328           wine_dbgstr_longlong(Address), EnumSymbolsCallback,
1329           UserContext, Options);
1330
1331     if (Index != 0)
1332     {
1333         FIXME("Unsupported searching for a given Index (%lu)\n", Index);
1334         SetLastError(ERROR_INVALID_PARAMETER);
1335         return FALSE;
1336     }
1337     if (SymTag != 0)
1338     {
1339         FIXME("Unsupported searching for a given SymTag (%lu)\n", SymTag);
1340         SetLastError(ERROR_INVALID_PARAMETER);
1341         return FALSE;
1342     }
1343     if (Address != 0)
1344     {
1345         FIXME("Unsupported searching for a given Address (%s)\n", wine_dbgstr_longlong(Address));
1346         SetLastError(ERROR_INVALID_PARAMETER);
1347         return FALSE;
1348     }
1349     if (Options != SYMSEARCH_GLOBALSONLY)
1350     {
1351         FIXME("Unsupported searching with options (%lx)\n", Options);
1352         SetLastError(ERROR_INVALID_PARAMETER);
1353         return FALSE;
1354     }
1355     return SymEnumSymbols(hProcess, BaseOfDll, Mask, EnumSymbolsCallback, UserContext);
1356 }