From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 16588 invoked by alias); 23 Dec 2010 20:30:30 -0000 Received: (qmail 16561 invoked by uid 22791); 23 Dec 2010 20:30:27 -0000 X-SWARE-Spam-Status: No, hits=-1.9 required=5.0 tests=AWL,BAYES_00,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mail.codesourcery.com (HELO mail.codesourcery.com) (38.113.113.100) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 23 Dec 2010 20:30:20 +0000 Received: (qmail 489 invoked from network); 23 Dec 2010 20:30:18 -0000 Received: from unknown (HELO orlando.localnet) (pedro@127.0.0.2) by mail.codesourcery.com with ESMTPA; 23 Dec 2010 20:30:18 -0000 From: Pedro Alves To: Eli Zaretskii Subject: Re: [doc] Remote protocol: undocumented return value for 'p' and 'g' Date: Fri, 24 Dec 2010 02:50:00 -0000 User-Agent: KMail/1.13.5 (Linux/2.6.33-29-realtime; KDE/4.4.5; x86_64; ; ) Cc: gdb-patches@sourceware.org References: <201012231913.08466.pedro@codesourcery.com> <83sjxoe0ac.fsf@gnu.org> In-Reply-To: <83sjxoe0ac.fsf@gnu.org> MIME-Version: 1.0 Content-Type: Text/Plain; charset="iso-8859-15" Content-Transfer-Encoding: 7bit Message-Id: <201012232030.15971.pedro@codesourcery.com> X-IsSubscribed: yes 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: 2010-12/txt/msg00446.txt.bz2 On Thursday 23 December 2010 19:50:35, Eli Zaretskii wrote: > > From: Pedro Alves > > Okay to apply? > > Yes, thanks. > > > +literal @samp{x}'s in place of the register data digits, to indicate > > +the corresponding register has not been collected, thus its value is > > "... to indicate that the corresponding register ..." > > > +registers 0 and 2 have not been collected, while registers 1 and 3 > > +have been collected, and have value zero each: > ^^^^^^^^^^^^^^^^^^^^^^^^ > "and both have zero value" > Thanks! Applied, as below. -- Pedro Alves 2010-12-23 Pedro Alves gdb/doc/ * gdb.texinfo (Packets) : Document support for registers that were not collected. --- gdb/doc/gdb.texinfo | 15 +++++++++++++++ 1 file changed, 15 insertions(+) Index: src/gdb/doc/gdb.texinfo =================================================================== --- src.orig/gdb/doc/gdb.texinfo 2010-12-23 20:22:59.000000000 +0000 +++ src/gdb/doc/gdb.texinfo 2010-12-23 20:26:07.000000000 +0000 @@ -31815,6 +31815,21 @@ each register and their position within determined by the @value{GDBN} internal gdbarch functions @code{DEPRECATED_REGISTER_RAW_SIZE} and @code{gdbarch_register_name}. The specification of several standard @samp{g} packets is specified below. + +When reading registers from a trace frame (@pxref{Analyze Collected +Data,,Using the Collected Data}), the stub may also return a string of +literal @samp{x}'s in place of the register data digits, to indicate +that the corresponding register has not been collected, thus its value +is unavailable. For example, for an architecture with 4 registers of +4 bytes each, the following reply indicates to @value{GDBN} that +registers 0 and 2 have not been collected, while registers 1 and 3 +have been collected, and both have zero value: + +@smallexample +-> @code{g} +<- @code{xxxxxxxx00000000xxxxxxxx00000000} +@end smallexample + @item E @var{NN} for an error. @end table