From 5d77fe4431a7a81a820dba9930658c36cbeb32a1 Mon Sep 17 00:00:00 2001 From: Joel Brobecker Date: Mon, 3 Oct 2011 21:38:51 +0000 Subject: [PATCH] [Ada/doco] Document the new -ada-task-info GDB/MI command. gdb/doc/ChangeLog: * gdb.texinfo (GDB/MI Ada Tasking Commands): New node. (GDB/MI Miscellaneous Commands): Add `ada-task-info' as possible feature returned by the `-list-features' command. --- gdb/doc/ChangeLog | 7 +++++ gdb/doc/gdb.texinfo | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 87 insertions(+), 1 deletion(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 906c3b2..f863665 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,10 @@ +2011-10-03 Joel Brobecker + + * gdb.texinfo (GDB/MI Ada Tasking Commands): New node. + (GDB/MI Miscellaneous Commands): Add `ada-task-info' + as possible feature returned by the `-list-features' + command. + 2011-09-28 Yao Qi * gdb.texinfo (Files): Update options for `add-symbol-file'. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index ea0cf57..0b7bf4a 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -24782,6 +24782,7 @@ may repeat one or more times. * GDB/MI Breakpoint Commands:: * GDB/MI Program Context:: * GDB/MI Thread Commands:: +* GDB/MI Ada Tasking Commands:: * GDB/MI Program Execution:: * GDB/MI Stack Manipulation:: * GDB/MI Variable Objects:: @@ -26658,6 +26659,83 @@ args=[@{name="format",value="0x8048e9c \"%*s%c %d %c\\n\""@}, @end smallexample @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +@node GDB/MI Ada Tasking Commands +@section @sc{gdb/mi} Ada Tasking Commands + +@subheading The @code{-ada-task-info} Command +@findex -ada-task-info + +@subsubheading Synopsis + +@smallexample + -ada-task-info [ @var{task-id} ] +@end smallexample + +Reports information about either a specific Ada task, if the +@var{task-id} parameter is present, or about all Ada tasks. + +@subsubheading @value{GDBN} Command + +The @samp{info tasks} command prints the same information +about all Ada tasks (@pxref{Ada Tasks}). + +@subsubheading Result + +The result is a table of Ada tasks. The following columns are +defined for each Ada task: + +@table @samp +@item current +This field exists only for the current thread. It has the value @samp{*}. + +@item id +The identifier that @value{GDBN} uses to refer to the Ada task. + +@item task-id +The identifier that the target uses to refer to the Ada task. + +@item thread-id +The identifier of the thread corresponding to the Ada task. + +This field should always exist, as Ada tasks are always implemented +on top of a thread. But if @value{GDBN} cannot find this corresponding +thread for any reason, the field is omitted. + +@item parent-id +This field exists only when the task was created by another task. +In this case, it provides the ID of the parent task. + +@item priority +The base priority of the task. + +@item state +The current state of the task. For a detailed description of the +possible states, see @ref{Ada Tasks}. + +@item name +The name of the task. + +@end table + +@subsubheading Example + +@smallexample +-ada-task-info +^done,tasks=@{nr_rows="3",nr_cols="8", +hdr=[@{width="1",alignment="-1",col_name="current",colhdr=""@}, +@{width="3",alignment="1",col_name="id",colhdr="ID"@}, +@{width="9",alignment="1",col_name="task-id",colhdr="TID"@}, +@{width="4",alignment="1",col_name="thread-id",colhdr=""@}, +@{width="4",alignment="1",col_name="parent-id",colhdr="P-ID"@}, +@{width="3",alignment="1",col_name="priority",colhdr="Pri"@}, +@{width="22",alignment="-1",col_name="state",colhdr="State"@}, +@{width="1",alignment="2",col_name="name",colhdr="Name"@}], +body=[@{current="*",id="1",task-id=" 644010",thread-id="1",priority="48", +state="Child Termination Wait",name="main_task"@}]@} +(gdb) +@end smallexample + +@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @node GDB/MI Program Execution @section @sc{gdb/mi} Program Execution @@ -30317,7 +30395,8 @@ Indicates presense of the @code{-data-read-memory-bytes} and the @item breakpoint-notifications Indicates that changes to breakpoints and breakpoints created via the CLI will be announced via async records. - +@item ada-task-info +Indicates support for the @code{-ada-task-info} command. @end table @subheading The @code{-list-target-features} Command -- 2.7.4