1 /* -*- tab-width: 8; c-basic-offset: 4 -*- */
4 * File stabs.c - read stabs information from the wine executable itself.
6 * Copyright (C) 1996, Eric Youngdale.
7 * 1999, 2000 Eric Pouech
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 * Maintenance Information
25 * -----------------------
27 * For documentation on the stabs format see for example
28 * The "stabs" debug format
29 * by Julia Menapace, Jim Kingdon, David Mackenzie
31 * available (hopefully) from http:\\sources.redhat.com\gdb\onlinedocs
36 #include <sys/types.h>
39 #ifdef HAVE_SYS_MMAN_H
47 #define PATH_MAX MAX_PATH
52 #if defined(__svr4__) || defined(__sun)
63 #ifdef HAVE_SYS_LINK_H
64 # include <sys/link.h>
95 typedef struct tagELF_DBG_INFO
97 unsigned long elf_addr;
103 struct stab_nlist *n_next;
106 unsigned char n_type;
109 unsigned long n_value;
112 static void stab_strcpy(char * dest, int sz, const char * source)
115 * A strcpy routine that stops when we hit the ':' character.
116 * Faster than copying the whole thing, and then nuking the
119 while(*source != '\0' && *source != ':' && sz-- > 0)
129 struct datatype** vector;
133 #define MAX_INCLUDES 5120
135 static include_def* include_defs = NULL;
136 static int num_include_def = 0;
137 static int num_alloc_include_def = 0;
138 static int cu_include_stack[MAX_INCLUDES];
139 static int cu_include_stk_idx = 0;
140 static struct datatype** cu_vector = NULL;
141 static int cu_nrofentries = 0;
145 DEBUG_CreateInclude(const char* file, unsigned long val)
147 if (num_include_def == num_alloc_include_def)
149 num_alloc_include_def += 256;
150 include_defs = DBG_realloc(include_defs, sizeof(include_defs[0])*num_alloc_include_def);
151 memset(include_defs+num_include_def, 0, sizeof(include_defs[0])*256);
153 include_defs[num_include_def].name = DBG_strdup(file);
154 include_defs[num_include_def].value = val;
155 include_defs[num_include_def].vector = NULL;
156 include_defs[num_include_def].nrofentries = 0;
158 return num_include_def++;
163 DEBUG_FindInclude(const char* file, unsigned long val)
167 for (i = 0; i < num_include_def; i++)
169 if (val == include_defs[i].value &&
170 strcmp(file, include_defs[i].name) == 0)
178 DEBUG_AddInclude(int idx)
180 ++cu_include_stk_idx;
182 /* is this happen, just bump MAX_INCLUDES */
183 /* we could also handle this as another dynarray */
184 assert(cu_include_stk_idx < MAX_INCLUDES);
186 cu_include_stack[cu_include_stk_idx] = idx;
187 return cu_include_stk_idx;
192 DEBUG_ResetIncludes(void)
195 * The datatypes that we would need to use are reset when
196 * we start a new file. (at least the ones in filenr == 0
198 cu_include_stk_idx = 0;/* keep 0 as index for the .c file itself */
199 memset(cu_vector, 0, sizeof(cu_vector[0]) * cu_nrofentries);
204 DEBUG_FreeIncludes(void)
208 DEBUG_ResetIncludes();
210 for (i = 0; i < num_include_def; i++)
212 DBG_free(include_defs[i].name);
213 DBG_free(include_defs[i].vector);
215 DBG_free(include_defs);
218 num_alloc_include_def = 0;
226 DEBUG_FileSubNr2StabEnum(int filenr, int subnr)
228 struct datatype** ret;
230 /* DEBUG_Printf(DBG_CHN_MESG, "creating type id for (%d,%d)\n", filenr, subnr); */
232 /* FIXME: I could perhaps create a dummy include_def for each compilation
233 * unit which would allow not to handle those two cases separately
237 if (cu_nrofentries <= subnr)
239 cu_vector = DBG_realloc(cu_vector, sizeof(cu_vector[0])*(subnr+1));
240 memset(cu_vector+cu_nrofentries, 0, sizeof(cu_vector[0])*(subnr+1-cu_nrofentries));
241 cu_nrofentries = subnr + 1;
243 ret = &cu_vector[subnr];
249 assert(filenr <= cu_include_stk_idx);
251 idef = &include_defs[cu_include_stack[filenr]];
253 if (idef->nrofentries <= subnr)
255 idef->vector = DBG_realloc(idef->vector, sizeof(idef->vector[0])*(subnr+1));
256 memset(idef->vector + idef->nrofentries, 0, sizeof(idef->vector[0])*(subnr+1-idef->nrofentries));
257 idef->nrofentries = subnr + 1;
259 ret = &idef->vector[subnr];
261 /* DEBUG_Printf(DBG_CHN_MESG,"(%d,%d) is %d\n",filenr,subnr,ret); */
267 DEBUG_ReadTypeEnum(char **x) {
272 filenr=strtol(*x,x,10); /* <int> */
274 subnr=strtol(*x,x,10); /* <int> */
278 subnr = strtol(*x,x,10); /* <int> */
280 return DEBUG_FileSubNr2StabEnum(filenr,subnr);
283 struct ParseTypedefData {
289 static int DEBUG_PTS_ReadTypedef(struct ParseTypedefData* ptd, const char* typename,
290 struct datatype** dt);
292 static int DEBUG_PTS_ReadID(struct ParseTypedefData* ptd)
294 char* first = ptd->ptr;
297 if ((ptd->ptr = strchr(ptd->ptr, ':')) == NULL) return -1;
298 len = ptd->ptr - first;
299 if (len >= sizeof(ptd->buf) - ptd->idx) return -1;
300 memcpy(ptd->buf + ptd->idx, first, len);
301 ptd->buf[ptd->idx + len] = '\0';
303 ptd->ptr++; /* ':' */
307 static int DEBUG_PTS_ReadNum(struct ParseTypedefData* ptd, int* v)
311 *v = strtol(ptd->ptr, &last, 10);
312 if (last == ptd->ptr) return -1;
317 static int DEBUG_PTS_ReadTypeReference(struct ParseTypedefData* ptd,
318 int* filenr, int* subnr)
320 if (*ptd->ptr == '(') {
321 /* '(' <int> ',' <int> ')' */
323 if (DEBUG_PTS_ReadNum(ptd, filenr) == -1) return -1;
324 if (*ptd->ptr++ != ',') return -1;
325 if (DEBUG_PTS_ReadNum(ptd, subnr) == -1) return -1;
326 if (*ptd->ptr++ != ')') return -1;
329 if (DEBUG_PTS_ReadNum(ptd, subnr) == -1) return -1;
334 static int DEBUG_PTS_ReadRange(struct ParseTypedefData* ptd, struct datatype** dt,
337 /* type ';' <int> ';' <int> ';' */
338 if (DEBUG_PTS_ReadTypedef(ptd, NULL, dt) == -1) return -1;
339 if (*ptd->ptr++ != ';') return -1; /* ';' */
340 if (DEBUG_PTS_ReadNum(ptd, lo) == -1) return -1;
341 if (*ptd->ptr++ != ';') return -1; /* ';' */
342 if (DEBUG_PTS_ReadNum(ptd, hi) == -1) return -1;
343 if (*ptd->ptr++ != ';') return -1; /* ';' */
347 static inline int DEBUG_PTS_ReadMethodInfo(struct ParseTypedefData* ptd,
352 if (*ptd->ptr++ == ':')
354 if (!(tmp = strchr(ptd->ptr, ';'))) return -1;
358 if (!(*ptd->ptr >= '0' && *ptd->ptr <= '9')) return -1;
360 if (!(ptd->ptr[0] >= 'A' && *ptd->ptr <= 'D')) return -1;
362 if (*ptd->ptr++ != '.') return -1;
363 if (*ptd->ptr != ';')
367 /* some GCC versions (2.96 for example) really spit out wrongly defined
368 * stabs... in some cases, the methods are not correctly handled
369 * so just swallow the garbage until either .; (end of method)
370 * or ;; (end of struct) are found
372 if (ptd->ptr[0] == '.' && ptd->ptr[1] == ';')
377 if (ptd->ptr[0] == ';' && ptd->ptr[1] == ';')
386 static inline int DEBUG_PTS_ReadAggregate(struct ParseTypedefData* ptd,
387 struct datatype* sdt)
391 struct datatype* adt;
396 sz = strtol(ptd->ptr, &last, 10);
397 if (last == ptd->ptr) return -1;
400 doadd = DEBUG_SetStructSize(sdt, sz);
401 /* if the structure has already been filled, just redo the parsing
402 * but don't store results into the struct
403 * FIXME: there's a quite ugly memory leak in there...
406 /* Now parse the individual elements of the structure/union. */
407 while (*ptd->ptr != ';') {
408 /* agg_name : type ',' <int:offset> ',' <int:size> */
411 if (DEBUG_PTS_ReadID(ptd) == -1) return -1;
412 /* Ref. TSDF R2.130 Section 7.4. When the field name is a method name
413 * it is followed by two colons rather than one.
415 if (*ptd->ptr == ':')
419 char* psemic = strchr(ptd->ptr, ';');
420 char* psharp = strchr(ptd->ptr, '#');
422 if (!psharp || psharp > psemic)
424 struct datatype* dt = NULL;
425 /* FIXME: hack... this shall be a ctor */
426 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &dt) == -1) return -1;
427 if (DEBUG_PTS_ReadMethodInfo(ptd, dt) == -1) return -1;
428 if (*ptd->ptr++ != ';') return -1;
440 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &adt) == -1) return -1;
443 if (*ptd->ptr != ',')
445 if (!inMethod) return -1;
451 if (DEBUG_PTS_ReadNum(ptd, &ofs) == -1) return -1;
452 if (*ptd->ptr++ != ',') return -1;
453 if (DEBUG_PTS_ReadNum(ptd, &sz) == -1) return -1;
454 if (*ptd->ptr++ != ';') return -1;
456 if (doadd) DEBUG_AddStructElement(sdt, ptd->buf + idx, adt, ofs, sz);
460 ptd->ptr++; /* ';' */
464 static inline int DEBUG_PTS_ReadEnum(struct ParseTypedefData* ptd,
465 struct datatype* edt)
470 while (*ptd->ptr != ';') {
472 if (DEBUG_PTS_ReadID(ptd) == -1) return -1;
473 if (DEBUG_PTS_ReadNum(ptd, &ofs) == -1) return -1;
474 if (*ptd->ptr++ != ',') return -1;
475 DEBUG_AddStructElement(edt, ptd->buf + idx, NULL, ofs, 0);
482 static inline int DEBUG_PTS_ReadArray(struct ParseTypedefData* ptd,
483 struct datatype* adt)
486 struct datatype* rdt;
488 /* ar<typeinfo_nodef>;<int>;<int>;<typeinfo> */
490 if (*ptd->ptr++ != 'r') return -1;
491 /* FIXME: range type is lost, always assume int */
492 if (DEBUG_PTS_ReadRange(ptd, &rdt, &lo, &hi) == -1) return -1;
493 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &rdt) == -1) return -1;
495 DEBUG_SetArrayParams(adt, lo, hi, rdt);
499 static int DEBUG_PTS_ReadTypedef(struct ParseTypedefData* ptd, const char* typename,
500 struct datatype** ret_dt)
502 int idx, lo, hi, sz = -1;
503 struct datatype* new_dt = NULL; /* newly created data type */
504 struct datatype* ref_dt; /* referenced data type (pointer...) */
505 struct datatype* dt1; /* intermediate data type (scope is limited) */
506 struct datatype* dt2; /* intermediate data type: t1=t2=new_dt */
508 int filenr2 = 0, subnr2 = 0;
510 /* things are a bit complicated because of the way the typedefs are stored inside
511 * the file (we cannot keep the struct datatype** around, because address can
512 * change when realloc is done, so we must call over and over
513 * DEBUG_FileSubNr2StabEnum to keep the correct values around
514 * (however, keeping struct datatype* is valid))
516 if (DEBUG_PTS_ReadTypeReference(ptd, &filenr1, &subnr1) == -1) return -1;
518 while (*ptd->ptr == '=') {
521 DEBUG_Printf(DBG_CHN_MESG, "Bad recursion (1) in typedef\n");
524 /* first handle attribute if any */
527 if (*++ptd->ptr == 's') {
529 if (DEBUG_PTS_ReadNum(ptd, &sz) == -1) {
530 DEBUG_Printf(DBG_CHN_MESG, "Not an attribute... NIY\n");
534 if (*ptd->ptr++ != ';') return -1;
538 /* then the real definitions */
539 switch (*ptd->ptr++) {
542 new_dt = DEBUG_NewDataType(DT_POINTER, NULL);
543 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &ref_dt) == -1) return -1;
544 DEBUG_SetPointerType(new_dt, ref_dt);
546 case 'k': /* 'const' modifier */
547 case 'B': /* 'volatile' modifier */
548 /* just kinda ignore the modifier, I guess -gmt */
549 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &new_dt) == -1) return -1;
553 /* doit a two level by hand, otherwise we'd need a stack */
554 if (filenr2 || subnr2) {
555 DEBUG_Printf(DBG_CHN_MESG, "Bad recursion (2) in typedef\n");
558 if (DEBUG_PTS_ReadTypeReference(ptd, &filenr2, &subnr2) == -1) return -1;
560 dt1 = *DEBUG_FileSubNr2StabEnum(filenr1, subnr1);
561 dt2 = *DEBUG_FileSubNr2StabEnum(filenr2, subnr2);
565 filenr2 = subnr2 = 0;
566 } else if (!dt1 && !dt2) {
569 DEBUG_Printf(DBG_CHN_MESG, "Unknown condition %08lx %08lx (%s)\n",
570 (unsigned long)dt1, (unsigned long)dt2, ptd->ptr);
575 new_dt = DEBUG_NewDataType(DT_ARRAY, NULL);
576 if (DEBUG_PTS_ReadArray(ptd, new_dt) == -1) return -1;
579 new_dt = DEBUG_NewDataType(DT_BASIC, typename);
580 assert(!*DEBUG_FileSubNr2StabEnum(filenr1, subnr1));
581 *DEBUG_FileSubNr2StabEnum(filenr1, subnr1) = new_dt;
582 if (DEBUG_PTS_ReadRange(ptd, &ref_dt, &lo, &hi) == -1) return -1;
583 /* should perhaps do more here... */
586 new_dt = DEBUG_NewDataType(DT_FUNC, NULL);
587 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &ref_dt) == -1) return -1;
588 DEBUG_SetPointerType(new_dt, ref_dt);
591 new_dt = DEBUG_NewDataType(DT_ENUM, NULL);
592 if (DEBUG_PTS_ReadEnum(ptd, new_dt) == -1) return -1;
596 /* dt1 can have been already defined in a forward definition */
597 dt1 = *DEBUG_FileSubNr2StabEnum(filenr1, subnr1);
598 dt2 = DEBUG_TypeCast(DT_STRUCT, typename);
600 new_dt = DEBUG_NewDataType(DT_STRUCT, typename);
601 /* we need to set it here, because a struct can hold a pointer
604 *DEBUG_FileSubNr2StabEnum(filenr1, subnr1) = new_dt;
606 if (DEBUG_GetType(dt1) != DT_STRUCT) {
607 DEBUG_Printf(DBG_CHN_MESG,
608 "Forward declaration is not an aggregate\n");
612 /* should check typename is the same too */
615 if (DEBUG_PTS_ReadAggregate(ptd, new_dt) == -1) return -1;
618 switch (*ptd->ptr++) {
619 case 'e': lo = DT_ENUM; break;
620 case 's': case 'u': lo = DT_STRUCT; break;
625 if (DEBUG_PTS_ReadID(ptd) == -1) return -1;
626 new_dt = DEBUG_NewDataType(lo, ptd->buf + idx);
630 if (DEBUG_PTS_ReadNum(ptd, &lo) == -1) {
631 DEBUG_Printf(DBG_CHN_MESG, "Should be a number (%s)...\n", ptd->ptr);
634 enum debug_type_basic basic = DT_BASIC_LAST;
637 case 1: basic = DT_BASIC_INT; break;
638 case 2: basic = DT_BASIC_CHAR; break;
639 case 3: basic = DT_BASIC_SHORTINT; break;
640 case 4: basic = DT_BASIC_LONGINT; break;
641 case 5: basic = DT_BASIC_UCHAR; break;
642 case 6: basic = DT_BASIC_SCHAR; break;
643 case 7: basic = DT_BASIC_USHORTINT; break;
644 case 8: basic = DT_BASIC_UINT; break;
645 /* case 9: basic = DT_BASIC_UINT"; */
646 case 10: basic = DT_BASIC_ULONGINT; break;
647 case 11: basic = DT_BASIC_VOID; break;
648 case 12: basic = DT_BASIC_FLOAT; break;
649 case 13: basic = DT_BASIC_DOUBLE; break;
650 case 14: basic = DT_BASIC_LONGDOUBLE; break;
651 /* case 15: basic = DT_BASIC_INT; break; */
654 case 32: basic = DT_BASIC_BOOL1; break;
655 case 16: basic = DT_BASIC_BOOL2; break;
656 case 8: basic = DT_BASIC_BOOL4; break;
659 /* case 17: basic = DT_BASIC_SHORT real; break; */
660 /* case 18: basic = DT_BASIC_REAL; break; */
661 case 25: basic = DT_BASIC_CMPLX_FLOAT; break;
662 case 26: basic = DT_BASIC_CMPLX_DOUBLE; break;
663 /* case 30: basic = DT_BASIC_wchar"; break; */
664 case 31: basic = DT_BASIC_LONGLONGINT; break;
665 case 32: basic = DT_BASIC_ULONGLONGINT; break;
667 DEBUG_Printf(DBG_CHN_MESG,
668 "Unsupported integral type (%d/%d)\n", lo, sz);
671 if (!(new_dt = DEBUG_GetBasicType(basic))) {
672 DEBUG_Printf(DBG_CHN_MESG, "Basic type %d not found\n", basic);
675 if (*ptd->ptr++ != ';') return -1;
679 new_dt = DEBUG_NewDataType(DT_FUNC, NULL);
680 if (*ptd->ptr == '#')
683 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &ref_dt) == -1) return -1;
684 DEBUG_SetPointerType(new_dt, ref_dt);
685 if (*ptd->ptr++ != ';') return -1;
690 struct datatype* cls_dt;
691 struct datatype* pmt_dt;
693 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &cls_dt) == -1) return -1;
694 if (*ptd->ptr++ != ',') return -1;
695 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &ref_dt) == -1) return -1;
696 DEBUG_SetPointerType(new_dt, ref_dt);
697 while (*ptd->ptr++ == ',')
699 if (DEBUG_PTS_ReadTypedef(ptd, NULL, &pmt_dt) == -1) return -1;
702 if (DEBUG_PTS_ReadMethodInfo(ptd, new_dt) == -1) return -1;
706 DEBUG_Printf(DBG_CHN_MESG, "Unknown type '%c'\n", ptd->ptr[-1]);
711 if ((filenr2 || subnr2) && !*DEBUG_FileSubNr2StabEnum(filenr2, subnr2)) {
713 /* this should be a basic type, define it, or even void */
714 new_dt = DEBUG_NewDataType(DT_BASIC, typename);
716 *DEBUG_FileSubNr2StabEnum(filenr2, subnr2) = new_dt;
720 dt1 = *DEBUG_FileSubNr2StabEnum(filenr1, subnr1);
722 DEBUG_Printf(DBG_CHN_MESG, "Nothing has been defined <%s>\n", ptd->ptr);
729 *DEBUG_FileSubNr2StabEnum(filenr1, subnr1) = *ret_dt = new_dt;
733 DEBUG_Printf(DBG_CHN_MESG, "Adding (%d,%d) %s => ", filenr1, subnr1, typename);
734 DEBUG_PrintTypeCast(new_dt);
735 DEBUG_Printf(DBG_CHN_MESG, "\n");
742 static int DEBUG_ParseTypedefStab(char* ptr, const char* typename)
744 struct ParseTypedefData ptd;
748 /* check for already existing definition */
751 if ((ptd.ptr = strchr(ptr, ':'))) {
753 if (*ptd.ptr != '(') ptd.ptr++;
754 /* most of type definitions take one char, except Tt */
755 if (*ptd.ptr != '(') ptd.ptr++;
756 ret = DEBUG_PTS_ReadTypedef(&ptd, typename, &dt);
759 if (ret == -1 || *ptd.ptr) {
760 DEBUG_Printf(DBG_CHN_MESG, "Failure on %s at %s\n", ptr, ptd.ptr);
767 static struct datatype *
768 DEBUG_ParseStabType(const char * stab)
773 * Look through the stab definition, and figure out what datatype
774 * this represents. If we have something we know about, assign the
776 * According to "The \"stabs\" debug format" (Rev 2.130) the name may be
777 * a C++ name and contain double colons e.g. foo::bar::baz:t5=*6. Not
780 c = strchr(stab, ':');
786 * The next characters say more about the type (i.e. data, function, etc)
787 * of symbol. Skip them. (C++ for example may have Tt).
788 * Actually this is a very weak description; I think Tt is the only
789 * multiple combination we should see.
791 while (*c && *c != '(' && !isdigit(*c))
794 * The next is either an integer or a (integer,integer).
795 * The DEBUG_ReadTypeEnum takes care that stab_types is large enough.
797 return *DEBUG_ReadTypeEnum(&c);
800 enum DbgInfoLoad DEBUG_ParseStabs(char * addr, unsigned int load_offset,
801 unsigned int staboff, int stablen,
802 unsigned int strtaboff, int strtablen)
804 struct name_hash * curr_func = NULL;
805 struct wine_locals * curr_loc = NULL;
806 struct name_hash * curr_sym = NULL;
807 char currpath[PATH_MAX];
809 int in_external_file = FALSE;
816 unsigned int stabbufflen;
817 struct stab_nlist * stab_ptr;
820 char * subpath = NULL;
823 nstab = stablen / sizeof(struct stab_nlist);
824 stab_ptr = (struct stab_nlist *) (addr + staboff);
825 strs = (char *) (addr + strtaboff);
827 memset(currpath, 0, sizeof(currpath));
830 * Allocate a buffer into which we can build stab strings for cases
831 * where the stab is continued over multiple lines.
834 stabbuff = (char *) DBG_alloc(stabbufflen);
838 for (i = 0; i < nstab; i++, stab_ptr++)
840 ptr = strs + (unsigned int) stab_ptr->n_un.n_name;
841 if( ptr[strlen(ptr) - 1] == '\\' )
844 * Indicates continuation. Append this to the buffer, and go onto the
845 * next record. Repeat the process until we find a stab without the
846 * '/' character, as this indicates we have the whole thing.
849 if( strlen(stabbuff) + len > stabbufflen )
851 stabbufflen += 65536;
852 stabbuff = (char *) DBG_realloc(stabbuff, stabbufflen);
854 strncat(stabbuff, ptr, len - 1);
857 else if( stabbuff[0] != '\0' )
859 strcat( stabbuff, ptr);
863 if( strchr(ptr, '=') != NULL )
866 * The stabs aren't in writable memory, so copy it over so we are
867 * sure we can scribble on it.
869 if( ptr != stabbuff )
871 strcpy(stabbuff, ptr);
874 stab_strcpy(symname, sizeof(symname), ptr);
875 if (!DEBUG_ParseTypedefStab(ptr, symname)) {
876 /* skip this definition */
882 switch(stab_ptr->n_type)
886 * These are useless with ELF. They have no value, and you have to
887 * read the normal symbol table to get the address. Thus we
888 * ignore them, and when we process the normal symbol table
889 * we should do the right thing.
891 * With a.out or mingw, they actually do make some amount of sense.
893 new_value.addr.seg = 0;
894 new_value.type = DEBUG_ParseStabType(ptr);
895 new_value.addr.off = load_offset + stab_ptr->n_value;
896 new_value.cookie = DV_TARGET;
898 stab_strcpy(symname, sizeof(symname), ptr);
900 curr_sym = DEBUG_AddSymbol( symname, &new_value, currpath,
901 SYM_WINE | SYM_DATA | SYM_INVALID );
903 curr_sym = DEBUG_AddSymbol( symname, &new_value, currpath,
904 SYM_WINE | SYM_DATA );
910 * We need to keep track of these so we get symbol scoping
911 * right for local variables. For now, we just ignore them.
912 * The hooks are already there for dealing with this however,
913 * so all we need to do is to keep count of the nesting level,
914 * and find the RBRAC for each matching LBRAC.
920 * These are static symbols and BSS symbols.
922 new_value.addr.seg = 0;
923 new_value.type = DEBUG_ParseStabType(ptr);
924 new_value.addr.off = load_offset + stab_ptr->n_value;
925 new_value.cookie = DV_TARGET;
927 stab_strcpy(symname, sizeof(symname), ptr);
928 curr_sym = DEBUG_AddSymbol( symname, &new_value, currpath,
929 SYM_WINE | SYM_DATA );
933 * These are function parameters.
935 if( curr_func != NULL && !in_external_file )
937 stab_strcpy(symname, sizeof(symname), ptr);
938 curr_loc = DEBUG_AddLocal( curr_func, 0,
939 stab_ptr->n_value, 0, 0, symname );
940 DEBUG_SetLocalSymbolType( curr_loc, DEBUG_ParseStabType(ptr) );
944 if( curr_func != NULL && !in_external_file )
946 stab_strcpy(symname, sizeof(symname), ptr);
947 curr_loc = DEBUG_AddLocal( curr_func, stab_ptr->n_value + 1,
949 DEBUG_SetLocalSymbolType( curr_loc, DEBUG_ParseStabType(ptr) );
953 if( curr_func != NULL && !in_external_file )
955 stab_strcpy(symname, sizeof(symname), ptr);
956 curr_loc = DEBUG_AddLocal( curr_func, 0,
957 stab_ptr->n_value, 0, 0, symname );
958 DEBUG_SetLocalSymbolType( curr_loc, DEBUG_ParseStabType(ptr) );
963 * This is a line number. These are always relative to the start
964 * of the function (N_FUN), and this makes the lookup easier.
966 if( curr_func != NULL && !in_external_file )
969 DEBUG_AddLineNumber(curr_func, stab_ptr->n_desc,
974 * This isn't right. The order of the stabs is different under
975 * a.out, and as a result we would end up attaching the line
976 * number to the wrong function.
978 DEBUG_AddLineNumber(curr_func, stab_ptr->n_desc,
979 stab_ptr->n_value - curr_func->addr.off);
986 * First, clean up the previous function we were working on.
988 DEBUG_Normalize(curr_func);
991 * For now, just declare the various functions. Later
992 * on, we will add the line number information and the
995 if( !in_external_file)
997 stab_strcpy(symname, sizeof(symname), ptr);
1000 new_value.addr.seg = 0;
1001 new_value.type = DEBUG_ParseStabType(ptr);
1002 new_value.addr.off = load_offset + stab_ptr->n_value;
1003 new_value.cookie = DV_TARGET;
1005 * Copy the string to a temp buffer so we
1006 * can kill everything after the ':'. We do
1007 * it this way because otherwise we end up dirtying
1008 * all of the pages related to the stabs, and that
1009 * sucks up swap space like crazy.
1012 curr_func = DEBUG_AddSymbol( symname, &new_value, currpath,
1013 SYM_WINE | SYM_FUNC | SYM_INVALID );
1015 curr_func = DEBUG_AddSymbol( symname, &new_value, currpath,
1016 SYM_WINE | SYM_FUNC );
1021 /* some GCC seem to use a N_FUN "" to mark the end of a function */
1028 * Don't add line number information for this function
1036 * This indicates a new source file. Append the records
1037 * together, to build the correct path name.
1041 * With a.out, there is no NULL string N_SO entry at the end of
1042 * the file. Thus when we find non-consecutive entries,
1043 * we consider that a new file is started.
1045 if( last_nso < i-1 )
1048 DEBUG_Normalize(curr_func);
1053 if( *ptr == '\0' ) /* end of N_SO file */
1059 DEBUG_Normalize(curr_func);
1065 strcat(currpath, ptr);
1067 strcpy(currpath, ptr);
1069 DEBUG_ResetIncludes();
1075 * This indicates we are including stuff from an include file.
1076 * If this is the main source, enable the debug stuff, otherwise
1079 in_external_file = !(subpath == NULL || strcmp(ptr, subpath) == 0);
1080 in_external_file = FALSE; /* FIXME EPP hack FIXME */;
1084 strtabinc = stab_ptr->n_value;
1085 DEBUG_Normalize(curr_func);
1090 * Ignore this. We don't care what it points to.
1094 DEBUG_AddInclude(DEBUG_CreateInclude(ptr, stab_ptr->n_value));
1099 DEBUG_AddInclude(DEBUG_FindInclude(ptr, stab_ptr->n_value));
1103 * Always ignore these. GCC doesn't even generate them.
1107 DEBUG_Printf(DBG_CHN_MESG, "Unknown stab type 0x%02x\n", stab_ptr->n_type);
1114 DEBUG_Printf(DBG_CHN_MESG, "0x%02x %x %s\n", stab_ptr->n_type,
1115 (unsigned int) stab_ptr->n_value,
1116 strs + (unsigned int) stab_ptr->n_un.n_name);
1120 DEBUG_FreeIncludes();
1128 * Walk through the entire symbol table and add any symbols we find there.
1129 * This can be used in cases where we have stripped ELF shared libraries,
1130 * or it can be used in cases where we have data symbols for which the address
1131 * isn't encoded in the stabs.
1133 * This is all really quite easy, since we don't have to worry about line
1134 * numbers or local data variables.
1136 static int DEBUG_ProcessElfSymtab(DBG_MODULE* module, char* addr,
1137 u_long load_addr, Elf32_Shdr* symtab,
1140 char * curfile = NULL;
1141 struct name_hash * curr_sym = NULL;
1144 DBG_VALUE new_value;
1150 symp = (Elf32_Sym *) (addr + symtab->sh_offset);
1151 nsym = symtab->sh_size / sizeof(*symp);
1152 strp = (char *) (addr + strtab->sh_offset);
1154 for (i = 0; i < nsym; i++, symp++)
1157 * Ignore certain types of entries which really aren't of that much
1160 if( ELF32_ST_TYPE(symp->st_info) == STT_SECTION ||
1161 symp->st_shndx == STN_UNDEF )
1166 symname = strp + symp->st_name;
1169 * Save the name of the current file, so we have a way of tracking
1170 * static functions/data.
1172 if( ELF32_ST_TYPE(symp->st_info) == STT_FILE )
1179 * See if we already have something for this symbol.
1180 * If so, ignore this entry, because it would have come from the
1181 * stabs or from a previous symbol. If the value is different,
1182 * we will have to keep the darned thing, because there can be
1183 * multiple local symbols by the same name.
1185 if( (DEBUG_GetSymbolValue(symname, -1, &new_value, FALSE ) == gsv_found)
1186 && (new_value.addr.off == (load_addr + symp->st_value)) )
1189 new_value.addr.seg = 0;
1190 new_value.type = NULL;
1191 new_value.addr.off = load_addr + symp->st_value;
1192 new_value.cookie = DV_TARGET;
1193 flags = SYM_WINE | ((ELF32_ST_TYPE(symp->st_info) == STT_FUNC)
1194 ? SYM_FUNC : SYM_DATA);
1195 if( ELF32_ST_BIND(symp->st_info) == STB_GLOBAL )
1196 curr_sym = DEBUG_AddSymbol( symname, &new_value, NULL, flags );
1198 curr_sym = DEBUG_AddSymbol( symname, &new_value, curfile, flags );
1201 * Record the size of the symbol. This can come in handy in
1202 * some cases. Not really used yet, however.
1204 if( symp->st_size != 0 )
1205 DEBUG_SetSymbolSize(curr_sym, symp->st_size);
1212 * Loads the symbolic information from ELF module stored in 'filename'
1213 * the module has been loaded at 'load_offset' address, so symbols' address
1214 * relocation is performed
1216 * -1 if the file cannot be found/opened
1217 * 0 if the file doesn't contain symbolic info (or this info cannot be
1221 enum DbgInfoLoad DEBUG_LoadElfStabs(DBG_MODULE* module)
1223 enum DbgInfoLoad dil = DIL_ERROR;
1224 char* addr = (char*)0xffffffff;
1226 struct stat statbuf;
1234 if (module->type != DMT_ELF || !module->elf_info) {
1235 DEBUG_Printf(DBG_CHN_ERR, "Bad elf module '%s'\n", module->module_name);
1239 /* check that the file exists, and that the module hasn't been loaded yet */
1240 if (stat(module->module_name, &statbuf) == -1) goto leave;
1241 if (S_ISDIR(statbuf.st_mode)) goto leave;
1244 * Now open the file, so that we can mmap() it.
1246 if ((fd = open(module->module_name, O_RDONLY)) == -1) goto leave;
1250 * Now mmap() the file.
1252 addr = mmap(0, statbuf.st_size, PROT_READ, MAP_PRIVATE, fd, 0);
1253 if (addr == (char*)0xffffffff) goto leave;
1256 * Next, we need to find a few of the internal ELF headers within
1257 * this thing. We need the main executable header, and the section
1260 ehptr = (Elf32_Ehdr*) addr;
1261 spnt = (Elf32_Shdr*) (addr + ehptr->e_shoff);
1262 shstrtab = (addr + spnt[ehptr->e_shstrndx].sh_offset);
1264 stabsect = stabstrsect = -1;
1266 for (i = 0; i < ehptr->e_shnum; i++) {
1267 if (strcmp(shstrtab + spnt[i].sh_name, ".stab") == 0)
1270 if (strcmp(shstrtab + spnt[i].sh_name, ".stabstr") == 0)
1274 if (stabsect == -1 || stabstrsect == -1) {
1275 DEBUG_Printf(DBG_CHN_WARN, "No .stab section\n");
1280 * OK, now just parse all of the stabs.
1282 if (DEBUG_ParseStabs(addr,
1283 module->elf_info->elf_addr,
1284 spnt[stabsect].sh_offset,
1285 spnt[stabsect].sh_size,
1286 spnt[stabstrsect].sh_offset,
1287 spnt[stabstrsect].sh_size)) {
1291 DEBUG_Printf(DBG_CHN_WARN, "Couldn't read correctly read stabs\n");
1295 for (i = 0; i < ehptr->e_shnum; i++) {
1296 if ( (strcmp(shstrtab + spnt[i].sh_name, ".symtab") == 0)
1297 && (spnt[i].sh_type == SHT_SYMTAB))
1298 DEBUG_ProcessElfSymtab(module, addr, module->elf_info->elf_addr,
1299 spnt + i, spnt + spnt[i].sh_link);
1301 if ( (strcmp(shstrtab + spnt[i].sh_name, ".dynsym") == 0)
1302 && (spnt[i].sh_type == SHT_DYNSYM))
1303 DEBUG_ProcessElfSymtab(module, addr, module->elf_info->elf_addr,
1304 spnt + i, spnt + spnt[i].sh_link);
1308 if (addr != (char*)0xffffffff) munmap(addr, statbuf.st_size);
1309 if (fd != -1) close(fd);
1315 * Loads the information for ELF module stored in 'filename'
1316 * the module has been loaded at 'load_offset' address
1318 * -1 if the file cannot be found/opened
1319 * 0 if the file doesn't contain symbolic info (or this info cannot be
1323 static enum DbgInfoLoad DEBUG_ProcessElfFile(const char* filename,
1324 unsigned int load_offset,
1325 unsigned int* dyn_addr)
1327 static const unsigned char elf_signature[4] = { ELFMAG0, ELFMAG1, ELFMAG2, ELFMAG3 };
1328 enum DbgInfoLoad dil = DIL_ERROR;
1329 char* addr = (char*)0xffffffff;
1331 struct stat statbuf;
1337 DBG_MODULE* module = NULL;
1341 DEBUG_Printf(DBG_CHN_TRACE, "Processing elf file '%s'\n", filename);
1343 /* check that the file exists, and that the module hasn't been loaded yet */
1344 if (stat(filename, &statbuf) == -1) goto leave;
1347 * Now open the file, so that we can mmap() it.
1349 if ((fd = open(filename, O_RDONLY)) == -1) goto leave;
1352 * Now mmap() the file.
1354 addr = mmap(0, statbuf.st_size, PROT_READ, MAP_PRIVATE, fd, 0);
1355 if (addr == (char*)0xffffffff) goto leave;
1360 * Next, we need to find a few of the internal ELF headers within
1361 * this thing. We need the main executable header, and the section
1364 ehptr = (Elf32_Ehdr*) addr;
1365 if (memcmp( ehptr->e_ident, elf_signature, sizeof(elf_signature) )) goto leave;
1367 spnt = (Elf32_Shdr*) (addr + ehptr->e_shoff);
1368 shstrtab = (addr + spnt[ehptr->e_shstrndx].sh_offset);
1370 /* if non relocatable ELF, then remove fixed address from computation
1371 * otherwise, all addresses are zero based
1373 delta = (load_offset == 0) ? ehptr->e_entry : 0;
1375 /* grab size of module once loaded in memory */
1376 ppnt = (Elf32_Phdr*) (addr + ehptr->e_phoff);
1378 for (i = 0; i < ehptr->e_phnum; i++) {
1379 if (ppnt[i].p_type != PT_LOAD) continue;
1380 if (size < ppnt[i].p_vaddr - delta + ppnt[i].p_memsz)
1381 size = ppnt[i].p_vaddr - delta + ppnt[i].p_memsz;
1384 for (i = 0; i < ehptr->e_shnum; i++)
1386 if (strcmp(shstrtab + spnt[i].sh_name, ".bss") == 0 &&
1387 spnt[i].sh_type == SHT_NOBITS)
1389 if (size < spnt[i].sh_addr - delta + spnt[i].sh_size)
1390 size = spnt[i].sh_addr - delta + spnt[i].sh_size;
1392 if (strcmp(shstrtab + spnt[i].sh_name, ".dynamic") == 0 &&
1393 spnt[i].sh_type == SHT_DYNAMIC)
1395 if (dyn_addr) *dyn_addr = spnt[i].sh_addr;
1399 module = DEBUG_RegisterELFModule((load_offset == 0) ? ehptr->e_entry : load_offset,
1406 if ((module->elf_info = DBG_alloc(sizeof(ELF_DBG_INFO))) == NULL) {
1407 DEBUG_Printf(DBG_CHN_ERR, "OOM\n");
1411 module->elf_info->elf_addr = load_offset;
1412 dil = DEBUG_LoadElfStabs(module);
1415 if (addr != (char*)0xffffffff) munmap(addr, statbuf.st_size);
1416 if (fd != -1) close(fd);
1417 if (module) module->dil = dil;
1422 static enum DbgInfoLoad DEBUG_ProcessElfFileFromPath(const char * filename,
1423 unsigned int load_offset,
1424 unsigned int* dyn_addr,
1427 enum DbgInfoLoad dil = DIL_ERROR;
1431 if (!path) return -1;
1433 for (s = paths = DBG_strdup(path); s && *s; s = (t) ? (t+1) : NULL) {
1436 fn = (char*)DBG_alloc(strlen(filename) + 1 + strlen(s) + 1);
1440 strcat(fn, filename);
1441 dil = DEBUG_ProcessElfFile(fn, load_offset, dyn_addr);
1443 if (dil != DIL_ERROR) break;
1444 s = (t) ? (t+1) : NULL;
1451 static enum DbgInfoLoad DEBUG_ProcessElfObject(const char* filename,
1452 unsigned int load_offset,
1453 unsigned int* dyn_addr)
1455 enum DbgInfoLoad dil = DIL_ERROR;
1457 if (filename == NULL) return DIL_ERROR;
1458 if (DEBUG_FindModuleByName(filename, DMT_ELF)) return DIL_LOADED;
1460 if (strstr (filename, "libstdc++")) return DIL_ERROR; /* We know we can't do it */
1461 dil = DEBUG_ProcessElfFile(filename, load_offset, dyn_addr);
1463 /* if relative pathname, try some absolute base dirs */
1464 if (dil == DIL_ERROR && !strchr(filename, '/')) {
1465 dil = DEBUG_ProcessElfFileFromPath(filename, load_offset, dyn_addr, getenv("PATH"));
1466 if (dil == DIL_ERROR)
1467 dil = DEBUG_ProcessElfFileFromPath(filename, load_offset, dyn_addr, getenv("LD_LIBRARY_PATH"));
1468 if (dil == DIL_ERROR)
1469 dil = DEBUG_ProcessElfFileFromPath(filename, load_offset, dyn_addr, getenv("WINEDLLPATH"));
1472 DEBUG_ReportDIL(dil, "ELF", filename, load_offset);
1477 static BOOL DEBUG_WalkList(struct r_debug* dbg_hdr)
1485 * Now walk the linked list. In all known ELF implementations,
1486 * the dynamic loader maintains this linked list for us. In some
1487 * cases the first entry doesn't appear with a name, in other cases it
1490 for (lm_addr = (u_long)dbg_hdr->r_map; lm_addr; lm_addr = (u_long)lm.l_next) {
1491 if (!DEBUG_READ_MEM_VERBOSE((void*)lm_addr, &lm, sizeof(lm)))
1494 if (lm.l_addr != 0 &&
1495 DEBUG_READ_MEM_VERBOSE((void*)lm.l_addr, &ehdr, sizeof(ehdr)) &&
1496 ehdr.e_type == ET_DYN && /* only look at dynamic modules */
1497 lm.l_name != NULL &&
1498 DEBUG_READ_MEM_VERBOSE((void*)lm.l_name, bufstr, sizeof(bufstr))) {
1499 bufstr[sizeof(bufstr) - 1] = '\0';
1500 DEBUG_ProcessElfObject(bufstr, (unsigned)lm.l_addr, NULL);
1507 static BOOL DEBUG_RescanElf(void)
1509 struct r_debug dbg_hdr;
1511 if (!DEBUG_CurrProcess ||
1512 !DEBUG_READ_MEM_VERBOSE((void*)DEBUG_CurrProcess->dbg_hdr_addr, &dbg_hdr, sizeof(dbg_hdr)))
1515 switch (dbg_hdr.r_state) {
1517 DEBUG_WalkList(&dbg_hdr);
1518 DEBUG_CheckDelayedBP();
1523 /* FIXME: this is not currently handled, would need some kind of mark&sweep algo */
1529 enum DbgInfoLoad DEBUG_ReadExecutableDbgInfo(const char* exe_name)
1532 struct r_debug dbg_hdr;
1533 enum DbgInfoLoad dil = DIL_NOINFO;
1534 unsigned int dyn_addr;
1537 * Make sure we can stat and open this file.
1539 if (exe_name == NULL) goto leave;
1540 DEBUG_ProcessElfObject(exe_name, 0, &dyn_addr);
1543 if (!DEBUG_READ_MEM_VERBOSE((void*)dyn_addr, &dyn, sizeof(dyn)))
1545 dyn_addr += sizeof(dyn);
1546 } while (dyn.d_tag != DT_DEBUG && dyn.d_tag != DT_NULL);
1547 if (dyn.d_tag == DT_NULL) goto leave;
1550 * OK, now dig into the actual tables themselves.
1552 if (!DEBUG_READ_MEM_VERBOSE((void*)dyn.d_un.d_ptr, &dbg_hdr, sizeof(dbg_hdr)))
1555 assert(!DEBUG_CurrProcess->dbg_hdr_addr);
1556 DEBUG_CurrProcess->dbg_hdr_addr = (u_long)dyn.d_un.d_ptr;
1558 if (dbg_hdr.r_brk) {
1561 DEBUG_Printf(DBG_CHN_TRACE, "Setting up a breakpoint on r_brk(%lx)\n",
1562 (unsigned long)dbg_hdr.r_brk);
1564 DEBUG_SetBreakpoints(FALSE);
1566 value.cookie = DV_TARGET;
1568 value.addr.off = (DWORD)dbg_hdr.r_brk;
1569 DEBUG_AddBreakpoint(&value, DEBUG_RescanElf, TRUE);
1570 DEBUG_SetBreakpoints(TRUE);
1573 dil = DEBUG_WalkList(&dbg_hdr);
1579 /* FIXME: merge with some of the routines above */
1580 int read_elf_info(const char* filename, unsigned long tab[])
1582 static const unsigned char elf_signature[4] = { ELFMAG0, ELFMAG1, ELFMAG2, ELFMAG3 };
1593 hFile = CreateFile(filename, GENERIC_READ, FILE_SHARE_READ, NULL,
1594 OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);
1595 if (hFile == INVALID_HANDLE_VALUE) goto leave;
1596 hMap = CreateFileMapping(hFile, NULL, PAGE_READONLY, 0, 0, NULL);
1597 if (hMap == 0) goto leave;
1598 addr = MapViewOfFile(hMap, FILE_MAP_READ, 0, 0, 0);
1599 if (addr == NULL) goto leave;
1601 ehptr = (Elf32_Ehdr*) addr;
1602 if (memcmp(ehptr->e_ident, elf_signature, sizeof(elf_signature))) goto leave;
1604 spnt = (Elf32_Shdr*) (addr + ehptr->e_shoff);
1605 shstrtab = (addr + spnt[ehptr->e_shstrndx].sh_offset);
1607 tab[0] = tab[1] = tab[2] = 0;
1608 for (i = 0; i < ehptr->e_shnum; i++)
1613 if (addr != NULL) UnmapViewOfFile(addr);
1614 if (hMap != 0) CloseHandle(hMap);
1615 if (hFile != INVALID_HANDLE_VALUE) CloseHandle(hFile);
1619 #else /* !__ELF__ */
1621 enum DbgInfoLoad DEBUG_ReadExecutableDbgInfo(const char* exe_name)
1626 #endif /* __ELF__ */