diff -r 474fbb650afe -r 568a2971c977 GDBMI_stack_list_arguments.st --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/GDBMI_stack_list_arguments.st Thu Jun 12 01:21:45 2014 +0100 @@ -0,0 +1,117 @@ +"{ Package: 'jv:libgdbs' }" + +GDBMICommand subclass:#GDBMI_stack_list_arguments + instanceVariableNames:'' + classVariableNames:'' + poolDictionaries:'' + category:'GDB-Core-Commands-MI' +! + +!GDBMI_stack_list_arguments class methodsFor:'documentation'! + +documentation +" +The `-stack-list-arguments' Command +----------------------------------- + +Synopsis +........ + + -stack-list-arguments [ --no-frame-filters ] [ --skip-unavailable ] PRINT-VALUES + [ LOW-FRAME HIGH-FRAME ] + + Display a list of the arguments for the frames between LOW-FRAME and +HIGH-FRAME (inclusive). If LOW-FRAME and HIGH-FRAME are not provided, +list the arguments for the whole call stack. If the two arguments are +equal, show the single frame at the corresponding level. It is an +error if LOW-FRAME is larger than the actual number of frames. On the +other hand, HIGH-FRAME may be larger than the actual number of frames, +in which case only existing frames will be returned. + + If PRINT-VALUES is 0 or `--no-values', print only the names of the +variables; if it is 1 or `--all-values', print also their values; and +if it is 2 or `--simple-values', print the name, type and value for +simple data types, and the name and type for arrays, structures and +unions. If the option `--no-frame-filters' is supplied, then Python +frame filters will not be executed. + + If the `--skip-unavailable' option is specified, arguments that are +not available are not listed. Partially available arguments are still +displayed, however. + + Use of this command to obtain arguments in a single frame is +deprecated in favor of the `-stack-list-variables' command. + +{No value for `GDBN'} Command +............................. + +{No value for `GDBN'} does not have an equivalent command. `gdbtk' has +a `gdb_get_args' command which partially overlaps with the +functionality of `-stack-list-arguments'. + +Example +....... + + (gdb) + -stack-list-frames + ^done, + stack=[ + frame={level='0',addr='0x00010734',func='callee4', + file='../../../devo/gdb/testsuite/gdb.mi/basics.c', + fullname='/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c',line='8'}, + frame={level='1',addr='0x0001076c',func='callee3', + file='../../../devo/gdb/testsuite/gdb.mi/basics.c', + fullname='/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c',line='17'}, + frame={level='2',addr='0x0001078c',func='callee2', + file='../../../devo/gdb/testsuite/gdb.mi/basics.c', + fullname='/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c',line='22'}, + frame={level='3',addr='0x000107b4',func='callee1', + file='../../../devo/gdb/testsuite/gdb.mi/basics.c', + fullname='/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c',line='27'}, + frame={level='4',addr='0x000107e0',func='main', + file='../../../devo/gdb/testsuite/gdb.mi/basics.c', + fullname='/home/foo/bar/devo/gdb/testsuite/gdb.mi/basics.c',line='32'}] + (gdb) + -stack-list-arguments 0 + ^done, + stack-args=[ + frame={level='0',args=[]}, + frame={level='1',args=[name='strarg']}, + frame={level='2',args=[name='intarg',name='strarg']}, + frame={level='3',args=[name='intarg',name='strarg',name='fltarg']}, + frame={level='4',args=[]}] + (gdb) + -stack-list-arguments 1 + ^done, + stack-args=[ + frame={level='0',args=[]}, + frame={level='1', + args=[{name='strarg',value='0x11940 \'A string argument.\''}]}, + frame={level='2',args=[ + {name='intarg',value='2'}, + {name='strarg',value='0x11940 \'A string argument.\''}]}, + {frame={level='3',args=[ + {name='intarg',value='2'}, + {name='strarg',value='0x11940 \'A string argument.\''}, + {name='fltarg',value='3.5'}]}, + frame={level='4',args=[]}] + (gdb) + -stack-list-arguments 0 2 2 + ^done,stack-args=[frame={level='2',args=[name='intarg',name='strarg']}] + (gdb) + -stack-list-arguments 1 2 2 + ^done,stack-args=[frame={level='2', + args=[{name='intarg',value='2'}, + {name='strarg',value='0x11940 \'A string argument.\''}]}] + (gdb) + + +" +! ! + +!GDBMI_stack_list_arguments methodsFor:'accessing'! + +operation + ^ 'stack-list-arguments' +! ! +