From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29075 invoked by alias); 20 Sep 2006 22:21:11 -0000 Received: (qmail 29066 invoked by uid 22791); 20 Sep 2006 22:21:10 -0000 X-Spam-Check-By: sourceware.org Received: from nevyn.them.org (HELO nevyn.them.org) (66.93.172.17) by sourceware.org (qpsmtpd/0.31.1) with ESMTP; Wed, 20 Sep 2006 22:21:08 +0000 Received: from drow by nevyn.them.org with local (Exim 4.54) id 1GQARG-0007pV-2M for gdb-patches@sourceware.org; Wed, 20 Sep 2006 18:21:06 -0400 Date: Wed, 20 Sep 2006 22:21:00 -0000 From: Daniel Jacobowitz To: gdb-patches@sourceware.org Subject: Re: Flash support part 3: documentation Message-ID: <20060920222106.GA29384@nevyn.them.org> Mail-Followup-To: gdb-patches@sourceware.org References: <200607201343.32483.vladimir@codesourcery.com> <200607211604.02942.vladimir@codesourcery.com> <200607221640.31522.vladimir@codesourcery.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.13 (2006-08-11) X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-09/txt/msg00116.txt.bz2 On Sat, Jul 22, 2006 at 05:05:28PM +0300, Eli Zaretskii wrote: > > Here's yet another revision of the patch. > > This is approved to go in; thanks. Hi Eli, I'll be around to applying these patches shortly, after unanticipated delay. I have two small changes to the documentation; does this look OK (along with Vlad's patch)? The only changes are a minor grammar nit, and a clarification for one thing we found particularly confusing when implementing this spec: that vFlashWrite packets only have an ordering requirement w.r.t. other vFlashWrite packets, but that GDB's behavior of sending all the erase packets before any write packets was intended to be OK. -- Daniel Jacobowitz CodeSourcery Index: src/gdb/doc/gdb.texinfo =================================================================== --- src.orig/gdb/doc/gdb.texinfo 2006-09-20 18:18:50.000000000 -0400 +++ src/gdb/doc/gdb.texinfo 2006-09-20 18:12:14.000000000 -0400 @@ -23181,10 +23181,12 @@ Direct the stub to write data to flash a is passed in binary form using the same encoding as for the @samp{X} packet (@pxref{Binary Data}). The memory ranges specified by @samp{vFlashWrite} packets preceding a @samp{vFlashDone} packet must -not overlap, and must appear in order of increasing addresses. If a -packet writes to an address that was neither erased by a preceding -@samp{vFlashErase} packet nor by some other target-specific method, -the results are unpredictable. +not overlap, and must appear in order of increasing addresses +(although @samp{vFlashErase} packets for higher addresses may already +have been received; the ordering is guaranteed only between +@samp{vFlashWrite} packets). If a packet writes to an address that was +neither erased by a preceding @samp{vFlashErase} packet nor by some other +target-specific method, the results are unpredictable. Reply: @@ -25367,7 +25369,7 @@ host is called: @section Memory map format @cindex memory map format -To be able to write into flash memory, @value{GDBN} needs to obtain +To be able to write into flash memory, @value{GDBN} needs to obtain a memory map from the target. This section describes the format of the memory map.