espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-20 01:50:24 +08:00
Code Issues Packages Projects Releases Wiki Activity

(GDB/MI Variable Objects): Describe meanings of

Browse Source 
values for in_scope.  Mention that only root variables can be
updated.
(GDB/MI Development and Front Ends): Explain new values may be
added to existing fields.
This commit is contained in:
Nick Roberts
2007-02-12 23:53:02 +00:00
parent eb819d7017
commit 36ece8b31d
1 changed files with 37 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
gdb/doc/gdb.texinfo
View File

@ -17732,6 +17732,10 @@ New MI commands may be added.
@item @item
New fields may be added to the output of any MI command. New fields may be added to the output of any MI command.
@item
The range of values for fields with specified values, e.g.,
@code{in_scope} (@pxref{-var-update}) may be extended.
@c The format of field's content e.g type prefix, may change so parse it @c The format of field's content e.g type prefix, may change so parse it
@c at your own risk. Yes, in general? @c at your own risk. Yes, in general?
@ -19972,16 +19976,16 @@ subsequent @code{-var-update} list.
Reevaluate the expressions corresponding to the variable object Reevaluate the expressions corresponding to the variable object
@var{name} and all its direct and indirect children, and return the @var{name} and all its direct and indirect children, and return the
list of variable objects whose values have changed. Here, list of variable objects whose values have changed; @var{name} must
``changed'' means that the result of @code{-var-evaluate-expression} before be a root variable object. Here, ``changed'' means that the result of
and after the @code{-var-update} is different. If @samp{*} is used @code{-var-evaluate-expression} before and after the
as the variable object names, all existing variable objects are @code{-var-update} is different. If @samp{*} is used as the variable
updated. The option @var{print-values} determines whether both names object names, all existing variable objects are updated. The option
and values, or just names are printed. The possible values of @var{print-values} determines whether both names and values, or just
this options are the same as for @code{-var-list-children} names are printed. The possible values of this options are the same
(@pxref{-var-list-children}). It is recommended to use the as for @code{-var-list-children} (@pxref{-var-list-children}). It is
@samp{--all-values} option, to reduce the number of MI commands needed recommended to use the @samp{--all-values} option, to reduce the
on each program stop. number of MI commands needed on each program stop.
@subsubheading Example @subsubheading Example
@ -19997,6 +20001,29 @@ type_changed="false"@}]
(gdb) (gdb)
@end smallexample @end smallexample
@anchor{-var-update}
The field in_scope may take three values:
@table @code
@item "true"
The variable object's current value is valid.
@item "false"
The variable object does not currently hold a valid value but it may
hold one in the future if its associated expression comes back into
scope.
@item "invalid"
The variable object no longer holds a valid value.
This can occur when the executable file being debugged has changed,
either through recompilation or by using the @value{GDBN} @code{file}
command. The front end should normally choose to delete these variable
objects.
@end table
In the future new values may be added to this list so the front should
be prepared for this possibility. @xref{GDB/MI Development and Front Ends, ,@sc{GDB/MI} Development and Front Ends}.
@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@node GDB/MI Data Manipulation @node GDB/MI Data Manipulation
@section @sc{gdb/mi} Data Manipulation @section @sc{gdb/mi} Data Manipulation