On Mon, Sep 18, 2023 at 10:34:30AM -0700, Stephen Brennan wrote:
> Daniel P. Berrangé <berra...@redhat.com> writes:
> > #
> > # @DumpGuestMemoryFormat:
> > #
> > # An enumeration of guest-memory-dump's format.
> > #
> > # @elf: elf format
> > #
> > # @kdump-zlib: makedumpfile flattened, kdump-compressed format with
> > zlib-compressed
> > #
> > # @kdump-lzo: makedumpfile flattened, kdump-compressed format with
> > lzo-compressed
> > #
> > # @kdump-snappy: makedumpfile flattened, kdump-compressed format with
> > snappy-compressed
> > #
> > # @kdump-raw-zlib: raw assembled kdump-compressed format with
> > zlib-compressed (since 8.2)
> > #
> > # @kdump-raw-lzo: raw assembled kdump-compressed format with lzo-compressed
> > (since 8.2)
> > #
> > # @kdump-raw-snappy: raw assembled kdump-compressed format with
> > snappy-compressed (since 8.2)
> > #
> > # @win-dmp: Windows full crashdump format, can be used instead of ELF
> > # converting (since 2.13)
> > #
> > # Since: 2.0
> > ##
> > { 'enum': 'DumpGuestMemoryFormat',
> > 'data': [ 'elf',
> > 'kdump-zlib', 'kdump-lzo', 'kdump-snappy',
> > 'kdump-raw-zlib', 'kdump-raw-lzo', 'kdump-raw-snappy',
> > 'win-dmp' ] }
>
> Hi Daniel,
>
> Sure, I'll go ahead and use this approach instead. One question: I see
> that this generates the enumeration DumpGuestMemoryFormat in
> qapi-types-dump.h. I just wanted to double-check if there's any ABI
> considerations for the numbering of this enum? Inserting kdump-raw-* at
> this point would result in 'win-dmp' getting a different numbering, and
> it seems possible that the API/ABI which libvirt uses might depend on
> the enumeration values not changing. E.G. if libvirt is built against
> one version of Qemu and then used with a different one.
The QAPI integer representation of enums is a private internal impl
detail known only to QEMU.
In terms of QMP, the on the wire representation is exclusively string
format, so safe wrt re-ordering for new/old QEMU and new/old libvirt.
In livirt's own public API, if we chose to expose these new formats,
then we have to strictly append after the existing enums constants
in libvirt's header file.
With 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 :|
