From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26664 invoked by alias); 23 Jun 2007 21:40:38 -0000 Received: (qmail 26656 invoked by uid 22791); 23 Jun 2007 21:40:37 -0000 X-Spam-Check-By: sourceware.org Received: from shell4.bayarea.net (HELO shell4.bayarea.net) (209.128.82.1) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 23 Jun 2007 21:40:35 +0000 Received: (qmail 5728 invoked from network); 23 Jun 2007 14:40:32 -0700 Received: from 209-128-106-254.bayarea.net (HELO ?192.168.20.7?) (209.128.106.254) by shell4.bayarea.net with SMTP; 23 Jun 2007 14:40:32 -0700 Message-ID: <467D934C.10909@eagercon.com> Date: Sat, 23 Jun 2007 21:40:00 -0000 From: Michael Eager User-Agent: Thunderbird 1.5.0.9 (X11/20070102) MIME-Version: 1.0 To: Michael Eager , Eli Zaretskii , stanshebs@earthlink.net, gdb@sources.redhat.com Subject: Re: What's an annex? stratum? References: <467D5FEF.7010900@eagercon.com> <467D6D1F.7090507@earthlink.net> <467D6FB8.4080909@eagercon.com> <467D87E6.2000908@eagercon.com> <20070623212355.GA3448@caradoc.them.org> In-Reply-To: <20070623212355.GA3448@caradoc.them.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-IsSubscribed: yes Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org X-SW-Source: 2007-06/txt/msg00223.txt.bz2 Daniel Jacobowitz wrote: > On Sat, Jun 23, 2007 at 01:51:50PM -0700, Michael Eager wrote: >> The doc refers to a non-existent DTD file which is supposed to >> describe the XML target description annex. I assumed it was obsolete. > > You are looking at mismatched source and manual, I assume - you didn't > say what versions you were using. In the HEAD version and snapshots, > gdb/features/gdb-target.dtd does exist and the documentation describes > it. The most accessible copy of the online docs refers to HEAD; I > wonder if we should make the manual for the last release more > prominent instead. I'm looking at the current CVS tree. Perhaps my update failed. I had some network problem earlier today. >> It's not clear whether this is the same annex referenced in target.c. > > Annexes are auxilliary data passed to target_xfer_partial: > /* Request that OPS transfer up to LEN 8-bit bytes of the target's > OBJECT. The OFFSET, for a seekable object, specifies the > starting point. The ANNEX can be used to provide additional > data-specific information to the target. > > For the remote protocol, this usually means qXfer packets, like so: > > `qXfer:OBJECT:read:ANNEX:OFFSET,LENGTH' > Read uninterpreted bytes from the target's special data area > identified by the keyword OBJECT. Request LENGTH bytes starting > at OFFSET bytes into the data. The content and encoding of ANNEX > is specific to the object; it can supply additional details about > what data to access. Thanks. -- Michael Eager eager@eagercon.com 1960 Park Blvd., Palo Alto, CA 94306 650-325-8077