From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26251 invoked by alias); 26 May 2016 19:32:05 -0000 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 Received: (qmail 26229 invoked by uid 89); 26 May 2016 19:32:04 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.8 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD,SPF_PASS autolearn=ham version=3.3.2 spammy=responses, difficulty, HX-HELO:eggs.gnu.org, Hx-spam-relays-external:208.118.235.92 X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (208.118.235.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-SHA encrypted) ESMTPS; Thu, 26 May 2016 19:31:54 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b610Z-0006yf-2N for gdb-patches@sourceware.org; Thu, 26 May 2016 15:31:52 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:42814) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b610S-0006wR-AX; Thu, 26 May 2016 15:31:44 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2604 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1b610P-0004Gu-3h; Thu, 26 May 2016 15:31:42 -0400 Date: Thu, 26 May 2016 19:32:00 -0000 Message-Id: <83vb201uqr.fsf@gnu.org> From: Eli Zaretskii To: David Taylor CC: gdb-patches@sourceware.org, dtaylor@emc.com In-reply-to: <22941.1464286237@usendtaylorx2l> (message from David Taylor on Thu, 26 May 2016 14:10:37 -0400) Subject: Re: [PATCH] Document short responses to qXfer:object:read. Reply-to: Eli Zaretskii References: <22941.1464286237@usendtaylorx2l> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-IsSubscribed: yes X-SW-Source: 2016-05/txt/msg00475.txt.bz2 > From: David Taylor > cc: dtaylor@emc.com > Date: Thu, 26 May 2016 14:10:37 -0400 > > +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. Thanks. However, I have difficulty understanding what this text is trying to convey. Problematic words are "permitted" and "short" -- they don't seem to be related to anything around this text, and are not explained by the text itself. I also don't see why EOF is important here, or even related. Could you perhaps explain in your own words what is this about, and what the text lacks without this paragraph? I might then propose a more clear wording. Thanks.