From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 11025 invoked by alias); 16 Sep 2011 20:46:12 -0000 Received: (qmail 10987 invoked by uid 22791); 16 Sep 2011 20:46:11 -0000 X-SWARE-Spam-Status: No, hits=-2.3 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 16 Sep 2011 20:45:49 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 95F282BB4A5; Fri, 16 Sep 2011 16:45:48 -0400 (EDT) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id Bcl1-noibgjS; Fri, 16 Sep 2011 16:45:48 -0400 (EDT) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 6910D2BB306; Fri, 16 Sep 2011 16:45:48 -0400 (EDT) Received: by joel.gnat.com (Postfix, from userid 1000) id 6908A145615; Fri, 16 Sep 2011 16:45:39 -0400 (EDT) From: Joel Brobecker To: gdb-patches@sourceware.org Cc: vladimir@codesourcery.com, Joel Brobecker Subject: [PATCH 3/3] [Ada/doco] Document the new -ada-task-info GDB/MI command. Date: Fri, 16 Sep 2011 20:46:00 -0000 Message-Id: <1316205921-18702-4-git-send-email-brobecker@adacore.com> In-Reply-To: <1316205921-18702-1-git-send-email-brobecker@adacore.com> References: <1316205921-18702-1-git-send-email-brobecker@adacore.com> Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2011-09/txt/msg00327.txt.bz2 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. Tested on x86_64-linux. OK to commit? Thanks, -- Joel --- gdb/doc/gdb.texinfo | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 79 insertions(+), 1 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 051377d..cd35f2b 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -24765,6 +24765,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:: @@ -26641,6 +26642,82 @@ 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. + +@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. + +@item name +The name of the task. + +@end table + +@subsubheading Example + +@smallexample +-thread-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 @@ -30300,7 +30377,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 the presence of the @code{-ada-task-info} command. @end table @subheading The @code{-list-target-features} Command -- 1.7.1