1 /* Traditional frame unwind support, for GDB the GNU Debugger.
3 Copyright (C) 2003-2019 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "trad-frame.h"
24 #include "frame-unwind.h"
29 struct trad_frame_cache
31 struct frame_info *this_frame;
33 struct trad_frame_saved_reg *prev_regs;
34 struct frame_id this_id;
37 struct trad_frame_cache *
38 trad_frame_cache_zalloc (struct frame_info *this_frame)
40 struct trad_frame_cache *this_trad_cache;
42 this_trad_cache = FRAME_OBSTACK_ZALLOC (struct trad_frame_cache);
43 this_trad_cache->prev_regs = trad_frame_alloc_saved_regs (this_frame);
44 this_trad_cache->this_frame = this_frame;
45 return this_trad_cache;
48 /* See trad-frame.h. */
51 trad_frame_reset_saved_regs (struct gdbarch *gdbarch,
52 struct trad_frame_saved_reg *regs)
54 int numregs = gdbarch_num_cooked_regs (gdbarch);
55 for (int regnum = 0; regnum < numregs; regnum++)
57 regs[regnum].realreg = regnum;
58 regs[regnum].addr = -1;
62 struct trad_frame_saved_reg *
63 trad_frame_alloc_saved_regs (struct gdbarch *gdbarch)
65 int numregs = gdbarch_num_cooked_regs (gdbarch);
66 struct trad_frame_saved_reg *this_saved_regs
67 = FRAME_OBSTACK_CALLOC (numregs, struct trad_frame_saved_reg);
69 trad_frame_reset_saved_regs (gdbarch, this_saved_regs);
70 return this_saved_regs;
73 /* A traditional frame is unwound by analysing the function prologue
74 and using the information gathered to track registers. For
75 non-optimized frames, the technique is reliable (just need to check
76 for all potential instruction sequences). */
78 struct trad_frame_saved_reg *
79 trad_frame_alloc_saved_regs (struct frame_info *this_frame)
81 struct gdbarch *gdbarch = get_frame_arch (this_frame);
83 return trad_frame_alloc_saved_regs (gdbarch);
86 enum { TF_REG_VALUE = -1, TF_REG_UNKNOWN = -2 };
89 trad_frame_value_p (struct trad_frame_saved_reg this_saved_regs[], int regnum)
91 return (this_saved_regs[regnum].realreg == TF_REG_VALUE);
95 trad_frame_addr_p (struct trad_frame_saved_reg this_saved_regs[], int regnum)
97 return (this_saved_regs[regnum].realreg >= 0
98 && this_saved_regs[regnum].addr != -1);
102 trad_frame_realreg_p (struct trad_frame_saved_reg this_saved_regs[],
105 return (this_saved_regs[regnum].realreg >= 0
106 && this_saved_regs[regnum].addr == -1);
110 trad_frame_set_value (struct trad_frame_saved_reg this_saved_regs[],
111 int regnum, LONGEST val)
113 /* Make the REALREG invalid, indicating that the ADDR contains the
115 this_saved_regs[regnum].realreg = TF_REG_VALUE;
116 this_saved_regs[regnum].addr = val;
119 /* See trad-frame.h. */
122 trad_frame_set_realreg (struct trad_frame_saved_reg this_saved_regs[],
123 int regnum, int realreg)
125 this_saved_regs[regnum].realreg = realreg;
126 this_saved_regs[regnum].addr = -1;
129 /* See trad-frame.h. */
132 trad_frame_set_addr (struct trad_frame_saved_reg this_saved_regs[],
133 int regnum, CORE_ADDR addr)
135 this_saved_regs[regnum].realreg = regnum;
136 this_saved_regs[regnum].addr = addr;
140 trad_frame_set_reg_value (struct trad_frame_cache *this_trad_cache,
141 int regnum, LONGEST val)
143 /* External interface for users of trad_frame_cache
144 (who cannot access the prev_regs object directly). */
145 trad_frame_set_value (this_trad_cache->prev_regs, regnum, val);
149 trad_frame_set_reg_realreg (struct trad_frame_cache *this_trad_cache,
150 int regnum, int realreg)
152 trad_frame_set_realreg (this_trad_cache->prev_regs, regnum, realreg);
156 trad_frame_set_reg_addr (struct trad_frame_cache *this_trad_cache,
157 int regnum, CORE_ADDR addr)
159 trad_frame_set_addr (this_trad_cache->prev_regs, regnum, addr);
163 trad_frame_set_reg_regmap (struct trad_frame_cache *this_trad_cache,
164 const struct regcache_map_entry *regmap,
165 CORE_ADDR addr, size_t size)
167 struct gdbarch *gdbarch = get_frame_arch (this_trad_cache->this_frame);
170 for (; (count = regmap->count) != 0; regmap++)
172 int regno = regmap->regno;
173 int slot_size = regmap->size;
175 if (slot_size == 0 && regno != REGCACHE_MAP_SKIP)
176 slot_size = register_size (gdbarch, regno);
178 if (offs + slot_size > size)
181 if (regno == REGCACHE_MAP_SKIP)
182 offs += count * slot_size;
184 for (; count--; regno++, offs += slot_size)
186 /* Mimic the semantics of regcache::transfer_regset if a
187 register slot's size does not match the size of a
190 If a register slot is larger than a register, assume
191 the register's value is stored in the first N bytes of
192 the slot and ignore the remaining bytes.
194 If the register slot is smaller than the register,
195 assume that the slot contains the low N bytes of the
196 register's value. Since trad_frame assumes that
197 registers stored by address are sized according to the
198 register, read the low N bytes and zero-extend them to
199 generate a register value. */
200 if (slot_size >= register_size (gdbarch, regno))
201 trad_frame_set_reg_addr (this_trad_cache, regno, addr + offs);
204 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
205 gdb_byte buf[slot_size];
207 if (target_read_memory (addr + offs, buf, sizeof buf) == 0)
210 = extract_unsigned_integer (buf, sizeof buf, byte_order);
211 trad_frame_set_reg_value (this_trad_cache, regno, val);
219 trad_frame_set_unknown (struct trad_frame_saved_reg this_saved_regs[],
222 /* Make the REALREG invalid, indicating that the value is not known. */
223 this_saved_regs[regnum].realreg = TF_REG_UNKNOWN;
224 this_saved_regs[regnum].addr = -1;
228 trad_frame_get_prev_register (struct frame_info *this_frame,
229 struct trad_frame_saved_reg this_saved_regs[],
232 if (trad_frame_addr_p (this_saved_regs, regnum))
233 /* The register was saved in memory. */
234 return frame_unwind_got_memory (this_frame, regnum,
235 this_saved_regs[regnum].addr);
236 else if (trad_frame_realreg_p (this_saved_regs, regnum))
237 return frame_unwind_got_register (this_frame, regnum,
238 this_saved_regs[regnum].realreg);
239 else if (trad_frame_value_p (this_saved_regs, regnum))
240 /* The register's value is available. */
241 return frame_unwind_got_constant (this_frame, regnum,
242 this_saved_regs[regnum].addr);
244 return frame_unwind_got_optimized (this_frame, regnum);
248 trad_frame_get_register (struct trad_frame_cache *this_trad_cache,
249 struct frame_info *this_frame,
252 return trad_frame_get_prev_register (this_frame, this_trad_cache->prev_regs,
257 trad_frame_set_id (struct trad_frame_cache *this_trad_cache,
258 struct frame_id this_id)
260 this_trad_cache->this_id = this_id;
264 trad_frame_get_id (struct trad_frame_cache *this_trad_cache,
265 struct frame_id *this_id)
267 (*this_id) = this_trad_cache->this_id;
271 trad_frame_set_this_base (struct trad_frame_cache *this_trad_cache,
274 this_trad_cache->this_base = this_base;
278 trad_frame_get_this_base (struct trad_frame_cache *this_trad_cache)
280 return this_trad_cache->this_base;