From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25344 invoked by alias); 9 Feb 2006 21:52:54 -0000 Received: (qmail 25328 invoked by uid 22791); 9 Feb 2006 21:52:51 -0000 X-Spam-Check-By: sourceware.org Received: from viper.snap.net.nz (HELO viper.snap.net.nz) (202.37.101.8) by sourceware.org (qpsmtpd/0.31) with ESMTP; Thu, 09 Feb 2006 21:52:49 +0000 Received: from kahikatea.snap.net.nz (p202-124-115-212.snap.net.nz [202.124.115.212]) by viper.snap.net.nz (Postfix) with ESMTP id 2695F745808 for ; Fri, 10 Feb 2006 10:52:32 +1300 (NZDT) Received: by kahikatea.snap.net.nz (Postfix, from userid 500) id D3B398890; Fri, 10 Feb 2006 10:51:39 +1300 (NZDT) From: Nick Roberts MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <17387.47466.567939.339554@kahikatea.snap.net.nz> Date: Thu, 09 Feb 2006 21:52:00 -0000 To: gdb-patches@sourceware.org Subject: [PATCH] Doco for GDB/MI Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-02/txt/msg00223.txt.bz2 This patch reflects recent changes in MI output due to fullname being added to print_one_breakpoint (-break-insert and -break-info use this command too.), adds the times field where needed, corrects a couple of typos, updates the general form given for output of -break-insert (very out of date) and abbreviates some unnecessarily long fullnames. OK to commit? Nick 2006-02-10 Nick Roberts * gdb.texinfo (GDB/MI Breakpoint Table Commands): Add fullname and times fields where needed. Fix typos. Update general form given for output of -break-insert. (GDB/MI): Abbreviate some unnecessarily long fullnames. Nick *** gdb.texinfo 08 Feb 2006 17:49:00 +1300 1.312 --- gdb.texinfo 10 Feb 2006 10:45:39 +1300 *************** *** 17577,17583 **** @smallexample (@value{GDBP}) -break-insert main ! ^done,bkpt=@{number="1",addr="0x000100d0",file="hello.c",line="5"@} (@value{GDBP}) -break-after 1 3 ~ --- 17577,17583 ---- @smallexample (@value{GDBP}) -break-insert main ! ^done,bkpt=@{number="1",addr="0x000100d0",file="hello.c",fullname="/home/foo/hello.c",line="5",times="0"@} (@value{GDBP}) -break-after 1 3 ~ *************** *** 17592,17599 **** @{width="10",alignment="-1",col_name="addr",colhdr="Address"@}, @{width="40",alignment="2",col_name="what",colhdr="What"@}], body=[bkpt=@{number="1",type="breakpoint",disp="keep",enabled="y", ! addr="0x000100d0",func="main",file="hello.c",fullname="/home/foo/hello.c"line="5",times="0", ! ignore="3"@}]@} (@value{GDBP}) @end smallexample --- 17592,17598 ---- @{width="10",alignment="-1",col_name="addr",colhdr="Address"@}, @{width="40",alignment="2",col_name="what",colhdr="What"@}], body=[bkpt=@{number="1",type="breakpoint",disp="keep",enabled="y", ! addr="0x000100d0",func="main",file="hello.c",fullname="/home/foo/hello.c",line="5",times="0",ignore="3"@}]@} (@value{GDBP}) @end smallexample *************** *** 17798,17804 **** @table @samp @item -t ! Insert a tempoary breakpoint. @item -h Insert a hardware breakpoint. @item -c @var{condition} --- 17797,17803 ---- @table @samp @item -t ! Insert a temporary breakpoint. @item -h Insert a hardware breakpoint. @item -c @var{condition} *************** *** 17816,17830 **** The result is in the form: @smallexample ! ^done,bkptno="@var{number}",func="@var{funcname}", ! file="@var{filename}",line="@var{lineno}" @end smallexample @noindent ! where @var{number} is the @value{GDBN} number for this breakpoint, @var{funcname} ! is the name of the function where the breakpoint was inserted, ! @var{filename} is the name of the source file which contains this ! function, and @var{lineno} is the source line number within that file. Note: this format is open to change. @c An out-of-band breakpoint instead of part of the result? --- 17815,17833 ---- The result is in the form: @smallexample ! ^done,bkpt=@{number="@var{number}",type="@var{type}",disp="del"|"keep", ! enabled="y"|"n",addr="@var{hex}",func="@var{funcname}",file="@var{filename}", ! fullname="@var{full filename}",line="@var{lineno}",times="@var{times}"@} @end smallexample @noindent ! where @var{number} is the @value{GDBN} number for this breakpoint, ! @var{funcname} is the name of the function where the breakpoint was ! inserted, @var{filename} is the name of the source file which contains ! this function, @var{lineno} is the source line number within that file ! and @var{times} the number of times that the breakpoint has been hit ! (always 0 for -break-insert but may be greater for -break-info or -break-list ! which use the same output). Note: this format is open to change. @c An out-of-band breakpoint instead of part of the result? *************** *** 17839,17848 **** @smallexample (@value{GDBP}) -break-insert main ! ^done,bkpt=@{number="1",addr="0x0001072c",file="recursive2.c",line="4"@} (@value{GDBP}) -break-insert -t foo ! ^done,bkpt=@{number="2",addr="0x00010774",file="recursive2.c",line="11"@} (@value{GDBP}) -break-list ^done,BreakpointTable=@{nr_rows="2",nr_cols="6", --- 17842,17851 ---- @smallexample (@value{GDBP}) -break-insert main ! ^done,bkpt=@{number="1",addr="0x0001072c",file="recursive2.c",fullname="/home/foo/recursive2.c,line="4",times="0"@} (@value{GDBP}) -break-insert -t foo ! ^done,bkpt=@{number="2",addr="0x00010774",file="recursive2.c",fullname="/home/foo/recursive2.c,line="11",times="0"@} (@value{GDBP}) -break-list ^done,BreakpointTable=@{nr_rows="2",nr_cols="6", *************** *** 17859,17865 **** (@value{GDBP}) -break-insert -r foo.* ~int foo(int, int); ! ^done,bkpt=@{number="3",addr="0x00010774",file="recursive2.c",line="11"@} (@value{GDBP}) @end smallexample --- 17862,17868 ---- (@value{GDBP}) -break-insert -r foo.* ~int foo(int, int); ! ^done,bkpt=@{number="3",addr="0x00010774",file="recursive2.c"fullname="/home/foo/recursive2.c",line="11",times="0"@} (@value{GDBP}) @end smallexample *************** *** 17975,17981 **** ^done,reason="watchpoint-trigger",wpt=@{number="2",exp="x"@}, value=@{old="-268439212",new="55"@}, frame=@{func="main",args=[],file="recursive2.c", ! fullname="/home/foo/bar/devo/myproject/recursive2.c",line="5"@} (@value{GDBP}) @end smallexample --- 17978,17984 ---- ^done,reason="watchpoint-trigger",wpt=@{number="2",exp="x"@}, value=@{old="-268439212",new="55"@}, frame=@{func="main",args=[],file="recursive2.c", ! fullname="/home/foo/bar/recursive2.c",line="5"@} (@value{GDBP}) @end smallexample *************** *** 18292,18298 **** (@value{GDBP}) *stopped,reason="breakpoint-hit",bkptno="1",frame=@{func="main", ! args=[],file="try.c",fullname="/home/foo/bar/devo/myproject/try.c",line="5"@} (@value{GDBP}) -data-list-changed-registers ^done,changed-registers=["0","1","2","4","5","6","7","8","9", --- 18295,18301 ---- (@value{GDBP}) *stopped,reason="breakpoint-hit",bkptno="1",frame=@{func="main", ! args=[],file="try.c",fullname="/home/foo/bar/try.c",line="5"@} (@value{GDBP}) -data-list-changed-registers ^done,changed-registers=["0","1","2","4","5","6","7","8","9", *************** *** 18899,18905 **** (@value{GDBP}) @@Hello world *stopped,reason="breakpoint-hit",bkptno="2",frame=@{func="foo",args=[], ! file="hello.c",fullname="/home/foo/bar/devo/myproject/hello.c",line="13"@} (@value{GDBP}) @end smallexample --- 18902,18908 ---- (@value{GDBP}) @@Hello world *stopped,reason="breakpoint-hit",bkptno="2",frame=@{func="foo",args=[], ! file="hello.c",fullname="/home/foo/bar/hello.c",line="13"@} (@value{GDBP}) @end smallexample *************** *** 18931,18937 **** (@value{GDBP}) @@hello from foo *stopped,reason="function-finished",frame=@{func="main",args=[], ! file="hello.c",fullname="/home/foo/bar/devo/myproject/hello.c",line="7"@} (@value{GDBP}) @end smallexample --- 18934,18940 ---- (@value{GDBP}) @@hello from foo *stopped,reason="function-finished",frame=@{func="main",args=[], ! file="hello.c",fullname="/home/foo/bar/hello.c",line="7"@} (@value{GDBP}) @end smallexample *************** *** 18945,18951 **** (@value{GDBP}) *stopped,reason="function-finished",frame=@{addr="0x000107b0",func="foo", args=[@{name="a",value="1"],@{name="b",value="9"@}@}, ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, gdb-result-var="$1",return-value="0" (@value{GDBP}) @end smallexample --- 18948,18954 ---- (@value{GDBP}) *stopped,reason="function-finished",frame=@{addr="0x000107b0",func="foo", args=[@{name="a",value="1"],@{name="b",value="9"@}@}, ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, gdb-result-var="$1",return-value="0" (@value{GDBP}) @end smallexample *************** *** 18983,18989 **** (@value{GDBP}) 111*stopped,signal-name="SIGINT",signal-meaning="Interrupt", frame=@{addr="0x00010140",func="foo",args=[],file="try.c", ! fullname="/home/foo/bar/devo/myproject/try.c",line="13"@} (@value{GDBP}) (@value{GDBP}) --- 18986,18992 ---- (@value{GDBP}) 111*stopped,signal-name="SIGINT",signal-meaning="Interrupt", frame=@{addr="0x00010140",func="foo",args=[],file="try.c", ! fullname="/home/foo/bar/try.c",line="13"@} (@value{GDBP}) (@value{GDBP}) *************** *** 19126,19132 **** (@value{GDBP}) *stopped,reason="breakpoint-hit",bkptno="1", frame=@{func="main",args=[],file="recursive2.c", ! fullname="/home/foo/bar/devo/myproject/recursive2.c",line="4"@} (@value{GDBP}) @end smallexample --- 19129,19135 ---- (@value{GDBP}) *stopped,reason="breakpoint-hit",bkptno="1", frame=@{func="main",args=[],file="recursive2.c", ! fullname="/home/foo/bar/recursive2.c",line="4"@} (@value{GDBP}) @end smallexample *************** *** 19180,19186 **** *stopped,reason="end-stepping-range", frame=@{func="foo",args=[@{name="a",value="10"@}, @{name="b",value="0"@}],file="recursive2.c", ! fullname="/home/foo/bar/devo/myproject/recursive2.c",line="11"@} (@value{GDBP}) @end smallexample --- 19183,19189 ---- *stopped,reason="end-stepping-range", frame=@{func="foo",args=[@{name="a",value="10"@}, @{name="b",value="0"@}],file="recursive2.c", ! fullname="/home/foo/bar/recursive2.c",line="11"@} (@value{GDBP}) @end smallexample *************** *** 19224,19230 **** (@value{GDBP}) *stopped,reason="end-stepping-range", frame=@{func="foo",args=[],file="try.c", ! fullname="/home/foo/bar/devo/myproject/try.c",line="10"@} (@value{GDBP}) -exec-step-instruction ^running --- 19227,19233 ---- (@value{GDBP}) *stopped,reason="end-stepping-range", frame=@{func="foo",args=[],file="try.c", ! fullname="/home/foo/bar/try.c",line="10"@} (@value{GDBP}) -exec-step-instruction ^running *************** *** 19232,19238 **** (@value{GDBP}) *stopped,reason="end-stepping-range", frame=@{addr="0x000100f4",func="foo",args=[],file="try.c", ! fullname="/home/foo/bar/devo/myproject/try.c",line="10"@} (@value{GDBP}) @end smallexample --- 19235,19241 ---- (@value{GDBP}) *stopped,reason="end-stepping-range", frame=@{addr="0x000100f4",func="foo",args=[],file="try.c", ! fullname="/home/foo/bar/try.c",line="10"@} (@value{GDBP}) @end smallexample *************** *** 19264,19270 **** (@value{GDBP}) x = 55 *stopped,reason="location-reached",frame=@{func="main",args=[], ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="6"@} (@value{GDBP}) @end smallexample --- 19267,19273 ---- (@value{GDBP}) x = 55 *stopped,reason="location-reached",frame=@{func="main",args=[], ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="6"@} (@value{GDBP}) @end smallexample *************** *** 19918,19946 **** -stack-list-frames ^done,stack= [frame=@{level="0",addr="0x0001076c",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="11"@}, frame=@{level="1",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="2",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="3",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="4",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="5",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="6",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="7",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="8",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="9",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="10",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="11",addr="0x00010738",func="main", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="4"@}] (@value{GDBP}) @end smallexample --- 19921,19949 ---- -stack-list-frames ^done,stack= [frame=@{level="0",addr="0x0001076c",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="11"@}, frame=@{level="1",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="2",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="3",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="4",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="5",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="6",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="7",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="8",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="9",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="10",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="11",addr="0x00010738",func="main", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="4"@}] (@value{GDBP}) @end smallexample *************** *** 19951,19961 **** -stack-list-frames 3 5 ^done,stack= [frame=@{level="3",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="4",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}, frame=@{level="5",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}] (@value{GDBP}) @end smallexample --- 19954,19964 ---- -stack-list-frames 3 5 ^done,stack= [frame=@{level="3",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="4",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}, frame=@{level="5",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}] (@value{GDBP}) @end smallexample *************** *** 19966,19972 **** -stack-list-frames 3 3 ^done,stack= [frame=@{level="3",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/devo/myproject/recursive2.c",line="14"@}] (@value{GDBP}) @end smallexample --- 19969,19975 ---- -stack-list-frames 3 3 ^done,stack= [frame=@{level="3",addr="0x000107a4",func="foo", ! file="recursive2.c",fullname="/home/foo/bar/recursive2.c",line="14"@}] (@value{GDBP}) @end smallexample