X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fvalue.h;h=5f8fe58c0adf8970b3d9e6133ba6a2a105bc7c06;hb=2b2d9e11a0bd5355936c876a8d14a06d78d4b39e;hp=ed4d9ee0b3412e3c287e7d80fd75c6c52d0d6416;hpb=4754a64e16a0afde77699cd300487822b46e8247;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/value.h b/gdb/value.h index ed4d9ee0b3..5f8fe58c0a 100644 --- a/gdb/value.h +++ b/gdb/value.h @@ -1,14 +1,14 @@ /* Definitions for values of C expressions, for GDB. - Copyright 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, - 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 - Free Software Foundation, Inc. + Copyright (C) 1986, 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, + 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, + 2008 Free Software Foundation, Inc. This file is part of GDB. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, @@ -17,9 +17,7 @@ GNU General Public License for more details. You should have received a copy of the GNU General Public License - along with this program; if not, write to the Free Software - Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. */ + along with this program. If not, see . */ #if !defined (VALUE_H) #define VALUE_H 1 @@ -39,184 +37,192 @@ struct ui_file; inferior (i.e. to be put into the history list or an internal variable). */ -struct value -{ - /* Type of value; either not an lval, or one of the various - different possible kinds of lval. */ - enum lval_type lval; - - /* Is it modifiable? Only relevant if lval != not_lval. */ - int modifiable; - - /* Location of value (if lval). */ - union - { - /* If lval == lval_memory, this is the address in the inferior. - If lval == lval_register, this is the byte offset into the - registers structure. */ - CORE_ADDR address; - - /* Pointer to internal variable. */ - struct internalvar *internalvar; - } location; - - /* Describes offset of a value within lval of a structure in bytes. - If lval == lval_memory, this is an offset to the address. If - lval == lval_register, this is a further offset from - location.address within the registers structure. Note also the - member embedded_offset below. */ - int offset; - - /* Only used for bitfields; number of bits contained in them. */ - int bitsize; - - /* Only used for bitfields; position of start of field. For - BITS_BIG_ENDIAN=0 targets, it is the position of the LSB. For - BITS_BIG_ENDIAN=1 targets, it is the position of the MSB. */ - int bitpos; - - /* Frame register value is relative to. This will be described in - the lval enum above as "lval_register". */ - struct frame_id frame_id; - - /* Type of the value. */ - struct type *type; - - /* If a value represents a C++ object, then the `type' field gives - the object's compile-time type. If the object actually belongs - to some class derived from `type', perhaps with other base - classes and additional members, then `type' is just a subobject - of the real thing, and the full object is probably larger than - `type' would suggest. - - If `type' is a dynamic class (i.e. one with a vtable), then GDB - can actually determine the object's run-time type by looking at - the run-time type information in the vtable. When this - information is available, we may elect to read in the entire - object, for several reasons: - - - When printing the value, the user would probably rather see the - full object, not just the limited portion apparent from the - compile-time type. +struct value; - - If `type' has virtual base classes, then even printing `type' - alone may require reaching outside the `type' portion of the - object to wherever the virtual base class has been stored. +/* Values are stored in a chain, so that they can be deleted easily + over calls to the inferior. Values assigned to internal variables + or put into the value history are taken off this list. */ - When we store the entire object, `enclosing_type' is the run-time - type -- the complete object -- and `embedded_offset' is the - offset of `type' within that larger type, in bytes. The - VALUE_CONTENTS macro takes `embedded_offset' into account, so - most GDB code continues to see the `type' portion of the value, - just as the inferior would. - - If `type' is a pointer to an object, then `enclosing_type' is a - pointer to the object's run-time type, and `pointed_to_offset' is - the offset in bytes from the full object to the pointed-to object - -- that is, the value `embedded_offset' would have if we followed - the pointer and fetched the complete object. (I don't really see - the point. Why not just determine the run-time type when you - indirect, and avoid the special case? The contents don't matter - until you indirect anyway.) - - If we're not doing anything fancy, `enclosing_type' is equal to - `type', and `embedded_offset' is zero, so everything works - normally. */ - struct type *enclosing_type; - int embedded_offset; - int pointed_to_offset; - - /* Values are stored in a chain, so that they can be deleted easily - over calls to the inferior. Values assigned to internal - variables or put into the value history are taken off this - list. */ - struct value *next; - - /* Register number if the value is from a register. */ - short regnum; - - /* If zero, contents of this value are in the contents field. If - nonzero, contents are in inferior memory at address in the - location.address field plus the offset field (and the lval field - should be lval_memory). - - WARNING: This field is used by the code which handles watchpoints - (see breakpoint.c) to decide whether a particular value can be - watched by hardware watchpoints. If the lazy flag is set for - some member of a value chain, it is assumed that this member of - the chain doesn't need to be watched as part of watching the - value itself. This is how GDB avoids watching the entire struct - or array when the user wants to watch a single struct member or - array element. If you ever change the way lazy flag is set and - reset, be sure to consider this use as well! */ - char lazy; - - /* If nonzero, this is the value of a variable which does not - actually exist in the program. */ - char optimized_out; - - /* Actual contents of the value. For use of this value; setting it - uses the stuff above. Not valid if lazy is nonzero. Target - byte-order. We force it to be aligned properly for any possible - value. Note that a value therefore extends beyond what is - declared here. */ - union - { - bfd_byte contents[1]; - DOUBLEST force_doublest_align; - LONGEST force_longest_align; - CORE_ADDR force_core_addr_align; - void *force_pointer_align; - } aligner; - /* Do not add any new members here -- contents above will trash - them. */ -}; +struct value *value_next (struct value *); +/* Type of the value. */ extern struct type *value_type (struct value *); + +/* This is being used to change the type of an existing value, that + code should instead be creating a new value with the changed type + (but possibly shared content). */ + +extern void deprecated_set_value_type (struct value *value, + struct type *type); + +/* Only used for bitfields; number of bits contained in them. */ + extern int value_bitsize (struct value *); +extern void set_value_bitsize (struct value *, int bit); + +/* Only used for bitfields; position of start of field. For + gdbarch_bits_big_endian=0 targets, it is the position of the LSB. For + gdbarch_bits_big_endian=1 targets, it is the position of the MSB. */ + extern int value_bitpos (struct value *); +extern void set_value_bitpos (struct value *, int bit); + +/* Describes offset of a value within lval of a structure in bytes. + If lval == lval_memory, this is an offset to the address. If lval + == lval_register, this is a further offset from location.address + within the registers structure. Note also the member + embedded_offset below. */ + extern int value_offset (struct value *); +extern void set_value_offset (struct value *, int offset); + +/* The comment from "struct value" reads: ``Is it modifiable? Only + relevant if lval != not_lval.''. Shouldn't the value instead be + not_lval and be done with it? */ + +extern int deprecated_value_modifiable (struct value *value); +extern void deprecated_set_value_modifiable (struct value *value, + int modifiable); + +/* If a value represents a C++ object, then the `type' field gives the + object's compile-time type. If the object actually belongs to some + class derived from `type', perhaps with other base classes and + additional members, then `type' is just a subobject of the real + thing, and the full object is probably larger than `type' would + suggest. + + If `type' is a dynamic class (i.e. one with a vtable), then GDB can + actually determine the object's run-time type by looking at the + run-time type information in the vtable. When this information is + available, we may elect to read in the entire object, for several + reasons: + + - When printing the value, the user would probably rather see the + full object, not just the limited portion apparent from the + compile-time type. -extern struct type *value_enclosing_type (struct value *); -#define VALUE_LAZY(val) (val)->lazy + - If `type' has virtual base classes, then even printing `type' + alone may require reaching outside the `type' portion of the + object to wherever the virtual base class has been stored. + + When we store the entire object, `enclosing_type' is the run-time + type -- the complete object -- and `embedded_offset' is the offset + of `type' within that larger type, in bytes. The value_contents() + macro takes `embedded_offset' into account, so most GDB code + continues to see the `type' portion of the value, just as the + inferior would. + + If `type' is a pointer to an object, then `enclosing_type' is a + pointer to the object's run-time type, and `pointed_to_offset' is + the offset in bytes from the full object to the pointed-to object + -- that is, the value `embedded_offset' would have if we followed + the pointer and fetched the complete object. (I don't really see + the point. Why not just determine the run-time type when you + indirect, and avoid the special case? The contents don't matter + until you indirect anyway.) + + If we're not doing anything fancy, `enclosing_type' is equal to + `type', and `embedded_offset' is zero, so everything works + normally. */ -/* VALUE_CONTENTS and value_contents_raw() both return the address of - the gdb buffer used to hold a copy of the contents of the lval. - VALUE_CONTENTS is used when the contents of the buffer are needed +extern struct type *value_enclosing_type (struct value *); +extern struct value *value_change_enclosing_type (struct value *val, + struct type *new_type); +extern int value_pointed_to_offset (struct value *value); +extern void set_value_pointed_to_offset (struct value *value, int val); +extern int value_embedded_offset (struct value *value); +extern void set_value_embedded_offset (struct value *value, int val); + +/* If zero, contents of this value are in the contents field. If + nonzero, contents are in inferior memory at address in the + location.address field plus the offset field (and the lval field + should be lval_memory). + + WARNING: This field is used by the code which handles watchpoints + (see breakpoint.c) to decide whether a particular value can be + watched by hardware watchpoints. If the lazy flag is set for some + member of a value chain, it is assumed that this member of the + chain doesn't need to be watched as part of watching the value + itself. This is how GDB avoids watching the entire struct or array + when the user wants to watch a single struct member or array + element. If you ever change the way lazy flag is set and reset, be + sure to consider this use as well! */ + +extern int value_lazy (struct value *); +extern void set_value_lazy (struct value *value, int val); + +/* value_contents() and value_contents_raw() both return the address + of the gdb buffer used to hold a copy of the contents of the lval. + value_contents() is used when the contents of the buffer are needed -- it uses value_fetch_lazy() to load the buffer from the process - being debugged if it hasn't already been loaded. - value_contents_raw() is used when data is being stored into the - buffer, or when it is certain that the contents of the buffer are - valid. + being debugged if it hasn't already been loaded + (value_contents_writeable() is used when a writeable but fetched + buffer is required).. value_contents_raw() is used when data is + being stored into the buffer, or when it is certain that the + contents of the buffer are valid. Note: The contents pointer is adjusted by the offset required to get to the real subobject, if the value happens to represent something embedded in a larger run-time object. */ -extern bfd_byte *value_contents_raw (struct value *); -#define VALUE_CONTENTS(val) \ - ((void)(VALUE_LAZY(val) && value_fetch_lazy(val)), \ - (val)->aligner.contents) +extern gdb_byte *value_contents_raw (struct value *); + +/* Actual contents of the value. For use of this value; setting it + uses the stuff above. Not valid if lazy is nonzero. Target + byte-order. We force it to be aligned properly for any possible + value. Note that a value therefore extends beyond what is + declared here. */ + +extern const gdb_byte *value_contents (struct value *); +extern gdb_byte *value_contents_writeable (struct value *); /* The ALL variants of the above two macros do not adjust the returned pointer by the embedded_offset value. */ -extern bfd_byte *value_contents_all_raw (struct value *); -#define VALUE_CONTENTS_ALL(val) \ - ((void) (VALUE_LAZY(val) && value_fetch_lazy(val)), \ - (val)->aligner.contents) +extern gdb_byte *value_contents_all_raw (struct value *); +extern const gdb_byte *value_contents_all (struct value *); extern int value_fetch_lazy (struct value *val); - -#define VALUE_LVAL(val) (val)->lval -#define VALUE_ADDRESS(val) (val)->location.address -#define VALUE_INTERNALVAR(val) (val)->location.internalvar -#define VALUE_FRAME_ID(val) ((val)->frame_id) -#define VALUE_REGNUM(val) (val)->regnum -#define VALUE_OPTIMIZED_OUT(val) ((val)->optimized_out) -#define VALUE_EMBEDDED_OFFSET(val) ((val)->embedded_offset) -#define VALUE_POINTED_TO_OFFSET(val) ((val)->pointed_to_offset) +extern int value_contents_equal (struct value *val1, struct value *val2); + +/* If nonzero, this is the value of a variable which does not actually + exist in the program. */ +extern int value_optimized_out (struct value *value); +extern void set_value_optimized_out (struct value *value, int val); + +/* Set or return field indicating whether a variable is initialized or + not, based on debugging information supplied by the compiler. + 1 = initialized; 0 = uninitialized. */ +extern int value_initialized (struct value *); +extern void set_value_initialized (struct value *, int); + +/* While the following fields are per- VALUE .CONTENT .PIECE (i.e., a + single value might have multiple LVALs), this hacked interface is + limited to just the first PIECE. Expect further change. */ +/* Type of value; either not an lval, or one of the various different + possible kinds of lval. */ +extern enum lval_type *deprecated_value_lval_hack (struct value *); +#define VALUE_LVAL(val) (*deprecated_value_lval_hack (val)) + +/* If lval == lval_memory, this is the address in the inferior. If + lval == lval_register, this is the byte offset into the registers + structure. */ +extern CORE_ADDR *deprecated_value_address_hack (struct value *); +#define VALUE_ADDRESS(val) (*deprecated_value_address_hack (val)) + +/* Pointer to internal variable. */ +extern struct internalvar **deprecated_value_internalvar_hack (struct value *); +#define VALUE_INTERNALVAR(val) (*deprecated_value_internalvar_hack (val)) + +/* Frame register value is relative to. This will be described in the + lval enum above as "lval_register". */ +extern struct frame_id *deprecated_value_frame_id_hack (struct value *); +#define VALUE_FRAME_ID(val) (*deprecated_value_frame_id_hack (val)) + +/* Register number if the value is from a register. */ +extern short *deprecated_value_regnum_hack (struct value *); +#define VALUE_REGNUM(val) (*deprecated_value_regnum_hack (val)) /* Convert a REF to the object referenced. */ @@ -243,13 +249,9 @@ struct internalvar struct internalvar *next; char *name; struct value *value; + int endian; }; -/* Pointer to member function. Depends on compiler implementation. */ - -#define METHOD_PTR_IS_VIRTUAL(ADDR) ((ADDR) & 0x80000000) -#define METHOD_PTR_FROM_VOFFSET(OFFSET) (0x80000000 + (OFFSET)) -#define METHOD_PTR_TO_VOFFSET(ADDR) (~0x80000000 & (ADDR)) #include "symtab.h" @@ -265,24 +267,36 @@ extern LONGEST value_as_long (struct value *val); extern DOUBLEST value_as_double (struct value *val); extern CORE_ADDR value_as_address (struct value *val); -extern LONGEST unpack_long (struct type *type, const char *valaddr); -extern DOUBLEST unpack_double (struct type *type, const char *valaddr, +extern LONGEST unpack_long (struct type *type, const gdb_byte *valaddr); +extern DOUBLEST unpack_double (struct type *type, const gdb_byte *valaddr, int *invp); -extern CORE_ADDR unpack_pointer (struct type *type, const char *valaddr); -extern LONGEST unpack_field_as_long (struct type *type, const char *valaddr, +extern CORE_ADDR unpack_pointer (struct type *type, const gdb_byte *valaddr); +extern LONGEST unpack_field_as_long (struct type *type, + const gdb_byte *valaddr, int fieldno); +extern void pack_long (gdb_byte *buf, struct type *type, LONGEST num); + extern struct value *value_from_longest (struct type *type, LONGEST num); extern struct value *value_from_pointer (struct type *type, CORE_ADDR addr); extern struct value *value_from_double (struct type *type, DOUBLEST num); +extern struct value *value_from_decfloat (struct type *type, + const gdb_byte *decbytes); extern struct value *value_from_string (char *string); extern struct value *value_at (struct type *type, CORE_ADDR addr); extern struct value *value_at_lazy (struct type *type, CORE_ADDR addr); +extern struct value *default_value_from_register (struct type *type, + int regnum, + struct frame_info *frame); + extern struct value *value_from_register (struct type *type, int regnum, struct frame_info *frame); +extern CORE_ADDR address_from_register (struct type *type, int regnum, + struct frame_info *frame); + extern struct value *value_of_variable (struct symbol *var, struct block *b); extern struct value *value_of_register (int regnum, struct frame_info *frame); @@ -299,9 +313,6 @@ extern struct value *allocate_value (struct type *type); extern struct value *allocate_repeat_value (struct type *type, int count); -extern struct value *value_change_enclosing_type (struct value *val, - struct type *new_type); - extern struct value *value_mark (void); extern void value_free_to_mark (struct value *mark); @@ -321,6 +332,10 @@ extern struct value *value_add (struct value *arg1, struct value *arg2); extern struct value *value_sub (struct value *arg1, struct value *arg2); +extern int value_must_coerce_to_target (struct value *arg1); + +extern struct value *value_coerce_to_target (struct value *arg1); + extern struct value *value_coerce_array (struct value *arg1); extern struct value *value_coerce_function (struct value *arg1); @@ -329,9 +344,13 @@ extern struct value *value_ind (struct value *arg1); extern struct value *value_addr (struct value *arg1); +extern struct value *value_ref (struct value *arg1); + extern struct value *value_assign (struct value *toval, struct value *fromval); +extern struct value *value_pos (struct value *arg1); + extern struct value *value_neg (struct value *arg1); extern struct value *value_complement (struct value *arg1); @@ -342,7 +361,9 @@ extern struct value *value_struct_elt (struct value **argp, char *err); extern struct value *value_aggregate_elt (struct type *curtype, - char *name, enum noside noside); + char *name, + int want_address, + enum noside noside); extern struct value *value_static_field (struct type *type, int fieldno); @@ -369,10 +390,14 @@ extern struct type *value_rtti_target_type (struct value *, int *, int *, extern struct value *value_full_object (struct value *, struct type *, int, int, int); +extern struct value *value_cast_pointers (struct type *, struct value *); + extern struct value *value_cast (struct type *type, struct value *arg2); extern struct value *value_zero (struct type *type, enum lval_type lv); +extern struct value *value_one (struct type *type, enum lval_type lv); + extern struct value *value_repeat (struct value *arg1, int count); extern struct value *value_subscript (struct value *array, struct value *idx); @@ -382,10 +407,10 @@ extern struct value *register_value_being_returned (struct type *valtype, extern struct value *value_in (struct value *element, struct value *set); -extern int value_bit_index (struct type *type, const bfd_byte *addr, +extern int value_bit_index (struct type *type, const gdb_byte *addr, int index); -extern int using_struct_return (struct type *value_type, int gcc_p); +extern int using_struct_return (struct type *value_type); extern struct value *evaluate_expression (struct expression *exp); @@ -417,6 +442,10 @@ extern void set_internalvar_component (struct internalvar *var, int bitpos, int bitsize, struct value *newvalue); +extern struct internalvar *lookup_only_internalvar (char *name); + +extern struct internalvar *create_internalvar (char *name); + extern struct internalvar *lookup_internalvar (char *name); extern int value_equal (struct value *arg1, struct value *arg2); @@ -455,21 +484,25 @@ extern void release_value (struct value *val); extern int record_latest_value (struct value *val); -extern void modify_field (char *addr, LONGEST fieldval, int bitpos, +extern void modify_field (gdb_byte *addr, LONGEST fieldval, int bitpos, int bitsize); extern void type_print (struct type *type, char *varstring, struct ui_file *stream, int show); -extern char *baseclass_addr (struct type *type, int index, char *valaddr, - struct value **valuep, int *errp); +extern gdb_byte *baseclass_addr (struct type *type, int index, + gdb_byte *valaddr, + struct value **valuep, int *errp); extern void print_longest (struct ui_file *stream, int format, int use_local, LONGEST val); -extern void print_floating (const bfd_byte *valaddr, struct type *type, +extern void print_floating (const gdb_byte *valaddr, struct type *type, struct ui_file *stream); +extern void print_decimal_floating (const gdb_byte *valaddr, struct type *type, + struct ui_file *stream); + extern int value_print (struct value *val, struct ui_file *stream, int format, enum val_prettyprint pretty); @@ -479,12 +512,17 @@ extern void value_print_array_elements (struct value *val, extern struct value *value_release_to_mark (struct value *mark); -extern int val_print (struct type *type, const bfd_byte *valaddr, +extern int val_print (struct type *type, const gdb_byte *valaddr, int embedded_offset, CORE_ADDR address, struct ui_file *stream, int format, int deref_ref, int recurse, enum val_prettyprint pretty); +extern int common_val_print (struct value *val, + struct ui_file *stream, int format, + int deref_ref, int recurse, + enum val_prettyprint pretty); + extern int val_print_string (CORE_ADDR addr, int len, int width, struct ui_file *stream); @@ -492,16 +530,14 @@ extern void print_variable_value (struct symbol *var, struct frame_info *frame, struct ui_file *stream); -extern int check_field (struct value *, const char *); +extern int check_field (struct type *, const char *); extern void typedef_print (struct type *type, struct symbol *news, struct ui_file *stream); extern char *internalvar_name (struct internalvar *var); -extern void clear_value_history (void); - -extern void clear_internalvars (void); +extern void preserve_values (struct objfile *); /* From values.c */ @@ -516,9 +552,6 @@ extern struct value *value_slice (struct value *, int, int); extern struct value *value_literal_complex (struct value *, struct value *, struct type *); -extern void find_rt_vbase_offset (struct type *, struct type *, - const bfd_byte *, int, int *, int *); - extern struct value *find_function_in_inferior (const char *); extern struct value *value_allocate_space_in_inferior (int);