1 /* Find a variable's value in memory, for GDB, the GNU debugger.
2 Copyright 1986, 1987, 1989, 1991 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. */
29 #if !defined (GET_SAVED_REGISTER)
31 /* Return the address in which frame FRAME's value of register REGNUM
32 has been saved in memory. Or return zero if it has not been saved.
33 If REGNUM specifies the SP, the value we return is actually
34 the SP value, not an address where it was saved. */
37 find_saved_register (frame, regnum)
41 struct frame_info *fi;
42 struct frame_saved_regs saved_regs;
44 register FRAME frame1 = 0;
45 register CORE_ADDR addr = 0;
47 if (frame == 0) /* No regs saved if want current frame */
50 #ifdef HAVE_REGISTER_WINDOWS
51 /* We assume that a register in a register window will only be saved
52 in one place (since the name changes and/or disappears as you go
53 towards inner frames), so we only call get_frame_saved_regs on
54 the current frame. This is directly in contradiction to the
55 usage below, which assumes that registers used in a frame must be
56 saved in a lower (more interior) frame. This change is a result
57 of working on a register window machine; get_frame_saved_regs
58 always returns the registers saved within a frame, within the
59 context (register namespace) of that frame. */
61 /* However, note that we don't want this to return anything if
62 nothing is saved (if there's a frame inside of this one). Also,
63 callers to this routine asking for the stack pointer want the
64 stack pointer saved for *this* frame; this is returned from the
68 if (REGISTER_IN_WINDOW_P(regnum))
70 frame1 = get_next_frame (frame);
71 if (!frame1) return 0; /* Registers of this frame are
74 /* Get the SP from the next frame in; it will be this
76 if (regnum != SP_REGNUM)
79 fi = get_frame_info (frame1);
80 get_frame_saved_regs (fi, &saved_regs);
81 return saved_regs.regs[regnum]; /* ... which might be zero */
83 #endif /* HAVE_REGISTER_WINDOWS */
85 /* Note that this next routine assumes that registers used in
86 frame x will be saved only in the frame that x calls and
87 frames interior to it. This is not true on the sparc, but the
88 above macro takes care of it, so we should be all right. */
92 frame1 = get_prev_frame (frame1);
93 if (frame1 == 0 || frame1 == frame)
95 fi = get_frame_info (frame1);
96 get_frame_saved_regs (fi, &saved_regs);
97 if (saved_regs.regs[regnum])
98 addr = saved_regs.regs[regnum];
104 /* Find register number REGNUM relative to FRAME and put its
105 (raw) contents in *RAW_BUFFER. Set *OPTIMIZED if the variable
106 was optimized out (and thus can't be fetched). Set *LVAL to
107 lval_memory, lval_register, or not_lval, depending on whether the
108 value was fetched from memory, from a register, or in a strange
109 and non-modifiable way (e.g. a frame pointer which was calculated
110 rather than fetched). Set *ADDRP to the address, either in memory
111 on as a REGISTER_BYTE offset into the registers array.
113 Note that this implementation never sets *LVAL to not_lval. But
114 it can be replaced by defining GET_SAVED_REGISTER and supplying
117 The argument RAW_BUFFER must point to aligned memory. */
119 get_saved_register (raw_buffer, optimized, addrp, frame, regnum, lval)
125 enum lval_type *lval;
128 /* Normal systems don't optimize out things with register numbers. */
129 if (optimized != NULL)
131 addr = find_saved_register (frame, regnum);
136 if (regnum == SP_REGNUM)
138 if (raw_buffer != NULL)
139 *(CORE_ADDR *)raw_buffer = addr;
144 if (raw_buffer != NULL)
145 read_memory (addr, raw_buffer, REGISTER_RAW_SIZE (regnum));
150 *lval = lval_register;
151 addr = REGISTER_BYTE (regnum);
152 if (raw_buffer != NULL)
153 read_register_gen (regnum, raw_buffer);
158 #endif /* GET_SAVED_REGISTER. */
160 /* Copy the bytes of register REGNUM, relative to the current stack frame,
161 into our memory at MYADDR, in target byte order.
162 The number of bytes copied is REGISTER_RAW_SIZE (REGNUM).
164 Returns 1 if could not be read, 0 if could. */
167 read_relative_register_raw_bytes (regnum, myaddr)
172 if (regnum == FP_REGNUM && selected_frame)
174 memcpy (myaddr, &FRAME_FP(selected_frame), REGISTER_RAW_SIZE(FP_REGNUM));
175 SWAP_TARGET_AND_HOST (myaddr, REGISTER_RAW_SIZE(FP_REGNUM)); /* in target order */
179 get_saved_register (myaddr, &optim, (CORE_ADDR *) NULL, selected_frame,
180 regnum, (enum lval_type *)NULL);
184 /* Return a `value' with the contents of register REGNUM
185 in its virtual format, with the type specified by
186 REGISTER_VIRTUAL_TYPE. */
189 value_of_register (regnum)
195 char raw_buffer[MAX_REGISTER_RAW_SIZE];
196 char virtual_buffer[MAX_REGISTER_VIRTUAL_SIZE];
199 get_saved_register (raw_buffer, &optim, &addr,
200 selected_frame, regnum, &lval);
202 REGISTER_CONVERT_TO_VIRTUAL (regnum, raw_buffer, virtual_buffer);
203 val = allocate_value (REGISTER_VIRTUAL_TYPE (regnum));
204 memcpy (VALUE_CONTENTS_RAW (val), virtual_buffer,
205 REGISTER_VIRTUAL_SIZE (regnum));
206 VALUE_LVAL (val) = lval;
207 VALUE_ADDRESS (val) = addr;
208 VALUE_REGNO (val) = regnum;
209 VALUE_OPTIMIZED_OUT (val) = optim;
213 /* Low level examining and depositing of registers.
215 The caller is responsible for making
216 sure that the inferior is stopped before calling the fetching routines,
217 or it will get garbage. (a change from GDB version 3, in which
218 the caller got the value from the last stop). */
220 /* Contents of the registers in target byte order.
221 We allocate some extra slop since we do a lot of bcopy's around `registers',
222 and failing-soft is better than failing hard. */
223 char registers[REGISTER_BYTES + /* SLOP */ 256];
225 /* Nonzero if that register has been fetched. */
226 char register_valid[NUM_REGS];
228 /* Indicate that registers may have changed, so invalidate the cache. */
233 for (i = 0; i < NUM_REGS; i++)
234 register_valid[i] = 0;
237 /* Indicate that all registers have been fetched, so mark them all valid. */
242 for (i = 0; i < NUM_REGS; i++)
243 register_valid[i] = 1;
246 /* Copy LEN bytes of consecutive data from registers
247 starting with the REGBYTE'th byte of register data
248 into memory at MYADDR. */
251 read_register_bytes (regbyte, myaddr, len)
256 /* Fetch all registers. */
258 for (i = 0; i < NUM_REGS; i++)
259 if (!register_valid[i])
261 target_fetch_registers (-1);
265 memcpy (myaddr, ®isters[regbyte], len);
268 /* Read register REGNO into memory at MYADDR, which must be large enough
269 for REGISTER_RAW_BYTES (REGNO). Target byte-order.
270 If the register is known to be the size of a CORE_ADDR or smaller,
271 read_register can be used instead. */
273 read_register_gen (regno, myaddr)
277 if (!register_valid[regno])
278 target_fetch_registers (regno);
279 memcpy (myaddr, ®isters[REGISTER_BYTE (regno)],
280 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 memcpy (®isters[regbyte], myaddr, len);
295 target_store_registers (-1);
298 /* Return the contents of register REGNO, regarding it as an integer. */
299 /* FIXME, this loses when the REGISTER_VIRTUAL (REGNO) is true. Also,
300 why is the return type CORE_ADDR rather than some integer type? */
303 read_register (regno)
312 if (!register_valid[regno])
313 target_fetch_registers (regno);
315 size = REGISTER_RAW_SIZE(regno);
317 if (size == sizeof (unsigned char))
318 return registers[REGISTER_BYTE (regno)];
319 else if (size == sizeof (sval))
321 memcpy (&sval, ®isters[REGISTER_BYTE (regno)], sizeof (sval));
322 SWAP_TARGET_AND_HOST (&sval, sizeof (sval));
325 else if (size == sizeof (ival))
327 memcpy (&ival, ®isters[REGISTER_BYTE (regno)], sizeof (ival));
328 SWAP_TARGET_AND_HOST (&ival, sizeof (ival));
331 else if (size == sizeof (lval))
333 memcpy (&lval, ®isters[REGISTER_BYTE (regno)], sizeof (lval));
334 SWAP_TARGET_AND_HOST (&lval, sizeof (lval));
339 error ("GDB Internal Error in read_register() for register %d, size %d",
340 regno, REGISTER_RAW_SIZE(regno));
344 /* Registers we shouldn't try to store. */
345 #if !defined (CANNOT_STORE_REGISTER)
346 #define CANNOT_STORE_REGISTER(regno) 0
349 /* Store VALUE in the register number REGNO, regarded as an integer. */
350 /* FIXME, this loses when REGISTER_VIRTUAL (REGNO) is true. Also,
351 shouldn't the val arg be a LONGEST or something? */
354 write_register (regno, val)
364 /* On the sparc, writing %g0 is a no-op, so we don't even want to change
365 the registers array if something writes to this register. */
366 if (CANNOT_STORE_REGISTER (regno))
369 /* If we have a valid copy of the register, and new value == old value,
370 then don't bother doing the actual store. */
372 size = REGISTER_RAW_SIZE(regno);
374 if (size == sizeof(cval))
379 else if (size == sizeof(sval))
384 else if (size == sizeof(ival))
389 else if (size == sizeof(lval))
396 error ("GDB Internal Error in write_register() for register %d, size %d",
400 if (register_valid [regno])
402 SWAP_TARGET_AND_HOST (ptr, size);
403 if (memcmp (®isters[REGISTER_BYTE (regno)],
408 target_prepare_to_store ();
410 memcpy (®isters[REGISTER_BYTE (regno)], ptr, size);
412 register_valid [regno] = 1;
414 target_store_registers (regno);
417 /* Record that register REGNO contains VAL.
418 This is used when the value is obtained from the inferior or core dump,
419 so there is no need to store the value there. */
422 supply_register (regno, val)
426 register_valid[regno] = 1;
427 memcpy (®isters[REGISTER_BYTE (regno)], val, REGISTER_RAW_SIZE (regno));
429 /* On some architectures, e.g. HPPA, there are a few stray bits in some
430 registers, that the rest of the code would like to ignore. */
431 #ifdef CLEAN_UP_REGISTER_VALUE
432 CLEAN_UP_REGISTER_VALUE(regno, ®isters[REGISTER_BYTE(regno)]);
436 /* Given a struct symbol for a variable,
437 and a stack frame id, read the value of the variable
438 and return a (pointer to a) struct value containing the value.
439 If the variable cannot be found, return a zero pointer.
440 If FRAME is NULL, use the selected_frame. */
443 read_var_value (var, frame)
444 register struct symbol *var;
448 struct frame_info *fi;
449 struct type *type = SYMBOL_TYPE (var);
453 v = allocate_value (type);
454 VALUE_LVAL (v) = lval_memory; /* The most likely possibility. */
455 len = TYPE_LENGTH (type);
457 if (frame == 0) frame = selected_frame;
459 switch (SYMBOL_CLASS (var))
462 memcpy (VALUE_CONTENTS_RAW (v), &SYMBOL_VALUE (var), len);
463 SWAP_TARGET_AND_HOST (VALUE_CONTENTS_RAW (v), len);
464 VALUE_LVAL (v) = not_lval;
468 addr = SYMBOL_VALUE_ADDRESS (var);
469 memcpy (VALUE_CONTENTS_RAW (v), &addr, len);
470 SWAP_TARGET_AND_HOST (VALUE_CONTENTS_RAW (v), len);
471 VALUE_LVAL (v) = not_lval;
474 case LOC_CONST_BYTES:
477 bytes_addr = SYMBOL_VALUE_BYTES (var);
478 memcpy (VALUE_CONTENTS_RAW (v), bytes_addr, len);
479 VALUE_LVAL (v) = not_lval;
484 addr = SYMBOL_VALUE_ADDRESS (var);
488 if (SYMBOL_BASEREG_VALID (var))
490 addr = FRAME_GET_BASEREG_VALUE (frame, SYMBOL_BASEREG (var));
494 fi = get_frame_info (frame);
497 addr = FRAME_ARGS_ADDRESS (fi);
503 addr += SYMBOL_VALUE (var);
507 if (SYMBOL_BASEREG_VALID (var))
509 addr = FRAME_GET_BASEREG_VALUE (frame, SYMBOL_BASEREG (var));
513 fi = get_frame_info (frame);
516 addr = FRAME_ARGS_ADDRESS (fi);
522 addr += SYMBOL_VALUE (var);
523 read_memory (addr, (char *) &addr, sizeof (CORE_ADDR));
528 if (SYMBOL_BASEREG_VALID (var))
530 addr = FRAME_GET_BASEREG_VALUE (frame, SYMBOL_BASEREG (var));
534 fi = get_frame_info (frame);
537 addr = FRAME_LOCALS_ADDRESS (fi);
539 addr += SYMBOL_VALUE (var);
543 error ("Cannot look up value of a typedef");
547 VALUE_ADDRESS (v) = BLOCK_START (SYMBOL_BLOCK_VALUE (var));
552 case LOC_REGPARM_ADDR:
558 b = get_frame_block (frame);
560 v = value_from_register (type, SYMBOL_VALUE (var), frame);
562 if (SYMBOL_CLASS (var) == LOC_REGPARM_ADDR)
564 addr = *(CORE_ADDR *)VALUE_CONTENTS (v);
565 VALUE_LVAL (v) = lval_memory;
572 case LOC_OPTIMIZED_OUT:
573 VALUE_LVAL (v) = not_lval;
574 VALUE_OPTIMIZED_OUT (v) = 1;
578 error ("Cannot look up value of a botched symbol.");
582 VALUE_ADDRESS (v) = addr;
587 /* Return a value of type TYPE, stored in register REGNUM, in frame
591 value_from_register (type, regnum, frame)
596 char raw_buffer [MAX_REGISTER_RAW_SIZE];
597 char virtual_buffer[MAX_REGISTER_VIRTUAL_SIZE];
600 value v = allocate_value (type);
601 int len = TYPE_LENGTH (type);
602 char *value_bytes = 0;
603 int value_bytes_copied = 0;
604 int num_storage_locs;
607 VALUE_REGNO (v) = regnum;
609 num_storage_locs = (len > REGISTER_VIRTUAL_SIZE (regnum) ?
610 ((len - 1) / REGISTER_RAW_SIZE (regnum)) + 1 :
613 if (num_storage_locs > 1
614 #ifdef GDB_TARGET_IS_H8500
615 || TYPE_CODE (type) == TYPE_CODE_PTR
619 /* Value spread across multiple storage locations. */
622 int mem_stor = 0, reg_stor = 0;
623 int mem_tracking = 1;
624 CORE_ADDR last_addr = 0;
625 CORE_ADDR first_addr;
627 value_bytes = (char *) alloca (len + MAX_REGISTER_RAW_SIZE);
629 /* Copy all of the data out, whereever it may be. */
631 #ifdef GDB_TARGET_IS_H8500
632 /* This piece of hideosity is required because the H8500 treats registers
633 differently depending upon whether they are used as pointers or not. As a
634 pointer, a register needs to have a page register tacked onto the front.
635 An alternate way to do this would be to have gcc output different register
636 numbers for the pointer & non-pointer form of the register. But, it
637 doesn't, so we're stuck with this. */
639 if (TYPE_CODE (type) == TYPE_CODE_PTR
646 case R0_REGNUM: case R1_REGNUM: case R2_REGNUM: case R3_REGNUM:
647 page_regnum = SEG_D_REGNUM;
649 case R4_REGNUM: case R5_REGNUM:
650 page_regnum = SEG_E_REGNUM;
652 case R6_REGNUM: case R7_REGNUM:
653 page_regnum = SEG_T_REGNUM;
658 get_saved_register (value_bytes + 1,
665 if (lval == lval_register)
672 get_saved_register (value_bytes + 2,
679 if (lval == lval_register)
684 mem_tracking = mem_tracking && (addr == last_addr);
689 #endif /* GDB_TARGET_IS_H8500 */
690 for (local_regnum = regnum;
691 value_bytes_copied < len;
692 (value_bytes_copied += REGISTER_RAW_SIZE (local_regnum),
695 get_saved_register (value_bytes + value_bytes_copied,
702 if (regnum == local_regnum)
704 if (lval == lval_register)
712 && (regnum == local_regnum
713 || addr == last_addr));
718 if ((reg_stor && mem_stor)
719 || (mem_stor && !mem_tracking))
720 /* Mixed storage; all of the hassle we just went through was
721 for some good purpose. */
723 VALUE_LVAL (v) = lval_reg_frame_relative;
724 VALUE_FRAME (v) = FRAME_FP (frame);
725 VALUE_FRAME_REGNUM (v) = regnum;
729 VALUE_LVAL (v) = lval_memory;
730 VALUE_ADDRESS (v) = first_addr;
734 VALUE_LVAL (v) = lval_register;
735 VALUE_ADDRESS (v) = first_addr;
738 fatal ("value_from_register: Value not stored anywhere!");
740 VALUE_OPTIMIZED_OUT (v) = optim;
742 /* Any structure stored in more than one register will always be
743 an integral number of registers. Otherwise, you'd need to do
744 some fiddling with the last register copied here for little
747 /* Copy into the contents section of the value. */
748 memcpy (VALUE_CONTENTS_RAW (v), value_bytes, len);
750 /* Finally do any conversion necessary when extracting this
751 type from more than one register. */
752 #ifdef REGISTER_CONVERT_TO_TYPE
753 REGISTER_CONVERT_TO_TYPE(regnum, type, VALUE_CONTENTS_RAW(v));
758 /* Data is completely contained within a single register. Locate the
759 register's contents in a real register or in core;
760 read the data in raw format. */
762 get_saved_register (raw_buffer, &optim, &addr, frame, regnum, &lval);
763 VALUE_OPTIMIZED_OUT (v) = optim;
764 VALUE_LVAL (v) = lval;
765 VALUE_ADDRESS (v) = addr;
767 /* Convert the raw contents to virtual contents.
768 (Just copy them if the formats are the same.) */
770 REGISTER_CONVERT_TO_VIRTUAL (regnum, raw_buffer, virtual_buffer);
772 if (REGISTER_CONVERTIBLE (regnum))
774 /* When the raw and virtual formats differ, the virtual format
775 corresponds to a specific data type. If we want that type,
776 copy the data into the value.
777 Otherwise, do a type-conversion. */
779 if (type != REGISTER_VIRTUAL_TYPE (regnum))
781 /* eg a variable of type `float' in a 68881 register
782 with raw type `extended' and virtual type `double'.
783 Fetch it as a `double' and then convert to `float'. */
784 v = allocate_value (REGISTER_VIRTUAL_TYPE (regnum));
785 memcpy (VALUE_CONTENTS_RAW (v), virtual_buffer, len);
786 v = value_cast (type, v);
789 memcpy (VALUE_CONTENTS_RAW (v), virtual_buffer, len);
793 /* Raw and virtual formats are the same for this register. */
795 #if TARGET_BYTE_ORDER == BIG_ENDIAN
796 if (len < REGISTER_RAW_SIZE (regnum))
798 /* Big-endian, and we want less than full size. */
799 VALUE_OFFSET (v) = REGISTER_RAW_SIZE (regnum) - len;
803 memcpy (VALUE_CONTENTS_RAW (v), virtual_buffer + VALUE_OFFSET (v), len);
809 /* Given a struct symbol for a variable or function,
810 and a stack frame id,
811 return a (pointer to a) struct value containing the properly typed
815 locate_var_value (var, frame)
816 register struct symbol *var;
820 struct type *type = SYMBOL_TYPE (var);
823 /* Evaluate it first; if the result is a memory address, we're fine.
824 Lazy evaluation pays off here. */
826 lazy_value = read_var_value (var, frame);
828 error ("Address of \"%s\" is unknown.", SYMBOL_SOURCE_NAME (var));
830 if (VALUE_LAZY (lazy_value)
831 || TYPE_CODE (type) == TYPE_CODE_FUNC)
833 addr = VALUE_ADDRESS (lazy_value);
834 return value_from_longest (lookup_pointer_type (type), (LONGEST) addr);
837 /* Not a memory address; check what the problem was. */
838 switch (VALUE_LVAL (lazy_value))
841 case lval_reg_frame_relative:
842 error ("Address requested for identifier \"%s\" which is in a register.",
843 SYMBOL_SOURCE_NAME (var));
847 error ("Can't take address of \"%s\" which isn't an lvalue.",
848 SYMBOL_SOURCE_NAME (var));
851 return 0; /* For lint -- never reached */