Re: [PATCH v4 05/15] spapr: nested: Document Nested PAPR API

[Harsh Prateek Bora]

On 2/27/24 16:09, Nicholas Piggin wrote:
> On Tue Feb 27, 2024 at 7:31 PM AEST, Harsh Prateek Bora wrote:
> > On 2/27/24 14:59, Nicholas Piggin wrote:
> > > On Tue Feb 20, 2024 at 6:35 PM AEST, Harsh Prateek Bora wrote:
> > > > Adding initial documentation about Nested PAPR API to describe the set
> > > > of APIs and its usage. Also talks about the Guest State Buffer elements
> > > > and it's format which is used between L0/L1 to communicate L2 state.
> > > >
> > > > Signed-off-by: Michael Neuling <mikey@neuling.org>
> > > > Signed-off-by: Harsh Prateek Bora <harshpb@linux.ibm.com>
> > >
> > > v2 is upstream in Linux now, I suppose you could reference that too?
> > Yes, upstream Linux commit is mentioned in the doc at the end.
>
> The API doc commit is mentioned as a reference. I would expect something
> following the comments under the Existing Nested-HV API heading for the
> New PAPR API.
>
> Oh, is it lifted directly from linux.git docs? Sigh, in that case never
> mind, it's better to stick with them. Although could be just a link or
> reference.

Well, initially the documentation was floated across with both
kernel/qemu patches, and now we have the kernel side merged. Although, I
think it would be more appropriate to keep it in Qemu which actually
implements the L0 functionality and the related APIs, however, for now,
let's keep a single source of documentation and we can provide a link
after the brief intro about the two APIs.

regards,
Harsh

> Thanks,
> Nick