Notable changes

 * AlmaLinux 8 / CentOS Stream 8 replaced with 9
 * Fedora 38 dropped, 40 added
 * Ubuntu 20.04 dropped, 24.04 added
 * Debian 11 dropped, 12 added

Signed-off-by: Daniel P. Berrangé <[email protected]>

... so that additional flags can be passed to Domain.migrateToURI.

Fixes #8

Signed-off-by: Takashi Kajinami <[email protected]>

Signed-off-by: Takashi Kajinami <[email protected]>

This exposes virDomainGetCPUStats API so that cpu stats, along with
memory stats, can be obtained.

Signed-off-by: Takashi Kajinami <[email protected]>

Signed-off-by: Takashi Kajinami <[email protected]>

free was missing for the pointer returned in domains by virConnectListAllDomains, so this has been fixed.

cf. https://libvirt.org/html/libvirt-libvirt-domain.html#virConnectListAllDomains

Signed-off-by: Mitsuru Kariya <[email protected]>

Fix a typo in Javadoc. When running autobuild.sh it raised a warning
indicating missing final '>' in @see tag.

Signed-off-by: Francisco Manuel Garcia Botella <[email protected]>

Although virConnCopyLastError and virCopyLastError are provided, using them
requires freeing the string memory area with virResetError.  Therefore, add
virResetError.

Also fix mistakes in the Javadoc "missig api in 0.1.0" list:
- virConnCopyLastError is provided
- virFreeError is not missing in 0.1.0 (it is listed as missing in 0.6.1)

Signed-off-by: Mitsuru Kariya <[email protected]>

Expose virtDomainGetJobStats . This is useful especially when we want
to query jobs actually running.

Co-Authored-By: Mitsuru Kariya <[email protected]>
Signed-off-by: Takashi Kajinami <[email protected]>

Fix the following issues in Domain.getJobStats:
- Fix an exception that occurred when the virTypedParameter[] had zero
  elements.
  virDomainGetJobStats returns successfully with *params == NULL and
  *nparams == 0 when *type == VIR_DOMAIN_JOB_NONE.
  However, calling Structure.toArray(n) with n == 0 causes an
  ArrayIndexOutOfBoundsException.
  This is avoided by directly returning an empty array when *nparams == 0.
- Fix the issue where the first element of virTypedParameter[] was not
  being read.
  The Structure constructor does not automatically read fields.
  This is fixed by explicitly calling the virTypedParameter.read() method
  for the first element.
  Note: Structure.toArray(n) automatically reads fields (i.e., calls the
  virTypedParameter.read() method) for all elements except the first.
- Fix the issue where the value was not being read when virTypedParameter
  was a String.
  Union does not perform pointer-to-value reads (such as char* -> String)
  unless it is the active element.
  This is fixed by explicitly reading the String when
  virTypedParameter.type == VIR_TYPED_STRING.
- Fix a potential crash in virTypedParamsFree when handling String
  parameters.
  When passing a Structure received from a native function as an argument
  to another native function:
    - String fields directly embedded in the Structure are not updated in
      native memory if their values haven't changed.
    - However, Unions embedded in the Structure always update native memory
      for the active element, even if the value hasn't changed.
  Therefore, if the active element of the Union is a String, JNA allocates
  new memory for the string and overwrites the received char* pointer.
  This not only causes the original char* pointer to be leaked, but also
  leads to double-free issues: once by virTypedParamsFree and again by GC
  on the JNA-allocated memory.
  This is avoided by changing the argument type of virTypedParamsFree from
  virTypedParameter[] to Pointer.

Additionally, extract the conversion from a pointer to a virTypedParameter
array to a TypedParameter array into a static method of TypedParameter, as
there are other functions that also receive virTypedParameter arrays.

Signed-off-by: Mitsuru Kariya <[email protected]>

The 5th argument `flags` of `virDomainMigrate3` is `unsigned int`, not
`unsigned long`.  Therefore, the Java binding should use `int` instead of
`NativeLong`.

To maintain backward compatibility, the version taking `NativeLong` as an
argument has been deprecated, and a new version taking `int` has been added.

Although not fully verified, it is likely that no practical issue occurs on
supported platforms because:

- On 32-bit platforms, `long` and `int` are the same size.
- On 64-bit platforms, the 5th argument is passed via a register.

Signed-off-by: Mitsuru Kariya <[email protected]>

Created the bindings to manage the domain checkpoints of a domain.
Added tests to check the functionality of these bindings.

Signed-off-by: Francisco Manuel Garcia Botella <[email protected]>

Added tests to these bindings.

Signed-off-by: Francisco Manuel Garcia Botella <[email protected]>

Removed old OSes:
    - Fedora 39, Fedora 40

Added new OSes:

    - AlmaLinux 10
    - CentOS Stream 10
    - Debian 13
    - Fedora 42, Fedora 43

Signed-off-by: Pavel Hrdina <[email protected]>