From patchwork Thu May 26 18:10:37 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Taylor X-Patchwork-Id: 12536 Received: (qmail 104809 invoked by alias); 26 May 2016 18:11:07 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 104712 invoked by uid 89); 26 May 2016 18:11:06 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.4 required=5.0 tests=BAYES_20, RP_MATCHES_RCVD, SPF_PASS autolearn=ham version=3.3.2 spammy=9th, dtd, indication, Hx-languages-length:1610 X-HELO: mailuogwdur.emc.com Received: from mailuogwdur.emc.com (HELO mailuogwdur.emc.com) (128.221.224.79) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-GCM-SHA384 encrypted) ESMTPS; Thu, 26 May 2016 18:10:56 +0000 Received: from maildlpprd51.lss.emc.com (maildlpprd51.lss.emc.com [10.106.48.155]) by mailuogwprd51.lss.emc.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.0) with ESMTP id u4QIAssN006359 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO) for ; Thu, 26 May 2016 14:10:54 -0400 X-DKIM: OpenDKIM Filter v2.4.3 mailuogwprd51.lss.emc.com u4QIAssN006359 X-DKIM: OpenDKIM Filter v2.4.3 mailuogwprd51.lss.emc.com u4QIAssN006359 Received: from mailsyshubprd05.lss.emc.com (mailsyshubprd05.lss.emc.com [10.253.24.23]) by maildlpprd51.lss.emc.com (RSA Interceptor) for ; Thu, 26 May 2016 14:10:21 -0400 Received: from usendtaylorx2l (d5170089.lss.emc.com [10.243.146.89]) by mailsyshubprd05.lss.emc.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.0) with ESMTP id u4QIAbBx008647; Thu, 26 May 2016 14:10:37 -0400 Received: by usendtaylorx2l (Postfix, from userid 26043) id 8D4E0260FF3; Thu, 26 May 2016 14:10:37 -0400 (EDT) Received: from usendtaylorx2l (localhost [127.0.0.1]) by usendtaylorx2l (Postfix) with ESMTP id 62D17260FF1; Thu, 26 May 2016 14:10:37 -0400 (EDT) From: David Taylor To: gdb-patches@sourceware.org cc: dtaylor@emc.com Subject: [PATCH] Document short responses to qXfer:object:read. Date: Thu, 26 May 2016 14:10:37 -0400 Message-ID: <22941.1464286237@usendtaylorx2l> X-RSA-Classifications: public X-Sentrion-Hostname: mailuogwprd51.lss.emc.com X-IsSubscribed: yes [We have a copyright assignment on file (in case it matters -- but, this is short enough that I doubt it is is copyrightable).] This is a follow up to my May 9th posting (subject: qXfer:threads:read packets) on the gdb mailing list. This only addresses the short response part, not the dtd vs documentation discrepancy. gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 34b9527..b46075f 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2016-05-26 David Taylor + + * gdb.texinfo (General Query Packets): Document treatment of short + qXfer responses and EOF indication. + 2016-05-23 Tom Tromey * python.texi (Basic Python): Document gdb.breakpoints return. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 8f1ad4e..c674c7a 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -37251,6 +37251,11 @@ starting at @var{offset} bytes into the data. The content and encoding of @var{annex} is specific to @var{object}; it can supply additional details about what data to access. +The target is permitted to return a short response. The response is +considered to cover the range @var{offset} (inclusive) to @var{offset} ++ @var{response length} (exclusive). End of file is indicated by a +zero length response. + Here are the specific requests of this form defined so far. All @samp{qXfer:@var{object}:read:@dots{}} requests use the same reply formats, listed below.