Blame


1 1a0954ab 2005-01-04 devnull #ifndef _MACH_H_
2 1a0954ab 2005-01-04 devnull #define _MACH_H_ 1
3 1a0954ab 2005-01-04 devnull #if defined(__cplusplus)
4 1a0954ab 2005-01-04 devnull extern "C" {
5 1a0954ab 2005-01-04 devnull #endif
6 1a0954ab 2005-01-04 devnull
7 1a0954ab 2005-01-04 devnull AUTOLIB(mach)
8 1a0954ab 2005-01-04 devnull
9 0e3cc9f4 2004-04-19 devnull /*
10 0e3cc9f4 2004-04-19 devnull * Architecture-dependent application data.
11 0e3cc9f4 2004-04-19 devnull *
12 0e3cc9f4 2004-04-19 devnull * The code assumes that ulong is big enough to hold
13 0e3cc9f4 2004-04-19 devnull * an address on any system of interest as well as any
14 0e3cc9f4 2004-04-19 devnull * register. Debugging 64-bit code on 32-bit machines
15 0e3cc9f4 2004-04-19 devnull * will be interesting.
16 0e3cc9f4 2004-04-19 devnull *
17 0e3cc9f4 2004-04-19 devnull * Supported architectures:
18 0e3cc9f4 2004-04-19 devnull *
19 0e3cc9f4 2004-04-19 devnull * MIPS R3000
20 0e3cc9f4 2004-04-19 devnull * Motorola 68020
21 0e3cc9f4 2004-04-19 devnull * Intel 386
22 0e3cc9f4 2004-04-19 devnull * SPARC
23 0e3cc9f4 2004-04-19 devnull * PowerPC (limited)
24 0e3cc9f4 2004-04-19 devnull * ARM (limited)
25 0e3cc9f4 2004-04-19 devnull * Intel 960 (limited)
26 0e3cc9f4 2004-04-19 devnull * AT&T 3210 DSP (limited)
27 0e3cc9f4 2004-04-19 devnull * MIPS2 (R4000)
28 0e3cc9f4 2004-04-19 devnull */
29 0e3cc9f4 2004-04-19 devnull
30 0e3cc9f4 2004-04-19 devnull typedef struct Fhdr Fhdr;
31 0e3cc9f4 2004-04-19 devnull typedef struct Loc Loc;
32 0e3cc9f4 2004-04-19 devnull typedef struct Mach Mach;
33 0e3cc9f4 2004-04-19 devnull typedef struct Map Map;
34 0e3cc9f4 2004-04-19 devnull typedef struct Regdesc Regdesc;
35 0e3cc9f4 2004-04-19 devnull typedef struct Regs Regs;
36 0e3cc9f4 2004-04-19 devnull typedef struct Seg Seg;
37 0e3cc9f4 2004-04-19 devnull typedef struct Symbol Symbol;
38 0e3cc9f4 2004-04-19 devnull typedef struct Symtype Symtype;
39 0e3cc9f4 2004-04-19 devnull
40 0e3cc9f4 2004-04-19 devnull typedef int (*Tracer)(Map*, Regs*, ulong, ulong, Symbol*, int);
41 0e3cc9f4 2004-04-19 devnull
42 0e3cc9f4 2004-04-19 devnull extern Mach *mach;
43 0e3cc9f4 2004-04-19 devnull extern Mach *machcpu;
44 0e3cc9f4 2004-04-19 devnull
45 0e3cc9f4 2004-04-19 devnull /*
46 0e3cc9f4 2004-04-19 devnull * Byte-order data layout manipulation.
47 0e3cc9f4 2004-04-19 devnull * swap.c ieee.c
48 0e3cc9f4 2004-04-19 devnull */
49 0e3cc9f4 2004-04-19 devnull u16int beswap2(u16int u);
50 0e3cc9f4 2004-04-19 devnull u32int beswap4(u32int u);
51 0e3cc9f4 2004-04-19 devnull u64int beswap8(u64int u);
52 0e3cc9f4 2004-04-19 devnull int beieeeftoa32(char*, uint, void*);
53 0e3cc9f4 2004-04-19 devnull int beieeeftoa64(char*, uint, void*);
54 0e3cc9f4 2004-04-19 devnull int beieeeftoa80(char*, uint, void*);
55 0e3cc9f4 2004-04-19 devnull
56 0e3cc9f4 2004-04-19 devnull u16int leswap2(u16int u);
57 0e3cc9f4 2004-04-19 devnull u32int leswap4(u32int u);
58 0e3cc9f4 2004-04-19 devnull u64int leswap8(u64int u);
59 0e3cc9f4 2004-04-19 devnull int leieeeftoa32(char *a, uint n, void *v);
60 0e3cc9f4 2004-04-19 devnull int leieeeftoa64(char *a, uint n, void *v);
61 0e3cc9f4 2004-04-19 devnull int leieeeftoa80(char *a, uint n, void *v);
62 0e3cc9f4 2004-04-19 devnull
63 0e3cc9f4 2004-04-19 devnull u16int beload2(uchar*);
64 0e3cc9f4 2004-04-19 devnull u32int beload4(uchar*);
65 0e3cc9f4 2004-04-19 devnull u64int beload8(uchar*);
66 0e3cc9f4 2004-04-19 devnull
67 0e3cc9f4 2004-04-19 devnull u16int leload2(uchar*);
68 0e3cc9f4 2004-04-19 devnull u32int leload4(uchar*);
69 0e3cc9f4 2004-04-19 devnull u64int leload8(uchar*);
70 0e3cc9f4 2004-04-19 devnull
71 0e3cc9f4 2004-04-19 devnull int ieeeftoa32(char *a, uint n, u32int u);
72 0e3cc9f4 2004-04-19 devnull int ieeeftoa64(char *a, uint n, u32int h, u32int u);
73 0e3cc9f4 2004-04-19 devnull
74 0e3cc9f4 2004-04-19 devnull /*
75 0e3cc9f4 2004-04-19 devnull * Machine-independent access to an executable image.
76 0e3cc9f4 2004-04-19 devnull * map.c
77 0e3cc9f4 2004-04-19 devnull */
78 0e3cc9f4 2004-04-19 devnull struct Seg
79 0e3cc9f4 2004-04-19 devnull {
80 0e3cc9f4 2004-04-19 devnull char *name;
81 0e3cc9f4 2004-04-19 devnull char *file;
82 0e3cc9f4 2004-04-19 devnull uchar *p;
83 0e3cc9f4 2004-04-19 devnull int fd;
84 0e3cc9f4 2004-04-19 devnull int pid;
85 0e3cc9f4 2004-04-19 devnull ulong base;
86 0e3cc9f4 2004-04-19 devnull ulong size;
87 0e3cc9f4 2004-04-19 devnull ulong offset;
88 0e3cc9f4 2004-04-19 devnull int (*rw)(Map*, Seg*, ulong, void*, uint, int);
89 0e3cc9f4 2004-04-19 devnull };
90 0e3cc9f4 2004-04-19 devnull
91 0e3cc9f4 2004-04-19 devnull struct Map
92 0e3cc9f4 2004-04-19 devnull {
93 0e3cc9f4 2004-04-19 devnull int nseg;
94 0e3cc9f4 2004-04-19 devnull Seg *seg;
95 0e3cc9f4 2004-04-19 devnull };
96 0e3cc9f4 2004-04-19 devnull
97 0e3cc9f4 2004-04-19 devnull struct Regs
98 0e3cc9f4 2004-04-19 devnull {
99 0e3cc9f4 2004-04-19 devnull int (*rw)(Regs*, char*, ulong*, int);
100 0e3cc9f4 2004-04-19 devnull };
101 0e3cc9f4 2004-04-19 devnull
102 0e3cc9f4 2004-04-19 devnull typedef struct UregRegs UregRegs;
103 0e3cc9f4 2004-04-19 devnull struct UregRegs
104 0e3cc9f4 2004-04-19 devnull {
105 0e3cc9f4 2004-04-19 devnull Regs r;
106 0e3cc9f4 2004-04-19 devnull uchar *ureg;
107 0e3cc9f4 2004-04-19 devnull };
108 0e3cc9f4 2004-04-19 devnull int _uregrw(Regs*, char*, ulong*, int);
109 0e3cc9f4 2004-04-19 devnull
110 0e3cc9f4 2004-04-19 devnull typedef struct PidRegs PidRegs;
111 0e3cc9f4 2004-04-19 devnull struct PidRegs
112 0e3cc9f4 2004-04-19 devnull {
113 0e3cc9f4 2004-04-19 devnull Regs r;
114 0e3cc9f4 2004-04-19 devnull int pid;
115 0e3cc9f4 2004-04-19 devnull };
116 0e3cc9f4 2004-04-19 devnull
117 0e3cc9f4 2004-04-19 devnull Map* allocmap(void);
118 0e3cc9f4 2004-04-19 devnull int addseg(Map *map, Seg seg);
119 0e3cc9f4 2004-04-19 devnull int findseg(Map *map, char *name, char *file);
120 0e3cc9f4 2004-04-19 devnull int addrtoseg(Map *map, ulong addr, Seg *seg);
121 0e3cc9f4 2004-04-19 devnull int addrtosegafter(Map *map, ulong addr, Seg *seg);
122 0e3cc9f4 2004-04-19 devnull void removeseg(Map *map, int i);
123 0e3cc9f4 2004-04-19 devnull void freemap(Map*);
124 0e3cc9f4 2004-04-19 devnull
125 0e3cc9f4 2004-04-19 devnull int get1(Map *map, ulong addr, uchar *a, uint n);
126 0e3cc9f4 2004-04-19 devnull int get2(Map *map, ulong addr, u16int *u);
127 0e3cc9f4 2004-04-19 devnull int get4(Map *map, ulong addr, u32int *u);
128 0e3cc9f4 2004-04-19 devnull int get8(Map *map, ulong addr, u64int *u);
129 0e3cc9f4 2004-04-19 devnull
130 0e3cc9f4 2004-04-19 devnull int put1(Map *map, ulong addr, uchar *a, uint n);
131 0e3cc9f4 2004-04-19 devnull int put2(Map *map, ulong addr, u16int u);
132 0e3cc9f4 2004-04-19 devnull int put4(Map *map, ulong addr, u32int u);
133 0e3cc9f4 2004-04-19 devnull int put8(Map *map, ulong addr, u64int u);
134 0e3cc9f4 2004-04-19 devnull
135 0e3cc9f4 2004-04-19 devnull int rget(Regs*, char*, ulong*);
136 0e3cc9f4 2004-04-19 devnull int rput(Regs*, char*, ulong);
137 0e3cc9f4 2004-04-19 devnull
138 0e3cc9f4 2004-04-19 devnull /*
139 0e3cc9f4 2004-04-19 devnull * A location is either a memory address or a register.
140 0e3cc9f4 2004-04-19 devnull * It is useful to be able to specify constant values that
141 0e3cc9f4 2004-04-19 devnull * originate from outside the register set and memory,
142 0e3cc9f4 2004-04-19 devnull * hence LCONST. If the register values are known, then
143 0e3cc9f4 2004-04-19 devnull * we can dispense with LOFFSET, but it's useful to be able
144 0e3cc9f4 2004-04-19 devnull * to look up local symbols (via findlsym) with locations
145 0e3cc9f4 2004-04-19 devnull * like 8(BP).
146 0e3cc9f4 2004-04-19 devnull *
147 0e3cc9f4 2004-04-19 devnull * loc.c
148 0e3cc9f4 2004-04-19 devnull */
149 0e3cc9f4 2004-04-19 devnull
150 0e3cc9f4 2004-04-19 devnull enum
151 0e3cc9f4 2004-04-19 devnull {
152 0e3cc9f4 2004-04-19 devnull /* location type */
153 0e3cc9f4 2004-04-19 devnull LNONE,
154 0e3cc9f4 2004-04-19 devnull LREG, /* register */
155 0e3cc9f4 2004-04-19 devnull LADDR, /* absolute address */
156 0e3cc9f4 2004-04-19 devnull LCONST, /* constant (an anonymous readonly location) */
157 cbeb0b26 2006-04-01 devnull LOFFSET /* dereference offset + register ptr */
158 0e3cc9f4 2004-04-19 devnull };
159 0e3cc9f4 2004-04-19 devnull
160 0e3cc9f4 2004-04-19 devnull struct Loc
161 0e3cc9f4 2004-04-19 devnull {
162 0e3cc9f4 2004-04-19 devnull uint type; /* LNONE, ... */
163 0e3cc9f4 2004-04-19 devnull char *reg; /* LREG */
164 0e3cc9f4 2004-04-19 devnull ulong addr; /* LADDR, CONST */
165 0e3cc9f4 2004-04-19 devnull long offset; /* LOFFSET */
166 0e3cc9f4 2004-04-19 devnull };
167 0e3cc9f4 2004-04-19 devnull
168 0e3cc9f4 2004-04-19 devnull int lget1(Map *map, Regs *regs, Loc loc, uchar *a, uint n);
169 0e3cc9f4 2004-04-19 devnull int lget2(Map *map, Regs *regs, Loc loc, u16int *v);
170 0e3cc9f4 2004-04-19 devnull int lget4(Map *map, Regs *regs, Loc loc, u32int *v);
171 0e3cc9f4 2004-04-19 devnull int lget8(Map *map, Regs *regs, Loc loc, u64int *v);
172 0e3cc9f4 2004-04-19 devnull
173 0e3cc9f4 2004-04-19 devnull int lput1(Map *map, Regs *regs, Loc loc, uchar *a, uint n);
174 0e3cc9f4 2004-04-19 devnull int lput2(Map *map, Regs *regs, Loc loc, u16int v);
175 0e3cc9f4 2004-04-19 devnull int lput4(Map *map, Regs *regs, Loc loc, u32int v);
176 0e3cc9f4 2004-04-19 devnull int lput8(Map *map, Regs *regs, Loc loc, u64int v);
177 0e3cc9f4 2004-04-19 devnull
178 0e3cc9f4 2004-04-19 devnull Loc locnone(void);
179 0e3cc9f4 2004-04-19 devnull Loc locaddr(ulong addr);
180 0e3cc9f4 2004-04-19 devnull Loc locconst(ulong con);
181 0e3cc9f4 2004-04-19 devnull Loc locreg(char*);
182 0e3cc9f4 2004-04-19 devnull Loc locindir(char*, long);
183 0e3cc9f4 2004-04-19 devnull
184 0e3cc9f4 2004-04-19 devnull /*
185 0e3cc9f4 2004-04-19 devnull * Executable file parsing.
186 0e3cc9f4 2004-04-19 devnull *
187 0e3cc9f4 2004-04-19 devnull * An Fhdr represents an open file image.
188 0e3cc9f4 2004-04-19 devnull * The contents are a grab bag of constants used for the
189 0e3cc9f4 2004-04-19 devnull * various file types. Not all elements are used by all
190 0e3cc9f4 2004-04-19 devnull * file types.
191 0e3cc9f4 2004-04-19 devnull *
192 0e3cc9f4 2004-04-19 devnull * crackadotplan9.c crackadotunix.c
193 0e3cc9f4 2004-04-19 devnull * crackelf.c crackdwarf.c
194 0e3cc9f4 2004-04-19 devnull */
195 0e3cc9f4 2004-04-19 devnull enum
196 0e3cc9f4 2004-04-19 devnull {
197 0e3cc9f4 2004-04-19 devnull /* file types */
198 0e3cc9f4 2004-04-19 devnull FNONE,
199 0e3cc9f4 2004-04-19 devnull FEXEC, /* executable image */
200 0e3cc9f4 2004-04-19 devnull FLIB, /* library */
201 0e3cc9f4 2004-04-19 devnull FOBJ, /* object file */
202 0e3cc9f4 2004-04-19 devnull FRELOC, /* relocatable executable */
203 0e3cc9f4 2004-04-19 devnull FSHLIB, /* shared library */
204 0e3cc9f4 2004-04-19 devnull FSHOBJ, /* shared object */
205 0e3cc9f4 2004-04-19 devnull FCORE, /* core dump */
206 0e3cc9f4 2004-04-19 devnull FBOOT, /* bootable image */
207 0e3cc9f4 2004-04-19 devnull FKERNEL, /* kernel image */
208 0e3cc9f4 2004-04-19 devnull NFTYPE,
209 0e3cc9f4 2004-04-19 devnull
210 0e3cc9f4 2004-04-19 devnull /* abi types */
211 0e3cc9f4 2004-04-19 devnull ANONE = 0,
212 0e3cc9f4 2004-04-19 devnull APLAN9,
213 0e3cc9f4 2004-04-19 devnull ALINUX,
214 0e3cc9f4 2004-04-19 devnull AFREEBSD,
215 0e3cc9f4 2004-04-19 devnull AMACH,
216 0e3cc9f4 2004-04-19 devnull NATYPE
217 0e3cc9f4 2004-04-19 devnull };
218 0e3cc9f4 2004-04-19 devnull
219 0e3cc9f4 2004-04-19 devnull /* I wish this could be kept in stabs.h */
220 0e3cc9f4 2004-04-19 devnull struct Stab
221 0e3cc9f4 2004-04-19 devnull {
222 0e3cc9f4 2004-04-19 devnull uchar *stabbase;
223 0e3cc9f4 2004-04-19 devnull uint stabsize;
224 0e3cc9f4 2004-04-19 devnull char *strbase;
225 0e3cc9f4 2004-04-19 devnull uint strsize;
226 0e3cc9f4 2004-04-19 devnull u16int (*e2)(uchar*);
227 0e3cc9f4 2004-04-19 devnull u32int (*e4)(uchar*);
228 0e3cc9f4 2004-04-19 devnull };
229 0e3cc9f4 2004-04-19 devnull
230 0e3cc9f4 2004-04-19 devnull struct Fhdr
231 0e3cc9f4 2004-04-19 devnull {
232 0e3cc9f4 2004-04-19 devnull int fd; /* file descriptor */
233 0e3cc9f4 2004-04-19 devnull char *filename; /* file name */
234 0e3cc9f4 2004-04-19 devnull Mach *mach; /* machine */
235 0e3cc9f4 2004-04-19 devnull char *mname; /* 386, power, ... */
236 0e3cc9f4 2004-04-19 devnull uint mtype; /* machine type M386, ... */
237 0e3cc9f4 2004-04-19 devnull char *fname; /* core, executable, boot image, ... */
238 0e3cc9f4 2004-04-19 devnull uint ftype; /* file type FCORE, ... */
239 0e3cc9f4 2004-04-19 devnull char *aname; /* abi name */
240 0e3cc9f4 2004-04-19 devnull uint atype; /* abi type ALINUX, ... */
241 0e3cc9f4 2004-04-19 devnull
242 0e3cc9f4 2004-04-19 devnull ulong magic; /* magic number */
243 0e3cc9f4 2004-04-19 devnull ulong txtaddr; /* text address */
244 0e3cc9f4 2004-04-19 devnull ulong entry; /* entry point */
245 0e3cc9f4 2004-04-19 devnull ulong txtsz; /* text size */
246 0e3cc9f4 2004-04-19 devnull ulong txtoff; /* text offset in file */
247 0e3cc9f4 2004-04-19 devnull ulong dataddr; /* data address */
248 0e3cc9f4 2004-04-19 devnull ulong datsz; /* data size */
249 0e3cc9f4 2004-04-19 devnull ulong datoff; /* data offset in file */
250 0e3cc9f4 2004-04-19 devnull ulong bsssz; /* bss size */
251 0e3cc9f4 2004-04-19 devnull ulong symsz; /* symbol table size */
252 0e3cc9f4 2004-04-19 devnull ulong symoff; /* symbol table offset in file */
253 0e3cc9f4 2004-04-19 devnull ulong sppcsz; /* size of sp-pc table */
254 0e3cc9f4 2004-04-19 devnull ulong sppcoff; /* offset of sp-pc table in file */
255 0e3cc9f4 2004-04-19 devnull ulong lnpcsz; /* size of line number-pc table */
256 0e3cc9f4 2004-04-19 devnull ulong lnpcoff; /* size of line number-pc table */
257 0e3cc9f4 2004-04-19 devnull void *elf; /* handle to elf image */
258 0e3cc9f4 2004-04-19 devnull void *dwarf; /* handle to dwarf image */
259 0e3cc9f4 2004-04-19 devnull void *macho; /* handle to mach-o image */
260 0e3cc9f4 2004-04-19 devnull struct Stab stabs;
261 28125cbd 2005-01-23 devnull uint pid; /* for core files */
262 28125cbd 2005-01-23 devnull char *prog; /* program name, for core files */
263 28125cbd 2005-01-23 devnull char *cmdline; /* command-line that produced core */
264 28125cbd 2005-01-23 devnull struct { /* thread state for core files */
265 28125cbd 2005-01-23 devnull uint id;
266 28125cbd 2005-01-23 devnull void *ureg;
267 28125cbd 2005-01-23 devnull } *thread;
268 28125cbd 2005-01-23 devnull uint nthread;
269 0e3cc9f4 2004-04-19 devnull
270 0e3cc9f4 2004-04-19 devnull /* private */
271 0e3cc9f4 2004-04-19 devnull Symbol *sym; /* cached list of symbols */
272 0e3cc9f4 2004-04-19 devnull Symbol **byname;
273 72dd4491 2005-11-29 devnull Symbol **byxname;
274 0e3cc9f4 2004-04-19 devnull uint nsym;
275 0e3cc9f4 2004-04-19 devnull Symbol *esym; /* elf symbols */
276 0e3cc9f4 2004-04-19 devnull uint nesym;
277 0e3cc9f4 2004-04-19 devnull ulong base; /* base address for relocatables */
278 0e3cc9f4 2004-04-19 devnull Fhdr *next; /* link to next fhdr (internal) */
279 0e3cc9f4 2004-04-19 devnull
280 0e3cc9f4 2004-04-19 devnull /* file mapping */
281 0e3cc9f4 2004-04-19 devnull int (*map)(Fhdr*, ulong, Map*, Regs**);
282 0e3cc9f4 2004-04-19 devnull
283 0e3cc9f4 2004-04-19 devnull /* debugging symbol access; see below */
284 0e3cc9f4 2004-04-19 devnull int (*syminit)(Fhdr*);
285 0e3cc9f4 2004-04-19 devnull void (*symclose)(Fhdr*);
286 0e3cc9f4 2004-04-19 devnull
287 0e3cc9f4 2004-04-19 devnull int (*pc2file)(Fhdr*, ulong, char*, uint, ulong*);
288 0e3cc9f4 2004-04-19 devnull int (*file2pc)(Fhdr*, char*, ulong, ulong*);
289 0e3cc9f4 2004-04-19 devnull int (*line2pc)(Fhdr*, ulong, ulong, ulong*);
290 0e3cc9f4 2004-04-19 devnull
291 0e3cc9f4 2004-04-19 devnull int (*lookuplsym)(Fhdr*, Symbol*, char*, Symbol*);
292 0e3cc9f4 2004-04-19 devnull int (*indexlsym)(Fhdr*, Symbol*, uint, Symbol*);
293 0e3cc9f4 2004-04-19 devnull int (*findlsym)(Fhdr*, Symbol*, Loc, Symbol*);
294 0e3cc9f4 2004-04-19 devnull
295 cdf18051 2004-12-25 devnull int (*unwind)(Fhdr*, Map*, Regs*, ulong*, Symbol*);
296 0e3cc9f4 2004-04-19 devnull };
297 0e3cc9f4 2004-04-19 devnull
298 0e3cc9f4 2004-04-19 devnull Fhdr* crackhdr(char *file, int mode);
299 0e3cc9f4 2004-04-19 devnull void uncrackhdr(Fhdr *hdr);
300 0e3cc9f4 2004-04-19 devnull int crackelf(int fd, Fhdr *hdr);
301 0e3cc9f4 2004-04-19 devnull int crackmacho(int fd, Fhdr *hdr);
302 28125cbd 2005-01-23 devnull Regs* coreregs(Fhdr*, uint);
303 0e3cc9f4 2004-04-19 devnull
304 8b549a62 2005-01-07 devnull int symopen(Fhdr*);
305 0e3cc9f4 2004-04-19 devnull int symdwarf(Fhdr*);
306 0e3cc9f4 2004-04-19 devnull int symelf(Fhdr*);
307 0e3cc9f4 2004-04-19 devnull int symstabs(Fhdr*);
308 0e3cc9f4 2004-04-19 devnull int symmacho(Fhdr*);
309 8b549a62 2005-01-07 devnull void symclose(Fhdr*);
310 0e3cc9f4 2004-04-19 devnull
311 0e3cc9f4 2004-04-19 devnull int mapfile(Fhdr *fp, ulong base, Map *map, Regs **regs);
312 0e3cc9f4 2004-04-19 devnull void unmapfile(Fhdr *fp, Map *map);
313 0e3cc9f4 2004-04-19 devnull
314 0e3cc9f4 2004-04-19 devnull /*
315 0e3cc9f4 2004-04-19 devnull * Process manipulation.
316 0e3cc9f4 2004-04-19 devnull */
317 0e3cc9f4 2004-04-19 devnull int mapproc(int pid, Map *map, Regs **regs);
318 0e3cc9f4 2004-04-19 devnull void unmapproc(Map *map);
319 0e3cc9f4 2004-04-19 devnull int detachproc(int pid);
320 0e3cc9f4 2004-04-19 devnull int ctlproc(int pid, char *msg);
321 0e3cc9f4 2004-04-19 devnull int procnotes(int pid, char ***notes);
322 0e3cc9f4 2004-04-19 devnull char* proctextfile(int pid);
323 0e3cc9f4 2004-04-19 devnull
324 0e3cc9f4 2004-04-19 devnull /*
325 cdf18051 2004-12-25 devnull * Command-line debugger help
326 cdf18051 2004-12-25 devnull */
327 cdf18051 2004-12-25 devnull extern Fhdr *symhdr;
328 cdf18051 2004-12-25 devnull extern Fhdr *corhdr;
329 cdf18051 2004-12-25 devnull extern char *symfil;
330 cdf18051 2004-12-25 devnull extern char *corfil;
331 cdf18051 2004-12-25 devnull extern int corpid;
332 cdf18051 2004-12-25 devnull extern Regs *correg;
333 cdf18051 2004-12-25 devnull extern Map *symmap;
334 cdf18051 2004-12-25 devnull extern Map *cormap;
335 cdf18051 2004-12-25 devnull
336 cdf18051 2004-12-25 devnull int attachproc(int pid);
337 cdf18051 2004-12-25 devnull int attachcore(Fhdr *hdr);
338 28125cbd 2005-01-23 devnull int attachargs(int argc, char **argv, int omode, int);
339 28125cbd 2005-01-23 devnull int attachdynamic(int);
340 cdf18051 2004-12-25 devnull /*
341 0e3cc9f4 2004-04-19 devnull * Machine descriptions.
342 0e3cc9f4 2004-04-19 devnull *
343 0e3cc9f4 2004-04-19 devnull * mach.c
344 0e3cc9f4 2004-04-19 devnull * mach386.c dis386.c
345 0e3cc9f4 2004-04-19 devnull * machsparc.c dissparc.c
346 0e3cc9f4 2004-04-19 devnull * ...
347 0e3cc9f4 2004-04-19 devnull */
348 0e3cc9f4 2004-04-19 devnull
349 0e3cc9f4 2004-04-19 devnull /*
350 0e3cc9f4 2004-04-19 devnull * Register sets. The Regs are opaque, accessed by using
351 0e3cc9f4 2004-04-19 devnull * the reglist (and really the accessor functions).
352 0e3cc9f4 2004-04-19 devnull */
353 0e3cc9f4 2004-04-19 devnull enum
354 0e3cc9f4 2004-04-19 devnull {
355 0e3cc9f4 2004-04-19 devnull /* must be big enough for all machine register sets */
356 0e3cc9f4 2004-04-19 devnull REGSIZE = 256,
357 0e3cc9f4 2004-04-19 devnull
358 0e3cc9f4 2004-04-19 devnull RINT = 0<<0,
359 0e3cc9f4 2004-04-19 devnull RFLT = 1<<0,
360 cbeb0b26 2006-04-01 devnull RRDONLY = 1<<1
361 0e3cc9f4 2004-04-19 devnull };
362 0e3cc9f4 2004-04-19 devnull
363 0e3cc9f4 2004-04-19 devnull struct Regdesc
364 0e3cc9f4 2004-04-19 devnull {
365 0e3cc9f4 2004-04-19 devnull char *name; /* register name */
366 0e3cc9f4 2004-04-19 devnull uint offset; /* offset in b */
367 0e3cc9f4 2004-04-19 devnull uint flags; /* RINT/RFLT/RRDONLY */
368 0e3cc9f4 2004-04-19 devnull uint format; /* print format: 'x', 'X', 'f', 'z', 'Z' */
369 0e3cc9f4 2004-04-19 devnull };
370 0e3cc9f4 2004-04-19 devnull
371 0e3cc9f4 2004-04-19 devnull enum
372 0e3cc9f4 2004-04-19 devnull {
373 0e3cc9f4 2004-04-19 devnull /* machine types */
374 0e3cc9f4 2004-04-19 devnull MNONE,
375 0e3cc9f4 2004-04-19 devnull MMIPS, /* MIPS R3000 */
376 0e3cc9f4 2004-04-19 devnull MSPARC, /* SUN SPARC */
377 0e3cc9f4 2004-04-19 devnull M68000, /* Motorola 68000 */
378 0e3cc9f4 2004-04-19 devnull M386, /* Intel 32-bit x86*/
379 0e3cc9f4 2004-04-19 devnull M960, /* Intel 960 */
380 0e3cc9f4 2004-04-19 devnull M3210, /* AT&T 3210 DSP */
381 0e3cc9f4 2004-04-19 devnull MMIPS2, /* MIPS R4000 */
382 0e3cc9f4 2004-04-19 devnull M29000, /* AMD 29000 */
383 0e3cc9f4 2004-04-19 devnull MARM, /* ARM */
384 0e3cc9f4 2004-04-19 devnull MPOWER, /* PowerPC */
385 0e3cc9f4 2004-04-19 devnull MALPHA, /* DEC/Compaq Alpha */
386 0e3cc9f4 2004-04-19 devnull NMTYPE
387 0e3cc9f4 2004-04-19 devnull };
388 0e3cc9f4 2004-04-19 devnull
389 0e3cc9f4 2004-04-19 devnull struct Mach
390 0e3cc9f4 2004-04-19 devnull {
391 0e3cc9f4 2004-04-19 devnull char *name; /* "386", ... */
392 0e3cc9f4 2004-04-19 devnull uint type; /* M386, ... */
393 0e3cc9f4 2004-04-19 devnull Regdesc *reglist; /* register set */
394 0e3cc9f4 2004-04-19 devnull uint regsize; /* size of register set in bytes */
395 0e3cc9f4 2004-04-19 devnull uint fpregsize; /* size of fp register set in bytes */
396 0e3cc9f4 2004-04-19 devnull char *pc; /* name of program counter */
397 0e3cc9f4 2004-04-19 devnull char *sp; /* name of stack pointer */
398 0e3cc9f4 2004-04-19 devnull char *fp; /* name of frame pointer */
399 0e3cc9f4 2004-04-19 devnull char *link; /* name of link register */
400 0e3cc9f4 2004-04-19 devnull char *sbreg; /* name of static base */
401 0e3cc9f4 2004-04-19 devnull ulong sb; /* value of static base */
402 0e3cc9f4 2004-04-19 devnull uint pgsize; /* page size */
403 0e3cc9f4 2004-04-19 devnull ulong kbase; /* kernel base address for Plan 9 */
404 0e3cc9f4 2004-04-19 devnull ulong ktmask; /* ktzero = kbase & ~ktmask */
405 0e3cc9f4 2004-04-19 devnull uint pcquant; /* pc quantum */
406 0e3cc9f4 2004-04-19 devnull uint szaddr; /* size of pointer in bytes */
407 0e3cc9f4 2004-04-19 devnull uint szreg; /* size of integer register */
408 0e3cc9f4 2004-04-19 devnull uint szfloat; /* size of float */
409 0e3cc9f4 2004-04-19 devnull uint szdouble; /* size of double */
410 0e3cc9f4 2004-04-19 devnull char** windreg; /* unwinding registers */
411 0e3cc9f4 2004-04-19 devnull uint nwindreg;
412 0e3cc9f4 2004-04-19 devnull
413 0e3cc9f4 2004-04-19 devnull uchar bpinst[4]; /* break point instruction */
414 0e3cc9f4 2004-04-19 devnull uint bpsize; /* size of bp instruction */
415 0e3cc9f4 2004-04-19 devnull
416 0e3cc9f4 2004-04-19 devnull int (*foll)(Map*, Regs*, ulong, ulong*); /* follow set */
417 0e3cc9f4 2004-04-19 devnull char* (*exc)(Map*, Regs*); /* last exception */
418 cdf18051 2004-12-25 devnull int (*unwind)(Map*, Regs*, ulong*, Symbol*);
419 0e3cc9f4 2004-04-19 devnull
420 0e3cc9f4 2004-04-19 devnull /* cvt to local byte order */
421 0e3cc9f4 2004-04-19 devnull u16int (*swap2)(u16int);
422 0e3cc9f4 2004-04-19 devnull u32int (*swap4)(u32int);
423 0e3cc9f4 2004-04-19 devnull u64int (*swap8)(u64int);
424 0e3cc9f4 2004-04-19 devnull int (*ftoa32)(char*, uint, void*);
425 0e3cc9f4 2004-04-19 devnull int (*ftoa64)(char*, uint, void*);
426 0e3cc9f4 2004-04-19 devnull int (*ftoa80)(char*, uint, void*);
427 0e3cc9f4 2004-04-19 devnull
428 0e3cc9f4 2004-04-19 devnull /* disassembly */
429 0e3cc9f4 2004-04-19 devnull int (*das)(Map*, ulong, char, char*, int); /* symbolic */
430 0e3cc9f4 2004-04-19 devnull int (*kendas)(Map*, ulong, char, char*, int); /* symbolic */
431 0e3cc9f4 2004-04-19 devnull int (*codas)(Map*, ulong, char, char*, int);
432 0e3cc9f4 2004-04-19 devnull int (*hexinst)(Map*, ulong, char*, int); /* hex */
433 0e3cc9f4 2004-04-19 devnull int (*instsize)(Map*, ulong); /* instruction size */
434 0e3cc9f4 2004-04-19 devnull };
435 0e3cc9f4 2004-04-19 devnull
436 0e3cc9f4 2004-04-19 devnull Mach *machbyname(char*);
437 0e3cc9f4 2004-04-19 devnull Mach *machbytype(uint);
438 0e3cc9f4 2004-04-19 devnull
439 0e3cc9f4 2004-04-19 devnull extern Mach mach386;
440 0e3cc9f4 2004-04-19 devnull extern Mach machsparc;
441 0e3cc9f4 2004-04-19 devnull extern Mach machmips;
442 0e3cc9f4 2004-04-19 devnull extern Mach machpower;
443 0e3cc9f4 2004-04-19 devnull
444 0e3cc9f4 2004-04-19 devnull /*
445 0e3cc9f4 2004-04-19 devnull * Debugging symbols and type information.
446 0e3cc9f4 2004-04-19 devnull * (Not all objects include type information.)
447 0e3cc9f4 2004-04-19 devnull *
448 0e3cc9f4 2004-04-19 devnull * sym.c
449 0e3cc9f4 2004-04-19 devnull */
450 0e3cc9f4 2004-04-19 devnull
451 0e3cc9f4 2004-04-19 devnull enum
452 0e3cc9f4 2004-04-19 devnull {
453 0e3cc9f4 2004-04-19 devnull /* symbol table classes */
454 0e3cc9f4 2004-04-19 devnull CNONE,
455 0e3cc9f4 2004-04-19 devnull CAUTO, /* stack variable */
456 0e3cc9f4 2004-04-19 devnull CPARAM, /* function parameter */
457 0e3cc9f4 2004-04-19 devnull CTEXT, /* text segment */
458 0e3cc9f4 2004-04-19 devnull CDATA, /* data segment */
459 cbeb0b26 2006-04-01 devnull CANY
460 0e3cc9f4 2004-04-19 devnull };
461 0e3cc9f4 2004-04-19 devnull
462 0e3cc9f4 2004-04-19 devnull struct Symbol
463 0e3cc9f4 2004-04-19 devnull {
464 0e3cc9f4 2004-04-19 devnull char *name; /* name of symbol */
465 72dd4491 2005-11-29 devnull char *xname; /* demangled name */
466 72dd4491 2005-11-29 devnull
467 0e3cc9f4 2004-04-19 devnull /* Symtype *typedesc; /* type info, if any */
468 0e3cc9f4 2004-04-19 devnull Loc loc; /* location of symbol */
469 0e3cc9f4 2004-04-19 devnull Loc hiloc; /* location of end of symbol */
470 0e3cc9f4 2004-04-19 devnull char class; /* CAUTO, ... */
471 0e3cc9f4 2004-04-19 devnull char type; /* type letter from a.out.h */
472 0e3cc9f4 2004-04-19 devnull Fhdr *fhdr; /* where did this come from? */
473 0e3cc9f4 2004-04-19 devnull uint index; /* in by-address list */
474 0e3cc9f4 2004-04-19 devnull
475 0e3cc9f4 2004-04-19 devnull /* private use by various symbol implementations */
476 0e3cc9f4 2004-04-19 devnull union {
477 0e3cc9f4 2004-04-19 devnull struct {
478 0e3cc9f4 2004-04-19 devnull uint unit;
479 0e3cc9f4 2004-04-19 devnull uint uoff;
480 0e3cc9f4 2004-04-19 devnull } dwarf;
481 0e3cc9f4 2004-04-19 devnull struct {
482 0e3cc9f4 2004-04-19 devnull uint i;
483 0e3cc9f4 2004-04-19 devnull uint locals;
484 0e3cc9f4 2004-04-19 devnull char *dir;
485 0e3cc9f4 2004-04-19 devnull char *file;
486 1c171e3a 2005-07-19 devnull schar frameptr;
487 0e3cc9f4 2004-04-19 devnull uint framesize;
488 0e3cc9f4 2004-04-19 devnull } stabs;
489 0e3cc9f4 2004-04-19 devnull } u;
490 72dd4491 2005-11-29 devnull
491 72dd4491 2005-11-29 devnull void *aux; /* for use by client */
492 0e3cc9f4 2004-04-19 devnull };
493 0e3cc9f4 2004-04-19 devnull
494 0e3cc9f4 2004-04-19 devnull /* look through all currently cracked Fhdrs calling their fns */
495 0e3cc9f4 2004-04-19 devnull int pc2file(ulong pc, char *file, uint nfile, ulong *line);
496 0e3cc9f4 2004-04-19 devnull int file2pc(char *file, ulong line, ulong *addr);
497 0e3cc9f4 2004-04-19 devnull int line2pc(ulong basepc, ulong line, ulong *pc);
498 0e3cc9f4 2004-04-19 devnull int fnbound(ulong pc, ulong *bounds);
499 0e3cc9f4 2004-04-19 devnull int fileline(ulong pc, char *a, uint n);
500 0e3cc9f4 2004-04-19 devnull int pc2line(ulong pc, ulong *line);
501 0e3cc9f4 2004-04-19 devnull
502 0e3cc9f4 2004-04-19 devnull int lookupsym(char *fn, char *var, Symbol *s);
503 0e3cc9f4 2004-04-19 devnull int indexsym(uint ndx, Symbol *s);
504 0e3cc9f4 2004-04-19 devnull int findsym(Loc loc, uint class, Symbol *s);
505 0e3cc9f4 2004-04-19 devnull int findexsym(Fhdr*, uint, Symbol*);
506 0e3cc9f4 2004-04-19 devnull
507 0e3cc9f4 2004-04-19 devnull int lookuplsym(Symbol *s1, char *name, Symbol *s2);
508 0e3cc9f4 2004-04-19 devnull int indexlsym(Symbol *s1, uint ndx, Symbol *s2);
509 0e3cc9f4 2004-04-19 devnull int findlsym(Symbol *s1, Loc loc, Symbol *s);
510 0e3cc9f4 2004-04-19 devnull int symoff(char *a, uint n, ulong addr, uint class);
511 cdf18051 2004-12-25 devnull int unwindframe(Map *map, Regs *regs, ulong *next, Symbol*);
512 0e3cc9f4 2004-04-19 devnull
513 0e3cc9f4 2004-04-19 devnull void _addhdr(Fhdr*);
514 0e3cc9f4 2004-04-19 devnull void _delhdr(Fhdr*);
515 67e4fce4 2004-04-19 devnull extern Fhdr* fhdrlist;
516 cdf18051 2004-12-25 devnull Fhdr* findhdr(char*);
517 0e3cc9f4 2004-04-19 devnull
518 0e3cc9f4 2004-04-19 devnull Symbol* flookupsym(Fhdr*, char*);
519 0e3cc9f4 2004-04-19 devnull Symbol* ffindsym(Fhdr*, Loc, uint);
520 1a0954ab 2005-01-04 devnull Symbol* _addsym(Fhdr*, Symbol*);
521 0e3cc9f4 2004-04-19 devnull
522 88c60622 2005-11-28 devnull char* demangle(char*, char*, int);
523 88c60622 2005-11-28 devnull char* demanglegcc3(char*, char*);
524 88c60622 2005-11-28 devnull char* demanglegcc2(char*, char*);
525 0e3cc9f4 2004-04-19 devnull /*
526 0e3cc9f4 2004-04-19 devnull * Stack frame walking.
527 0e3cc9f4 2004-04-19 devnull *
528 0e3cc9f4 2004-04-19 devnull * frame.c
529 0e3cc9f4 2004-04-19 devnull */
530 0e3cc9f4 2004-04-19 devnull int stacktrace(Map*, Regs*, Tracer);
531 0e3cc9f4 2004-04-19 devnull int windindex(char*);
532 0e3cc9f4 2004-04-19 devnull Loc* windreglocs(void);
533 0e3cc9f4 2004-04-19 devnull
534 0e3cc9f4 2004-04-19 devnull /*
535 0e3cc9f4 2004-04-19 devnull * Debugger help.
536 0e3cc9f4 2004-04-19 devnull */
537 0e3cc9f4 2004-04-19 devnull int localaddr(Map *map, Regs *regs, char *fn, char *var, ulong *val);
538 0e3cc9f4 2004-04-19 devnull int fpformat(Map *map, Regdesc *reg, char *a, uint n, uint code);
539 0e3cc9f4 2004-04-19 devnull char* _hexify(char*, ulong, int);
540 0e3cc9f4 2004-04-19 devnull int locfmt(Fmt*);
541 0e3cc9f4 2004-04-19 devnull int loccmp(Loc*, Loc*);
542 0e3cc9f4 2004-04-19 devnull int locsimplify(Map *map, Regs *regs, Loc loc, Loc *newloc);
543 042aca77 2005-01-07 devnull Regdesc* regdesc(char*);
544 281c90a5 2005-02-11 devnull
545 0e3cc9f4 2004-04-19 devnull extern int machdebug;
546 1a0954ab 2005-01-04 devnull #if defined(__cplusplus)
547 1a0954ab 2005-01-04 devnull }
548 1a0954ab 2005-01-04 devnull #endif
549 1a0954ab 2005-01-04 devnull #endif