1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
/* $NetBSD: db_sym.h,v 1.13 2000/05/25 19:57:36 jhawk Exp $ */
/*
* Mach Operating System
* Copyright (c) 1993,1992,1991,1990 Carnegie Mellon University
* All Rights Reserved.
*
* Permission to use, copy, modify and distribute this software and its
* documentation is hereby granted, provided that both the copyright
* notice and this permission notice appear in all copies of the
* software, derivative works or modified versions, and any portions
* thereof, and that both notices appear in supporting documentation.
*
* CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
* CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
* ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
*
* Carnegie Mellon requests users of this software to return to
*
* Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
* School of Computer Science
* Carnegie Mellon University
* Pittsburgh PA 15213-3890
*
* any improvements or extensions that they make and grant Carnegie Mellon
* the rights to redistribute these changes.
*
* Author: Alessandro Forin, Carnegie Mellon University
* Date: 8/90
*/
/*
* This module can handle multiple symbol tables
*/
typedef struct {
const char *name; /* symtab name */
char *start; /* symtab location */
char *end;
char *private; /* optional machdep pointer */
} db_symtab_t;
extern db_symtab_t *db_last_symtab; /* where last symbol was found */
/*
* Symbol representation is specific to the symtab style:
* BSD compilers use dbx' nlist, other compilers might use
* a different one
*/
typedef char * db_sym_t; /* opaque handle on symbols */
#define DB_SYM_NULL ((db_sym_t)0)
/*
* Non-stripped symbol tables will have duplicates, for instance
* the same string could match a parameter name, a local var, a
* global var, etc.
* We are most concern with the following matches.
*/
typedef int db_strategy_t; /* search strategy */
#define DB_STGY_ANY 0 /* anything goes */
#define DB_STGY_XTRN 1 /* only external symbols */
#define DB_STGY_PROC 2 /* only procedures */
/*
* Internal db_forall function calling convention:
*
* (*db_forall_func)(stab, sym, name, suffix, prefix, arg);
*
* stab is the symbol table, symbol the (opaque) symbol pointer,
* name the name of the symbol, suffix a string representing
* the type, prefix an initial ignorable function prefix (e.g. "_"
* in a.out), and arg an opaque argument to be passed in.
*/
typedef void (db_forall_func_t)(db_symtab_t *, db_sym_t, char *, char *, int, void *);
void X_db_forall(db_symtab_t *,
db_forall_func_t db_forall_func, void *);
/*
* A symbol table may be in one of many formats. All symbol tables
* must be of the same format as the master kernel symbol table.
*/
typedef struct {
const char *sym_format;
boolean_t (*sym_init)(int, void *, void *, const char *);
db_sym_t (*sym_lookup)(db_symtab_t *, char *);
db_sym_t (*sym_search)(db_symtab_t *, db_addr_t, db_strategy_t,
db_expr_t *);
void (*sym_value)(db_symtab_t *, db_sym_t, char **,
db_expr_t *);
boolean_t (*sym_line_at_pc)(db_symtab_t *, db_sym_t,
char **, int *, db_expr_t);
boolean_t (*sym_numargs)(db_symtab_t *, db_sym_t, int *,
char **);
void (*sym_forall)(db_symtab_t *,
db_forall_func_t *db_forall_func, void *);
} db_symformat_t;
extern boolean_t db_qualify_ambiguous_names;
/* if TRUE, check across symbol tables
* for multiple occurrences of a name.
* Might slow down quite a bit */
extern unsigned int db_maxoff; /* like gdb's "max-symbolic-offset" */
/*
* Functions exported by the symtable module
*/
int db_add_symbol_table(char *, char *, const char *, char *);
/* extend the list of symbol tables */
void db_del_symbol_table(char *);
/* remove a symbol table from list */
boolean_t db_eqname(char *, char *, int);
/* strcmp, modulo leading char */
int db_value_of_name(char *, db_expr_t *);
/* find symbol value given name */
db_sym_t db_lookup(char *);
void db_sifting(char *, int);
/* print partially matching symbol names */
boolean_t db_symbol_is_ambiguous(db_sym_t);
db_sym_t db_search_symbol(db_addr_t, db_strategy_t, db_expr_t *);
/* find symbol given value */
void db_symbol_values(db_sym_t, char **, db_expr_t *);
/* return name and value of symbol */
#define db_find_sym_and_offset(val,namep,offp) \
db_symbol_values(db_search_symbol(val,DB_STGY_ANY,offp),namep,0)
/* find name&value given approx val */
#define db_find_xtrn_sym_and_offset(val,namep,offp) \
db_symbol_values(db_search_symbol(val,DB_STGY_XTRN,offp),namep,0)
/* ditto, but no locals */
void db_printsym(db_expr_t, db_strategy_t, int (*)(const char *, ...));
/* print closest symbol to a value */
boolean_t db_line_at_pc(db_sym_t, char **, int *, db_expr_t);
int db_sym_numargs(db_sym_t, int *, char **);
char *db_qualify(db_sym_t, const char *);
#ifdef DB_AOUT_SYMBOLS
extern db_symformat_t db_symformat_aout;
#endif
#ifdef DB_ELF_SYMBOLS
extern db_symformat_t db_symformat_elf;
#endif
|
