From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:37859) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VW5zQ-0005pX-9K for qemu-devel@nongnu.org; Tue, 15 Oct 2013 10:52:56 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VW5zL-0000bm-Ul for qemu-devel@nongnu.org; Tue, 15 Oct 2013 10:52:52 -0400 Received: from mx1.redhat.com ([209.132.183.28]:55721) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VW5zL-0000bh-NG for qemu-devel@nongnu.org; Tue, 15 Oct 2013 10:52:47 -0400 Message-ID: <525D56B9.2020002@redhat.com> Date: Tue, 15 Oct 2013 08:52:41 -0600 From: Eric Blake MIME-Version: 1.0 References: <1381848154-31602-1-git-send-email-peter.maydell@linaro.org> In-Reply-To: <1381848154-31602-1-git-send-email-peter.maydell@linaro.org> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="4OpN3IfFkrpV7H35w4oV3GqcIcejD64cP" Subject: Re: [Qemu-devel] [PATCH v2] docs/memory.txt: Clarify and expand priority/overlap documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Peter Maydell , qemu-devel@nongnu.org Cc: patches@linaro.org, Anthony Liguori , "Michael S. Tsirkin" This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --4OpN3IfFkrpV7H35w4oV3GqcIcejD64cP Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable On 10/15/2013 08:42 AM, Peter Maydell wrote: > The documentation of how overlapping memory regions behave and how > the priority system works was rather brief, and confusion about > priorities seems to be quite common for developers trying to understand= > how the memory region system works, so expand and clarify it. > This includes a worked example with overlaps, documentation of the > behaviour when an overlapped container has "holes", and mention > that it's valid for a region to have both MMIO callbacks and > subregions (and how this interacts with priorities when it does). >=20 > Signed-off-by: Peter Maydell > --- > Changes v1->v2: various minor improvements as per review comments > from MST and subsequent discussion. >=20 > =20 > +It is valid to add subregions to a region which is not a pure containe= r > +(that is, to an MMIO, RAM or ROM region). This means that the region > +will act like a container, except that any addresses within the contai= ner's > +region which are not claimed by any subregion are handled by the > +container itself (ie by its MMIO callbacks or RAM backing). However s/ie/ie./ > +it is generally possible to achieve the same effect with a pure contai= ner s/container/container,/ > +one of whose subregions is a low priority "background" region covering= > +the whole address range; this is often clearer and is preferred. > +Subregions cannot be added to an alias region. > =20 --=20 Eric Blake eblake redhat com +1-919-301-3266 Libvirt virtualization library http://libvirt.org --4OpN3IfFkrpV7H35w4oV3GqcIcejD64cP Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.15 (GNU/Linux) Comment: Public key at http://people.redhat.com/eblake/eblake.gpg Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBCAAGBQJSXVa6AAoJEKeha0olJ0NqeHoIAJkbX4CXJ4S8UjqPnHuktTFp hLMm1ChNbPYpqD5fmrKwq2BRknGXHHxWZMzXX/ehsYUpoGcr+0343yvJwhwhNcTC DbY6POI46/y0xt3MIhrkMYb+kgSMBKxXm0GDWMX4htKfpaATPTfpAbmmAAYGlSRd Q/cYe+7XnH6M9b3p0wordtI+T/hBfeXXEybcV5H7D776Z7lQgfGcF3PUUIDUaNoJ zjA+clHpYPhcQT/uVj1H3ZINDXWHzPoSUkAY9MXKXpljAfeYktoYbfOuVY51Xtbv qvdIlnY99D5MtE3nZww3pv6sCTzDtN2tEZ1dykyTGKZqNHI9aFRgV9GDF2MAVKs= =noRG -----END PGP SIGNATURE----- --4OpN3IfFkrpV7H35w4oV3GqcIcejD64cP--