On Thu, Jun 27, 2019 at 12:45:05PM +0200, Peter Krempa wrote:
> On Thu, Jun 27, 2019 at 10:06:02 +0100, Daniel Berrange wrote:
> > The public API entry points will report VIR_ERR_NO_SUPPORT to the
> > caller when a driver does not provide an implementation of a particular
> > method.
> >
> > When deleting methods, leaving the driver API entry point explicitly
> > set to NULL with an version range comment, allows the hvsupport.html
> > page to document when the AP was removed.
> >
> > Signed-off-by: Daniel P. Berrangé <berrange@xxxxxxxxxx>
> > ---
> > docs/hvsupport.pl | 25 +++++++++++++++----------
> > docs/libvirt.css | 2 +-
> > src/qemu/qemu_driver.c | 33 ++-------------------------------
> > 3 files changed, 18 insertions(+), 42 deletions(-)
> >
> > diff --git a/docs/hvsupport.pl b/docs/hvsupport.pl
> > index 2ea245e83a..6023aab222 100755
> > --- a/docs/hvsupport.pl
> > +++ b/docs/hvsupport.pl
>
> [...]
>
> > @@ -351,9 +356,9 @@ print <<EOF;
> > <p>
> > This page documents which <a href="html/">libvirt calls</a> work on
> > which libvirt drivers / hypervisors, and which version the API appeared
> > -in. If a hypervisor driver deprecated the API, the version when it
> > -was removed is also mentioned (highlighted in
> > -<span class="deprecatedhv">dark red</span>).
> > +in. If a hypervisor driver later dropped support for the API, the version
> > +when it was removed is also mentioned (highlighted in
> > +<span class="deletedhv">dark red</span>).
> > </p>
> >
> > EOF
>
> [...]
>
> > diff --git a/docs/libvirt.css b/docs/libvirt.css
> > index 6639b1df64..8309f7a386 100644
> > --- a/docs/libvirt.css
> > +++ b/docs/libvirt.css
> > @@ -588,7 +588,7 @@ td.enumvalue {
> > display: inline;
> > }
> >
> > -.deprecatedhv {
> > +.deletedhv {
>
> I'd prefer "removed" as used in the text paragraph above.
Sure, fine with me.
> > - .connectDomainXMLFromNative = qemuConnectDomainXMLFromNative, /* 0.6.4 (deprecated: 5.5.0) */
> > + .connectDomainXMLFromNative = NULL, /* 0.6.4 - 5.5.0 */
>
>
> /home/pipo/libvirt/src/qemu/qemu_driver.c:245020 Bad prefix 'NULL' for API 'connectDomainXMLFromNative', expecting 'qemu'
> /home/pipo/libvirt/src/qemu/qemu_driver.c:245020 Bad impl name 'NULL' for API 'connectDomainXMLFromNative', expecting 'qemuConnectDomainXMLFromNative'
> /home/pipo/libvirt/src/qemu/qemu_driver.c:245105 Bad prefix 'NULL' for API 'domainQemuAttach', expecting 'qemu'
> /home/pipo/libvirt/src/qemu/qemu_driver.c:245105 Bad impl name 'NULL' for API 'domainQemuAttach', expecting 'qemuDomainQemuAttach'
> make[3]: *** [Makefile:15016: check-driverimpls] Error 1
Opps, will fix.
>
>
> > .connectDomainXMLToNative = qemuConnectDomainXMLToNative, /* 0.6.4 */
> > .connectListDefinedDomains = qemuConnectListDefinedDomains, /* 0.2.0 */
> > .connectNumOfDefinedDomains = qemuConnectNumOfDefinedDomains, /* 0.2.0 */
>
> ACK if you make sure that make check/sytax-check passes.
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 :|
--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list
