From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Vrabel Subject: Re: [PATCH 8 of 8 DOCDAY] docs: hypercall: document mmuext_op using Doxygen Date: Wed, 26 Oct 2011 14:43:08 +0100 Message-ID: <4EA80E6C.20403@citrix.com> References: <78d2ade5f1fc301ad60e.1319634167@cosworth.uk.xensource.com> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit Return-path: In-Reply-To: <78d2ade5f1fc301ad60e.1319634167@cosworth.uk.xensource.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xensource.com Errors-To: xen-devel-bounces@lists.xensource.com To: Ian Campbell Cc: xen-devel@lists.xensource.com List-Id: xen-devel@lists.xenproject.org On 26/10/11 14:02, Ian Campbell wrote: > > + * An additional MMU hypercall provides an `extended command' > + * interface. This provides additional functionality beyond the basic > + * table updating commands. This hypercall is used to perform > + * additional MMU operations. These include updating cr3 (or just > + * re-installing it for a TLB flush), requesting various kinds of TLB > + * flush, flushing the cache, installing a new LDT, or pinning & > + * unpinning page-table pages (to ensure their reference count doesn’t > + * drop to zero which would require a revalidation of all entries). Bullet points linked to the docs for the specific op might be more useful here (rather than the long comma-separated list). > +/** \ingroup HYPERVISOR_mmuext_op Consider using the @{ @} markers to put adjacent items into the same group rather than having \ingroup for each item. David