Blame


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