On Wed, Jan 19, 2022 at 05:22:59PM +0800, Yang Zhong wrote:
> On Wed, Jan 19, 2022 at 09:16:46AM +0000, Daniel P. Berrangé wrote:
> > On Wed, Jan 19, 2022 at 07:00:14AM -0500, Yang Zhong wrote:
> > > The SGX NUMA patches were merged into Qemu 7.0 release, we need
> > > clarify detailed version history information and also change
> > > some related comments, which make SGX related comments clearer.
> > >
> > > Signed-off-by: Yang Zhong <[email protected]>
> > > ---
> > > qapi/machine.json | 4 ++--
> > > qapi/misc-target.json | 14 +++++++++-----
> > > 2 files changed, 11 insertions(+), 7 deletions(-)
> >
> > Reviewed-by: Daniel P. Berrangé <[email protected]>
> >
> > > diff --git a/qapi/machine.json b/qapi/machine.json
> > > index b6a37e17c4..cf47cb63a9 100644
> > > --- a/qapi/machine.json
> > > +++ b/qapi/machine.json
> > > @@ -1207,7 +1207,7 @@
> > > #
> > > # @memdev: memory backend linked with device
> > > #
> > > -# @node: the numa node
> > > +# @node: the numa node (Since: 7.0)
> > > #
> > > # Since: 6.2
> > > ##
> > > @@ -1288,7 +1288,7 @@
> > > #
> > > # @memdev: memory backend linked with device
> > > #
> > > -# @node: the numa node
> > > +# @node: the numa node (Since: 7.0)
> > > #
> > > # Since: 6.2
> > > ##
> > > diff --git a/qapi/misc-target.json b/qapi/misc-target.json
> > > index 1022aa0184..558521bd39 100644
> > > --- a/qapi/misc-target.json
> > > +++ b/qapi/misc-target.json
> > > @@ -344,9 +344,9 @@
> > > #
> > > # @node: the numa node
> > > #
> > > -# @size: the size of epc section
> > > +# @size: the size of EPC section
> > > #
> > > -# Since: 6.2
> > > +# Since: 7.0
> > > ##
> > > { 'struct': 'SGXEPCSection',
> > > 'data': { 'node': 'int',
> > > @@ -365,7 +365,7 @@
> > > #
> > > # @flc: true if FLC is supported
> > > #
> > > -# @sections: The EPC sections info for guest
> > > +# @sections: The EPC sections info for guest(Since: 7.0)
> >
> > Minor point - a space is needed before '('
> >
> > > #
> > > # Since: 6.2
> > > ##
> > > @@ -390,7 +390,9 @@
> > > #
> > > # -> { "execute": "query-sgx" }
> > > # <- { "return": { "sgx": true, "sgx1" : true, "sgx2" : true,
> > > -# "flc": true, "section-size" : 0 } }
> > > +# "flc": true, "sections":
> > > +# [{"node": 0, "size": 67108864},
> > > +# {"node": 1, "size": 29360128}]} }
> > > #
> > > ##
> > > { 'command': 'query-sgx', 'returns': 'SGXInfo', 'if': 'TARGET_I386' }
> > > @@ -408,7 +410,9 @@
> > > #
> > > # -> { "execute": "query-sgx-capabilities" }
> > > # <- { "return": { "sgx": true, "sgx1" : true, "sgx2" : true,
> > > -# "flc": true, "section-size" : 0 } }
> > > +# "flc": true, "section" :
> > > +# [{"node": 0, "size": 67108864},
> > > +# {"node": 1, "size": 29360128}]} }
> >
> > The 'section-size' shouldn't be removed here - we still need the
> > command fixed to bring back the 'section-size' as it should not
> > have been deleted.
> >
> > Adding the 'section' docs is ok though.
>
>
> Thanks Daniel, You mean I need add extra doc like below? 6.2 and 7.0 command
> description for @query-sgx ?
>
> ##
> # @query-sgx:
> #
> # Returns information about SGX
> #
> # Returns: @SGXInfo
> #
> # Since: 6.2
> #
> # Example:
> #
> # -> { "execute": "query-sgx" }
> # <- { "return": { "sgx": true, "sgx1" : true, "sgx2" : true,
> # "flc": true, "section-size" : 0 } }
> #
> # Since: 7.0
> #
> # Example:
> #
> # -> { "execute": "query-sgx" }
> # <- { "return": { "sgx": true, "sgx1" : true, "sgx2" : true,
> # "flc": true, "sections":
> # [{"node": 0, "size": 67108864},
> # {"node": 1, "size": 29360128}]} }
No, I'm saying you need to fix the query-sgx command so that it
still reports 'section-size':
# Example:
#
# -> { "execute": "query-sgx" }
# <- { "return": { "sgx": true, "sgx1" : true, "sgx2" : true,
# "flc": true, "section-size" : 0,
# "sections": [
# {"node": 0, "size": 67108864},
# {"node": 1, "size": 29360128}] } }
Regards,
Daniel
--
|: https://berrange.com -o- https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org -o- https://fstop138.berrange.com :|
|: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|