1 /* Find a variable's value in memory, for GDB, the GNU debugger.
2 Copyright (C) 1986, 1987, 1989 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
30 #if !defined (GET_SAVED_REGISTER)
32 /* Return the address in which frame FRAME's value of register REGNUM
33 has been saved in memory. Or return zero if it has not been saved.
34 If REGNUM specifies the SP, the value we return is actually
35 the SP value, not an address where it was saved. */
38 find_saved_register (frame, regnum)
42 struct frame_info *fi;
43 struct frame_saved_regs saved_regs;
45 register FRAME frame1 = 0;
46 register CORE_ADDR addr = 0;
48 if (frame == 0) /* No regs saved if want current frame */
51 #ifdef HAVE_REGISTER_WINDOWS
52 /* We assume that a register in a register window will only be saved
53 in one place (since the name changes and/or disappears as you go
54 towards inner frames), so we only call get_frame_saved_regs on
55 the current frame. This is directly in contradiction to the
56 usage below, which assumes that registers used in a frame must be
57 saved in a lower (more interior) frame. This change is a result
58 of working on a register window machine; get_frame_saved_regs
59 always returns the registers saved within a frame, within the
60 context (register namespace) of that frame. */
62 /* However, note that we don't want this to return anything if
63 nothing is saved (if there's a frame inside of this one). Also,
64 callers to this routine asking for the stack pointer want the
65 stack pointer saved for *this* frame; this is returned from the
69 if (REGISTER_IN_WINDOW_P(regnum))
71 frame1 = get_next_frame (frame);
72 if (!frame1) return 0; /* Registers of this frame are
75 /* Get the SP from the next frame in; it will be this
77 if (regnum != SP_REGNUM)
80 fi = get_frame_info (frame1);
81 get_frame_saved_regs (fi, &saved_regs);
82 return saved_regs.regs[regnum]; /* ... which might be zero */
84 #endif /* HAVE_REGISTER_WINDOWS */
86 /* Note that this next routine assumes that registers used in
87 frame x will be saved only in the frame that x calls and
88 frames interior to it. This is not true on the sparc, but the
89 above macro takes care of it, so we should be all right. */
93 frame1 = get_prev_frame (frame1);
94 if (frame1 == 0 || frame1 == frame)
96 fi = get_frame_info (frame1);
97 get_frame_saved_regs (fi, &saved_regs);
98 if (saved_regs.regs[regnum])
99 addr = saved_regs.regs[regnum];
105 /* Find register number REGNUM relative to FRAME and put its
106 (raw) contents in *RAW_BUFFER. Set *OPTIMIZED if the variable
107 was optimized out (and thus can't be fetched). Set *LVAL to
108 lval_memory, lval_register, or not_lval, depending on whether the
109 value was fetched from memory, from a register, or in a strange
110 and non-modifiable way (e.g. a frame pointer which was calculated
111 rather than fetched). Set *ADDRP to the address, either in memory
112 on as a REGISTER_BYTE offset into the registers array.
114 Note that this implementation never sets *LVAL to not_lval. But
115 it can be replaced by defining GET_SAVED_REGISTER and supplying
118 The argument RAW_BUFFER must point to aligned memory. */
120 get_saved_register (raw_buffer, optimized, addrp, frame, regnum, lval)
126 enum lval_type *lval;
129 /* Normal systems don't optimize out things with register numbers. */
130 if (optimized != NULL)
132 addr = find_saved_register (frame, regnum);
137 if (regnum == SP_REGNUM)
139 if (raw_buffer != NULL)
140 *(CORE_ADDR *)raw_buffer = addr;
145 if (raw_buffer != NULL)
146 read_memory (addr, raw_buffer, REGISTER_RAW_SIZE (regnum));
151 *lval = lval_register;
152 addr = REGISTER_BYTE (regnum);
153 if (raw_buffer != NULL)
154 read_register_gen (regnum, raw_buffer);
159 #endif /* GET_SAVED_REGISTER. */
161 /* Copy the bytes of register REGNUM, relative to the current stack frame,
162 into our memory at MYADDR, in target byte order.
163 The number of bytes copied is REGISTER_RAW_SIZE (REGNUM).
165 Returns 1 if could not be read, 0 if could. */
168 read_relative_register_raw_bytes (regnum, myaddr)
173 if (regnum == FP_REGNUM && selected_frame)
175 bcopy (&FRAME_FP(selected_frame), myaddr, sizeof (CORE_ADDR));
176 SWAP_TARGET_AND_HOST (myaddr, sizeof (CORE_ADDR)); /* in target order */
180 get_saved_register (myaddr, &optim, (CORE_ADDR *) NULL, selected_frame,
181 regnum, (enum lval_type *)NULL);
185 /* Return a `value' with the contents of register REGNUM
186 in its virtual format, with the type specified by
187 REGISTER_VIRTUAL_TYPE. */
190 value_of_register (regnum)
196 char raw_buffer[MAX_REGISTER_RAW_SIZE];
197 char virtual_buffer[MAX_REGISTER_VIRTUAL_SIZE];
200 get_saved_register (raw_buffer, &optim, &addr,
201 selected_frame, regnum, &lval);
203 target_convert_to_virtual (regnum, raw_buffer, virtual_buffer);
204 val = allocate_value (REGISTER_VIRTUAL_TYPE (regnum));
205 bcopy (virtual_buffer, VALUE_CONTENTS_RAW (val),
206 REGISTER_VIRTUAL_SIZE (regnum));
207 VALUE_LVAL (val) = lval;
208 VALUE_ADDRESS (val) = addr;
209 VALUE_REGNO (val) = regnum;
210 VALUE_OPTIMIZED_OUT (val) = optim;
214 /* Low level examining and depositing of registers.
216 The caller is responsible for making
217 sure that the inferior is stopped before calling the fetching routines,
218 or it will get garbage. (a change from GDB version 3, in which
219 the caller got the value from the last stop). */
221 /* Contents of the registers in target byte order.
222 We allocate some extra slop since we do a lot of bcopy's around `registers',
223 and failing-soft is better than failing hard. */
224 char registers[REGISTER_BYTES + /* SLOP */ 256];
226 /* Nonzero if that register has been fetched. */
227 char register_valid[NUM_REGS];
229 /* Indicate that registers may have changed, so invalidate the cache. */
234 for (i = 0; i < NUM_REGS; i++)
235 register_valid[i] = 0;
238 /* Indicate that all registers have been fetched, so mark them all valid. */
243 for (i = 0; i < NUM_REGS; i++)
244 register_valid[i] = 1;
247 /* Copy LEN bytes of consecutive data from registers
248 starting with the REGBYTE'th byte of register data
249 into memory at MYADDR. */
252 read_register_bytes (regbyte, myaddr, len)
257 /* Fetch all registers. */
259 for (i = 0; i < NUM_REGS; i++)
260 if (!register_valid[i])
262 target_fetch_registers (-1);
266 bcopy (®isters[regbyte], myaddr, len);
269 /* Read register REGNO into memory at MYADDR, which must be large enough
270 for REGISTER_RAW_BYTES (REGNO). Target byte-order.
271 If the register is known to be the size of a CORE_ADDR or smaller,
272 read_register can be used instead. */
274 read_register_gen (regno, myaddr)
278 if (!register_valid[regno])
279 target_fetch_registers (regno);
280 bcopy (®isters[REGISTER_BYTE (regno)], myaddr, REGISTER_RAW_SIZE (regno));
283 /* Copy LEN bytes of consecutive data from memory at MYADDR
284 into registers starting with the REGBYTE'th byte of register data. */
287 write_register_bytes (regbyte, myaddr, len)
292 /* Make sure the entire registers array is valid. */
293 read_register_bytes (0, (char *)NULL, REGISTER_BYTES);
294 bcopy (myaddr, ®isters[regbyte], len);
295 target_store_registers (-1);
298 /* Return the contents of register REGNO, regarding it as an integer. */
301 read_register (regno)
305 if (!register_valid[regno])
306 target_fetch_registers (regno);
307 /* FIXME, this loses when REGISTER_RAW_SIZE (regno) != sizeof (int) */
308 reg = *(int *) ®isters[REGISTER_BYTE (regno)];
309 SWAP_TARGET_AND_HOST (®, sizeof (int));
313 /* Registers we shouldn't try to store. */
314 #if !defined (CANNOT_STORE_REGISTER)
315 #define CANNOT_STORE_REGISTER(regno) 0
318 /* Store VALUE in the register number REGNO, regarded as an integer. */
321 write_register (regno, val)
324 /* On the sparc, writing %g0 is a no-op, so we don't even want to change
325 the registers array if something writes to this register. */
326 if (CANNOT_STORE_REGISTER (regno))
329 SWAP_TARGET_AND_HOST (&val, sizeof (int));
331 target_prepare_to_store ();
333 register_valid [regno] = 1;
334 /* FIXME, this loses when REGISTER_RAW_SIZE (regno) != sizeof (int) */
335 /* FIXME, this depends on REGISTER_BYTE (regno) being aligned for host */
336 *(int *) ®isters[REGISTER_BYTE (regno)] = val;
338 target_store_registers (regno);
341 /* Record that register REGNO contains VAL.
342 This is used when the value is obtained from the inferior or core dump,
343 so there is no need to store the value there. */
346 supply_register (regno, val)
350 register_valid[regno] = 1;
351 bcopy (val, ®isters[REGISTER_BYTE (regno)], REGISTER_RAW_SIZE (regno));
354 /* Given a struct symbol for a variable,
355 and a stack frame id, read the value of the variable
356 and return a (pointer to a) struct value containing the value.
357 If the variable cannot be found, return a zero pointer.
358 If FRAME is NULL, use the selected_frame. */
361 read_var_value (var, frame)
362 register struct symbol *var;
366 struct frame_info *fi;
367 struct type *type = SYMBOL_TYPE (var);
371 v = allocate_value (type);
372 VALUE_LVAL (v) = lval_memory; /* The most likely possibility. */
373 len = TYPE_LENGTH (type);
375 if (frame == 0) frame = selected_frame;
377 switch (SYMBOL_CLASS (var))
380 bcopy (&SYMBOL_VALUE (var), VALUE_CONTENTS_RAW (v), len);
381 SWAP_TARGET_AND_HOST (VALUE_CONTENTS_RAW (v), len);
382 VALUE_LVAL (v) = not_lval;
386 addr = SYMBOL_VALUE_ADDRESS (var);
387 bcopy (&addr, VALUE_CONTENTS_RAW (v), len);
388 SWAP_TARGET_AND_HOST (VALUE_CONTENTS_RAW (v), len);
389 VALUE_LVAL (v) = not_lval;
392 case LOC_CONST_BYTES:
395 bytes_addr = SYMBOL_VALUE_BYTES (var);
396 bcopy (bytes_addr, VALUE_CONTENTS_RAW (v), len);
397 VALUE_LVAL (v) = not_lval;
403 addr = SYMBOL_VALUE_ADDRESS (var);
406 /* Nonzero if a struct which is located in a register or a LOC_ARG
408 the address of the struct, not the struct itself. GCC_P is nonzero
409 if the function was compiled with GCC. */
410 #if !defined (REG_STRUCT_HAS_ADDR)
411 #define REG_STRUCT_HAS_ADDR(gcc_p) 0
415 fi = get_frame_info (frame);
418 addr = FRAME_ARGS_ADDRESS (fi);
422 addr += SYMBOL_VALUE (var);
426 fi = get_frame_info (frame);
429 addr = FRAME_ARGS_ADDRESS (fi);
433 addr += SYMBOL_VALUE (var);
434 read_memory (addr, &addr, sizeof (CORE_ADDR));
439 fi = get_frame_info (frame);
442 addr = SYMBOL_VALUE (var) + FRAME_LOCALS_ADDRESS (fi);
446 error ("Cannot look up value of a typedef");
450 VALUE_ADDRESS (v) = BLOCK_START (SYMBOL_BLOCK_VALUE (var));
460 b = get_frame_block (frame);
462 v = value_from_register (type, SYMBOL_VALUE (var), frame);
464 if (REG_STRUCT_HAS_ADDR (BLOCK_GCC_COMPILED (b))
465 && TYPE_CODE (type) == TYPE_CODE_STRUCT)
466 addr = *(CORE_ADDR *)VALUE_CONTENTS (v);
473 error ("Cannot look up value of a botched symbol.");
477 VALUE_ADDRESS (v) = addr;
482 /* Return a value of type TYPE, stored in register REGNUM, in frame
486 value_from_register (type, regnum, frame)
491 char raw_buffer [MAX_REGISTER_RAW_SIZE];
492 char virtual_buffer[MAX_REGISTER_VIRTUAL_SIZE];
495 value v = allocate_value (type);
496 int len = TYPE_LENGTH (type);
497 char *value_bytes = 0;
498 int value_bytes_copied = 0;
499 int num_storage_locs;
502 VALUE_REGNO (v) = regnum;
504 num_storage_locs = (len > REGISTER_VIRTUAL_SIZE (regnum) ?
505 ((len - 1) / REGISTER_RAW_SIZE (regnum)) + 1 :
508 if (num_storage_locs > 1)
510 /* Value spread across multiple storage locations. */
513 int mem_stor = 0, reg_stor = 0;
514 int mem_tracking = 1;
515 CORE_ADDR last_addr = 0;
516 CORE_ADDR first_addr;
518 value_bytes = (char *) alloca (len + MAX_REGISTER_RAW_SIZE);
520 /* Copy all of the data out, whereever it may be. */
522 for (local_regnum = regnum;
523 value_bytes_copied < len;
524 (value_bytes_copied += REGISTER_RAW_SIZE (local_regnum),
527 get_saved_register (value_bytes + value_bytes_copied,
533 if (lval == lval_register)
539 if (regnum == local_regnum)
544 && (regnum == local_regnum
545 || addr == last_addr));
550 if ((reg_stor && mem_stor)
551 || (mem_stor && !mem_tracking))
552 /* Mixed storage; all of the hassle we just went through was
553 for some good purpose. */
555 VALUE_LVAL (v) = lval_reg_frame_relative;
556 VALUE_FRAME (v) = FRAME_FP (frame);
557 VALUE_FRAME_REGNUM (v) = regnum;
561 VALUE_LVAL (v) = lval_memory;
562 VALUE_ADDRESS (v) = first_addr;
566 VALUE_LVAL (v) = lval_register;
567 VALUE_ADDRESS (v) = first_addr;
570 fatal ("value_from_register: Value not stored anywhere!");
572 VALUE_OPTIMIZED_OUT (v) = optim;
574 /* Any structure stored in more than one register will always be
575 an integral number of registers. Otherwise, you'd need to do
576 some fiddling with the last register copied here for little
579 /* Copy into the contents section of the value. */
580 bcopy (value_bytes, VALUE_CONTENTS_RAW (v), len);
585 /* Data is completely contained within a single register. Locate the
586 register's contents in a real register or in core;
587 read the data in raw format. */
589 get_saved_register (raw_buffer, &optim, &addr, frame, regnum, &lval);
590 VALUE_OPTIMIZED_OUT (v) = optim;
591 VALUE_LVAL (v) = lval;
592 VALUE_ADDRESS (v) = addr;
594 /* Convert the raw contents to virtual contents.
595 (Just copy them if the formats are the same.) */
597 target_convert_to_virtual (regnum, raw_buffer, virtual_buffer);
599 if (REGISTER_CONVERTIBLE (regnum))
601 /* When the raw and virtual formats differ, the virtual format
602 corresponds to a specific data type. If we want that type,
603 copy the data into the value.
604 Otherwise, do a type-conversion. */
606 if (type != REGISTER_VIRTUAL_TYPE (regnum))
608 /* eg a variable of type `float' in a 68881 register
609 with raw type `extended' and virtual type `double'.
610 Fetch it as a `double' and then convert to `float'. */
611 v = allocate_value (REGISTER_VIRTUAL_TYPE (regnum));
612 bcopy (virtual_buffer, VALUE_CONTENTS_RAW (v), len);
613 v = value_cast (type, v);
616 bcopy (virtual_buffer, VALUE_CONTENTS_RAW (v), len);
620 /* Raw and virtual formats are the same for this register. */
622 #if TARGET_BYTE_ORDER == BIG_ENDIAN
623 if (len < REGISTER_RAW_SIZE (regnum))
625 /* Big-endian, and we want less than full size. */
626 VALUE_OFFSET (v) = REGISTER_RAW_SIZE (regnum) - len;
630 bcopy (virtual_buffer + VALUE_OFFSET (v),
631 VALUE_CONTENTS_RAW (v), len);
637 /* Given a struct symbol for a variable or function,
638 and a stack frame id,
639 return a (pointer to a) struct value containing the properly typed
643 locate_var_value (var, frame)
644 register struct symbol *var;
648 struct type *type = SYMBOL_TYPE (var);
649 struct type *result_type;
652 /* Evaluate it first; if the result is a memory address, we're fine.
653 Lazy evaluation pays off here. */
655 lazy_value = read_var_value (var, frame);
657 error ("Address of \"%s\" is unknown.", SYMBOL_NAME (var));
659 if (VALUE_LAZY (lazy_value)
660 || TYPE_CODE (type) == TYPE_CODE_FUNC)
662 addr = VALUE_ADDRESS (lazy_value);
664 /* C++: The "address" of a reference should yield the address
665 * of the object pointed to. So force an extra de-reference. */
667 if (TYPE_CODE (type) == TYPE_CODE_REF)
669 char *buf = alloca (TYPE_LENGTH (type));
670 read_memory (addr, buf, TYPE_LENGTH (type));
671 addr = unpack_pointer (type, buf);
672 type = TYPE_TARGET_TYPE (type);
675 /* Address of an array is of the type of address of it's elements. */
676 /* FIXME, this is probably wrong now for ANSI C. */
678 lookup_pointer_type (TYPE_CODE (type) == TYPE_CODE_ARRAY ?
679 TYPE_TARGET_TYPE (type) : type);
681 return value_cast (result_type,
682 value_from_long (builtin_type_long, (LONGEST) addr));
685 /* Not a memory address; check what the problem was. */
686 switch (VALUE_LVAL (lazy_value))
689 case lval_reg_frame_relative:
690 error ("Address requested for identifier \"%s\" which is in a register.",
695 error ("Can't take address of \"%s\" which isn't an lvalue.",
699 return 0; /* For lint -- never reached */