This API is intended to aggregate several guest agent information
queries and is ispired by stats API virDomainListGetStats(). It is
anticipated that this information will be provided by a guest agent
running within the domain.
Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com>
---
include/libvirt/libvirt-domain.h | 14 ++++
src/driver-hypervisor.h | 8 +++
src/libvirt-domain.c | 117 +++++++++++++++++++++++++++++++
src/libvirt_public.syms | 1 +
4 files changed, 140 insertions(+)
diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index f160ee88b5..22277b0a84 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -4902,4 +4902,18 @@ int virDomainGetLaunchSecurityInfo(virDomainPtr domain,
int *nparams,
unsigned int flags);
+typedef enum {
+ VIR_DOMAIN_GUEST_INFO_USERS = (1 << 0), /* return active users */
+ VIR_DOMAIN_GUEST_INFO_OS = (1 << 1), /* return OS information */
+ VIR_DOMAIN_GUEST_INFO_TIMEZONE = (1 << 2), /* return timezone information */
+ VIR_DOMAIN_GUEST_INFO_HOSTNAME = (1 << 3), /* return hostname information */
+ VIR_DOMAIN_GUEST_INFO_FILESYSTEM = (1 << 4), /* return filesystem information */
+} virDomainGuestInfoTypes;
+
+int virDomainGetGuestInfo(virDomainPtr domain,
+ unsigned int types,
+ virTypedParameterPtr *params,
+ int *nparams,
+ unsigned int flags);
+
#endif /* LIBVIRT_DOMAIN_H */
diff --git a/src/driver-hypervisor.h b/src/driver-hypervisor.h
index c1632ae4c6..58eb731e85 100644
--- a/src/driver-hypervisor.h
+++ b/src/driver-hypervisor.h
@@ -1359,6 +1359,13 @@ typedef int
(*virDrvDomainCheckpointDelete)(virDomainCheckpointPtr checkpoint,
unsigned int flags);
+typedef int
+(*virDrvDomainGetGuestInfo)(virDomainPtr domain,
+ unsigned int types,
+ virTypedParameterPtr *params,
+ int *nparams,
+ unsigned int flags);
+
typedef struct _virHypervisorDriver virHypervisorDriver;
typedef virHypervisorDriver *virHypervisorDriverPtr;
@@ -1617,4 +1624,5 @@ struct _virHypervisorDriver {
virDrvDomainCheckpointLookupByName domainCheckpointLookupByName;
virDrvDomainCheckpointGetParent domainCheckpointGetParent;
virDrvDomainCheckpointDelete domainCheckpointDelete;
+ virDrvDomainGetGuestInfo domainGetGuestInfo;
};
diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
index 2fe9bb8e91..ad68db7549 100644
--- a/src/libvirt-domain.c
+++ b/src/libvirt-domain.c
@@ -12212,6 +12212,123 @@ virDomainSetVcpu(virDomainPtr domain,
return -1;
}
+/**
+ * virDomainGetGuestInfo:
+ * @domain: pointer to domain object
+ * @types: types of information to return, binary-OR of virDomainGuestInfoTypes
+ * @params: location to store the guest info parameters
+ * @nparams: number of items in @params
+ * @flags: currently unused, set to 0
+ *
+ * Queries the guest agent for the various information about the guest system.
+ * The reported data depends on the guest agent implementation. the information
+ * is returned as an array of typed parameters containing the individual
+ * parameters. The parameter name for each information field consists of a
+ * dot-separated strign containing the name of the requested group followed by
+ * a group-specific description of the statistic value.
+ *
+ * The information groups are enabled using the @types parameter which is a
+ * binary-OR of enum virDomainGuestInfoTypes. The following groups are available
+ * (although not necessarily implemented for each hypervisor):
+ *
+ * VIR_DOMAIN_GUEST_INFO_USERS:
+ * returns information about users that are currently logged in within the
+ * guest domain. The typed parameter keys are in this format:
+ *
+ * "user.count" - the number of active users on this domain as an
+ * unsigned int
+ * "user.<num>.name - username of the user as a string
+ * "user.<num>.domain - domain of the user as a string (may only be
+ * present on certain guest types)
+ * "user.<num>.login-time - the login time of a user in milliseconds
+ * since the epoch as unsigned long long
+ *
+ * VIR_DOMAIN_GUEST_INFO_OS:
+ * Return information about the operating system running within the guest. The
+ * typed parameter keys are in this format:
+ *
+ * "os.id" - a string identifying the operating system
+ * "os.name" - the name of the operating system, suitable for presentation
+ * to a user, as a string
+ * "os.pretty-name" - a pretty name for the operating system, suitable for
+ * presentation to a user, as a string
+ * "os.version" - the version of the operating system suitable for
+ * presentation to a user, as a string
+ * "os.version-id" - the version id of the operating system suitable for
+ * processing by scripts, as a string
+ * "os.kernel-release" - the release of the operating system kernel, as a
+ * string
+ * "os.kernel-version" - the version of the operating system kernel, as a
+ * string
+ * "os.machine" - the machine hardware name as a string
+ * "os.variant" - a specific variant or edition of the operating system
+ * suitable for presentation to a user, as a string
+ * "os.variant-id" - the id for a specific variant or edition of the
+ * operating system, as a string
+ *
+ * VIR_DOMAIN_GUEST_INFO_TIMEZONE:
+ * Returns information about the timezone within the domain. The typed
+ * parameter keys are in this format:
+ *
+ * "timezone.name" - the name of the timezone as a string
+ * "timezone.offset" - the offset to UTC in seconds as an int
+ *
+ * VIR_DOMAIN_GUEST_INFO_FILESYSTEM:
+ * Returns inforamtion about the filesystems within the domain. The typed
+ * parameter keys are in this format:
+ * "fs.count" - the number of filesystems defined on this domain
+ * as an unsigned int
+ * "fs.<num>.mountpoint" - the path to the mount point for the filesystem
+ * "fs.<num>.name" - device name in the guest (e.g. "sda1")
+ * "fs.<num>.fstype" - the type of filesystem
+ * "fs.<num>.total-bytes" - the total size of the filesystem
+ * "fs.<num>.used-bytes" - the number of bytes used in the filesystem
+ * "fs.<num>.disk.count" - the number of disks targeted by this filesystem
+ * "fs.<num>.disk.<num>.alias" - the device alias of the disk (e.g. sda)
+ * "fs.<num>.disk.<num>.serial" - the serial number of the disk
+ * "fs.<num>.disk.<num>.device" - the device node of the disk
+ *
+ * Using 0 for @types returns all information groups supported by the given
+ * hypervisor.
+ *
+ * This API requires the VM to run. The caller is responsible for calling
+ * virTypedParamsFree to free memory returned in @params.
+ *
+ * Returns 0 on success, -1 on error.
+ */
+int virDomainGetGuestInfo(virDomainPtr domain,
+ unsigned int types,
+ virTypedParameterPtr *params,
+ int *nparams,
+ unsigned int flags)
+{
+ VIR_DOMAIN_DEBUG(domain, "types=%u, params=%p, nparams=%p, flags=0x%x",
+ types, params, nparams, flags);
+
+ virResetLastError();
+
+ virCheckDomainReturn(domain, -1);
+ virCheckReadOnlyGoto(domain->conn->flags, error);
+
+ virCheckNonNullArgGoto(params, error);
+ virCheckNonNullArgGoto(nparams, error);
+
+ if (domain->conn->driver->domainGetGuestInfo) {
+ int ret;
+ ret = domain->conn->driver->domainGetGuestInfo(domain, types,
+ params, nparams, flags);
+
+ if (ret < 0)
+ goto error;
+ return ret;
+ }
+
+ virReportUnsupportedError();
+
+ error:
+ virDispatchError(domain->conn);
+ return -1;
+}
/**
* virDomainSetBlockThreshold:
diff --git a/src/libvirt_public.syms b/src/libvirt_public.syms
index 54256b6317..e196fd11d9 100644
--- a/src/libvirt_public.syms
+++ b/src/libvirt_public.syms
@@ -850,6 +850,7 @@ LIBVIRT_5.6.0 {
virDomainCheckpointLookupByName;
virDomainCheckpointRef;
virDomainListAllCheckpoints;
+ virDomainGetGuestInfo;
} LIBVIRT_5.5.0;
# .... define new API here using predicted next version number ....
--
2.21.0
--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
On 8/23/19 6:31 PM, Jonathon Jongsma wrote:
> This API is intended to aggregate several guest agent information
> queries and is ispired by stats API virDomainListGetStats(). It is
> anticipated that this information will be provided by a guest agent
> running within the domain.
>
> Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com>
> ---
> include/libvirt/libvirt-domain.h | 14 ++++
> src/driver-hypervisor.h | 8 +++
> src/libvirt-domain.c | 117 +++++++++++++++++++++++++++++++
> src/libvirt_public.syms | 1 +
> 4 files changed, 140 insertions(+)
> diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
> index 2fe9bb8e91..ad68db7549 100644
> --- a/src/libvirt-domain.c
> +++ b/src/libvirt-domain.c
> +int virDomainGetGuestInfo(virDomainPtr domain,
> + unsigned int types,
> + virTypedParameterPtr *params,
> + int *nparams,
> + unsigned int flags)
> +{
> + VIR_DOMAIN_DEBUG(domain, "types=%u, params=%p, nparams=%p, flags=0x%x",
> + types, params, nparams, flags);
I think that @types should also be written in hex format since it's a
bitwise-OR of integer values.
> +
> + virResetLastError();
> +
> + virCheckDomainReturn(domain, -1);
> + virCheckReadOnlyGoto(domain->conn->flags, error);
> +
> + virCheckNonNullArgGoto(params, error);
> + virCheckNonNullArgGoto(nparams, error);
> +
> + if (domain->conn->driver->domainGetGuestInfo) {
> + int ret;
> + ret = domain->conn->driver->domainGetGuestInfo(domain, types,
> + params, nparams, flags);
> +
> + if (ret < 0)
> + goto error;
> + return ret;
> + }
> +
> + virReportUnsupportedError();
> +
> + error:
> + virDispatchError(domain->conn);
> + return -1;
> +}
>
> /**
> * virDomainSetBlockThreshold:
> diff --git a/src/libvirt_public.syms b/src/libvirt_public.syms
> index 54256b6317..e196fd11d9 100644
> --- a/src/libvirt_public.syms
> +++ b/src/libvirt_public.syms
> @@ -850,6 +850,7 @@ LIBVIRT_5.6.0 {
> virDomainCheckpointLookupByName;
> virDomainCheckpointRef;
> virDomainListAllCheckpoints;
> + virDomainGetGuestInfo;
> } LIBVIRT_5.5.0;
Unfortunatelly, 5.6.0 is gone. This needs to be a new section of name
LIBVIRT_5.7.0.
Michal
--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
On Fri, Aug 23, 2019 at 11:31:15AM -0500, Jonathon Jongsma wrote: > This API is intended to aggregate several guest agent information > queries and is ispired by stats API virDomainListGetStats(). It is > anticipated that this information will be provided by a guest agent > running within the domain. > > Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com> > --- > include/libvirt/libvirt-domain.h | 14 ++++ > src/driver-hypervisor.h | 8 +++ > src/libvirt-domain.c | 117 +++++++++++++++++++++++++++++++ > src/libvirt_public.syms | 1 + > 4 files changed, 140 insertions(+) > + * VIR_DOMAIN_GUEST_INFO_FILESYSTEM: > + * Returns inforamtion about the filesystems within the domain. The typed > + * parameter keys are in this format: > + * "fs.count" - the number of filesystems defined on this domain > + * as an unsigned int > + * "fs.<num>.mountpoint" - the path to the mount point for the filesystem > + * "fs.<num>.name" - device name in the guest (e.g. "sda1") > + * "fs.<num>.fstype" - the type of filesystem > + * "fs.<num>.total-bytes" - the total size of the filesystem > + * "fs.<num>.used-bytes" - the number of bytes used in the filesystem These two don't mention what data type is used - presuambly it should be unsigned long long > + * "fs.<num>.disk.count" - the number of disks targeted by this filesystem > + * "fs.<num>.disk.<num>.alias" - the device alias of the disk (e.g. sda) > + * "fs.<num>.disk.<num>.serial" - the serial number of the disk > + * "fs.<num>.disk.<num>.device" - the device node of the disk 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@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
On Fri, Aug 23, 2019 at 11:31:15AM -0500, Jonathon Jongsma wrote: > This API is intended to aggregate several guest agent information > queries and is ispired by stats API virDomainListGetStats(). It is > anticipated that this information will be provided by a guest agent > running within the domain. > > Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com> > --- > include/libvirt/libvirt-domain.h | 14 ++++ > src/driver-hypervisor.h | 8 +++ > src/libvirt-domain.c | 117 +++++++++++++++++++++++++++++++ > src/libvirt_public.syms | 1 + > 4 files changed, 140 insertions(+) > > +/** > + * virDomainGetGuestInfo: > + * @domain: pointer to domain object > + * @types: types of information to return, binary-OR of virDomainGuestInfoTypes > + * @params: location to store the guest info parameters > + * @nparams: number of items in @params > + * @flags: currently unused, set to 0 > + * > + * Queries the guest agent for the various information about the guest system. > + * The reported data depends on the guest agent implementation. the information > + * is returned as an array of typed parameters containing the individual > + * parameters. The parameter name for each information field consists of a > + * dot-separated strign containing the name of the requested group followed by > + * a group-specific description of the statistic value. > + * > + * The information groups are enabled using the @types parameter which is a > + * binary-OR of enum virDomainGuestInfoTypes. The following groups are available > + * (although not necessarily implemented for each hypervisor): > + * > + * VIR_DOMAIN_GUEST_INFO_USERS: > + * returns information about users that are currently logged in within the > + * guest domain. The typed parameter keys are in this format: > + * > + * "user.count" - the number of active users on this domain as an > + * unsigned int > + * "user.<num>.name - username of the user as a string > + * "user.<num>.domain - domain of the user as a string (may only be > + * present on certain guest types) > + * "user.<num>.login-time - the login time of a user in milliseconds > + * since the epoch as unsigned long long > + * > + * VIR_DOMAIN_GUEST_INFO_OS: > + * Return information about the operating system running within the guest. The > + * typed parameter keys are in this format: > + * > + * "os.id" - a string identifying the operating system > + * "os.name" - the name of the operating system, suitable for presentation > + * to a user, as a string > + * "os.pretty-name" - a pretty name for the operating system, suitable for > + * presentation to a user, as a string > + * "os.version" - the version of the operating system suitable for > + * presentation to a user, as a string > + * "os.version-id" - the version id of the operating system suitable for > + * processing by scripts, as a string > + * "os.kernel-release" - the release of the operating system kernel, as a > + * string > + * "os.kernel-version" - the version of the operating system kernel, as a > + * string > + * "os.machine" - the machine hardware name as a string > + * "os.variant" - a specific variant or edition of the operating system > + * suitable for presentation to a user, as a string > + * "os.variant-id" - the id for a specific variant or edition of the > + * operating system, as a string > + * > + * VIR_DOMAIN_GUEST_INFO_TIMEZONE: > + * Returns information about the timezone within the domain. The typed > + * parameter keys are in this format: > + * > + * "timezone.name" - the name of the timezone as a string > + * "timezone.offset" - the offset to UTC in seconds as an int > + * > + * VIR_DOMAIN_GUEST_INFO_FILESYSTEM: > + * Returns inforamtion about the filesystems within the domain. The typed > + * parameter keys are in this format: > + * "fs.count" - the number of filesystems defined on this domain > + * as an unsigned int > + * "fs.<num>.mountpoint" - the path to the mount point for the filesystem > + * "fs.<num>.name" - device name in the guest (e.g. "sda1") > + * "fs.<num>.fstype" - the type of filesystem > + * "fs.<num>.total-bytes" - the total size of the filesystem > + * "fs.<num>.used-bytes" - the number of bytes used in the filesystem > + * "fs.<num>.disk.count" - the number of disks targeted by this filesystem > + * "fs.<num>.disk.<num>.alias" - the device alias of the disk (e.g. sda) > + * "fs.<num>.disk.<num>.serial" - the serial number of the disk > + * "fs.<num>.disk.<num>.device" - the device node of the disk This hasn't documented VIR_DOMAIN_GUEST_INFO_HOSTNAME at all 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@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
On Wed, 2019-08-28 at 16:37 +0100, Daniel P. Berrangé wrote: > On Fri, Aug 23, 2019 at 11:31:15AM -0500, Jonathon Jongsma wrote: > > This API is intended to aggregate several guest agent information > > queries and is ispired by stats API virDomainListGetStats(). It is > > anticipated that this information will be provided by a guest agent > > running within the domain. > > > > Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com> > > --- > > include/libvirt/libvirt-domain.h | 14 ++++ > > src/driver-hypervisor.h | 8 +++ > > src/libvirt-domain.c | 117 > > +++++++++++++++++++++++++++++++ > > src/libvirt_public.syms | 1 + > > 4 files changed, 140 insertions(+) > > > > +/** > > + * virDomainGetGuestInfo: > > + * @domain: pointer to domain object > > + * @types: types of information to return, binary-OR of > > virDomainGuestInfoTypes > > + * @params: location to store the guest info parameters > > + * @nparams: number of items in @params > > + * @flags: currently unused, set to 0 > > + * > > + * Queries the guest agent for the various information about the > > guest system. > > + * The reported data depends on the guest agent implementation. > > the information > > + * is returned as an array of typed parameters containing the > > individual > > + * parameters. The parameter name for each information field > > consists of a > > + * dot-separated strign containing the name of the requested group > > followed by > > + * a group-specific description of the statistic value. > > + * > > + * The information groups are enabled using the @types parameter > > which is a > > + * binary-OR of enum virDomainGuestInfoTypes. The following groups > > are available > > + * (although not necessarily implemented for each hypervisor): > > + * > > + * VIR_DOMAIN_GUEST_INFO_USERS: > > + * returns information about users that are currently logged in > > within the > > + * guest domain. The typed parameter keys are in this format: > > + * > > + * "user.count" - the number of active users on this domain > > as an > > + * unsigned int > > + * "user.<num>.name - username of the user as a string > > + * "user.<num>.domain - domain of the user as a string (may > > only be > > + * present on certain guest types) > > + * "user.<num>.login-time - the login time of a user in > > milliseconds > > + * since the epoch as unsigned long > > long > > + * > > + * VIR_DOMAIN_GUEST_INFO_OS: > > + * Return information about the operating system running within > > the guest. The > > + * typed parameter keys are in this format: > > + * > > + * "os.id" - a string identifying the operating system > > + * "os.name" - the name of the operating system, suitable for > > presentation > > + * to a user, as a string > > + * "os.pretty-name" - a pretty name for the operating system, > > suitable for > > + * presentation to a user, as a string > > + * "os.version" - the version of the operating system > > suitable for > > + * presentation to a user, as a string > > + * "os.version-id" - the version id of the operating system > > suitable for > > + * processing by scripts, as a string > > + * "os.kernel-release" - the release of the operating system > > kernel, as a > > + * string > > + * "os.kernel-version" - the version of the operating system > > kernel, as a > > + * string > > + * "os.machine" - the machine hardware name as a string > > + * "os.variant" - a specific variant or edition of the > > operating system > > + * suitable for presentation to a user, as a > > string > > + * "os.variant-id" - the id for a specific variant or edition > > of the > > + * operating system, as a string > > + * > > + * VIR_DOMAIN_GUEST_INFO_TIMEZONE: > > + * Returns information about the timezone within the domain. The > > typed > > + * parameter keys are in this format: > > + * > > + * "timezone.name" - the name of the timezone as a string > > + * "timezone.offset" - the offset to UTC in seconds as an int > > + * > > + * VIR_DOMAIN_GUEST_INFO_FILESYSTEM: > > + * Returns inforamtion about the filesystems within the > > domain. The typed > > + * parameter keys are in this format: > > + * "fs.count" - the number of filesystems defined on this > > domain > > + * as an unsigned int > > + * "fs.<num>.mountpoint" - the path to the mount point for > > the filesystem > > + * "fs.<num>.name" - device name in the guest (e.g. "sda1") > > + * "fs.<num>.fstype" - the type of filesystem > > + * "fs.<num>.total-bytes" - the total size of the filesystem > > + * "fs.<num>.used-bytes" - the number of bytes used in the > > filesystem > > + * "fs.<num>.disk.count" - the number of disks targeted by > > this filesystem > > + * "fs.<num>.disk.<num>.alias" - the device alias of the disk > > (e.g. sda) > > + * "fs.<num>.disk.<num>.serial" - the serial number of the > > disk > > + * "fs.<num>.disk.<num>.device" - the device node of the disk > > This hasn't documented VIR_DOMAIN_GUEST_INFO_HOSTNAME at all Unfortunately Michal merged the patch before this was caught, but I did send out a follow-up yesterday after I noticed it. Jonathon -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
Flagged a couple of typos that can be fixed by the maintainer when
pushing upstream or by in a later version, if a new version is needed.
Aside for the typos, LGTM:
Reviewed-by: Daniel Henrique Barboza <danielhb413@gmail.com>
Tested-by: Daniel Henrique Barboza <danielhb413@gmail.com>
On 8/23/19 1:31 PM, Jonathon Jongsma wrote:
> This API is intended to aggregate several guest agent information
> queries and is ispired by stats API virDomainListGetStats(). It is
s/ispired/inspired
> anticipated that this information will be provided by a guest agent
> running within the domain.
>
> Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com>
> ---
> include/libvirt/libvirt-domain.h | 14 ++++
> src/driver-hypervisor.h | 8 +++
> src/libvirt-domain.c | 117 +++++++++++++++++++++++++++++++
> src/libvirt_public.syms | 1 +
> 4 files changed, 140 insertions(+)
>
> diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
> index f160ee88b5..22277b0a84 100644
> --- a/include/libvirt/libvirt-domain.h
> +++ b/include/libvirt/libvirt-domain.h
> @@ -4902,4 +4902,18 @@ int virDomainGetLaunchSecurityInfo(virDomainPtr domain,
> int *nparams,
> unsigned int flags);
>
> +typedef enum {
> + VIR_DOMAIN_GUEST_INFO_USERS = (1 << 0), /* return active users */
> + VIR_DOMAIN_GUEST_INFO_OS = (1 << 1), /* return OS information */
> + VIR_DOMAIN_GUEST_INFO_TIMEZONE = (1 << 2), /* return timezone information */
> + VIR_DOMAIN_GUEST_INFO_HOSTNAME = (1 << 3), /* return hostname information */
> + VIR_DOMAIN_GUEST_INFO_FILESYSTEM = (1 << 4), /* return filesystem information */
> +} virDomainGuestInfoTypes;
> +
> +int virDomainGetGuestInfo(virDomainPtr domain,
> + unsigned int types,
> + virTypedParameterPtr *params,
> + int *nparams,
> + unsigned int flags);
> +
> #endif /* LIBVIRT_DOMAIN_H */
> diff --git a/src/driver-hypervisor.h b/src/driver-hypervisor.h
> index c1632ae4c6..58eb731e85 100644
> --- a/src/driver-hypervisor.h
> +++ b/src/driver-hypervisor.h
> @@ -1359,6 +1359,13 @@ typedef int
> (*virDrvDomainCheckpointDelete)(virDomainCheckpointPtr checkpoint,
> unsigned int flags);
>
> +typedef int
> +(*virDrvDomainGetGuestInfo)(virDomainPtr domain,
> + unsigned int types,
> + virTypedParameterPtr *params,
> + int *nparams,
> + unsigned int flags);
> +
> typedef struct _virHypervisorDriver virHypervisorDriver;
> typedef virHypervisorDriver *virHypervisorDriverPtr;
>
> @@ -1617,4 +1624,5 @@ struct _virHypervisorDriver {
> virDrvDomainCheckpointLookupByName domainCheckpointLookupByName;
> virDrvDomainCheckpointGetParent domainCheckpointGetParent;
> virDrvDomainCheckpointDelete domainCheckpointDelete;
> + virDrvDomainGetGuestInfo domainGetGuestInfo;
> };
> diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
> index 2fe9bb8e91..ad68db7549 100644
> --- a/src/libvirt-domain.c
> +++ b/src/libvirt-domain.c
> @@ -12212,6 +12212,123 @@ virDomainSetVcpu(virDomainPtr domain,
> return -1;
> }
>
> +/**
> + * virDomainGetGuestInfo:
> + * @domain: pointer to domain object
> + * @types: types of information to return, binary-OR of virDomainGuestInfoTypes
> + * @params: location to store the guest info parameters
> + * @nparams: number of items in @params
> + * @flags: currently unused, set to 0
> + *
> + * Queries the guest agent for the various information about the guest system.
> + * The reported data depends on the guest agent implementation. the information
Capital "T" after the period. ". The information ..."
> + * is returned as an array of typed parameters containing the individual
> + * parameters. The parameter name for each information field consists of a
> + * dot-separated strign containing the name of the requested group followed by
s/strign/string
> + * a group-specific description of the statistic value.
> + *
> + * The information groups are enabled using the @types parameter which is a
> + * binary-OR of enum virDomainGuestInfoTypes. The following groups are available
> + * (although not necessarily implemented for each hypervisor):
> + *
> + * VIR_DOMAIN_GUEST_INFO_USERS:
> + * returns information about users that are currently logged in within the
> + * guest domain. The typed parameter keys are in this format:
> + *
> + * "user.count" - the number of active users on this domain as an
> + * unsigned int
> + * "user.<num>.name - username of the user as a string
> + * "user.<num>.domain - domain of the user as a string (may only be
> + * present on certain guest types)
> + * "user.<num>.login-time - the login time of a user in milliseconds
> + * since the epoch as unsigned long long
> + *
> + * VIR_DOMAIN_GUEST_INFO_OS:
> + * Return information about the operating system running within the guest. The
> + * typed parameter keys are in this format:
> + *
> + * "os.id" - a string identifying the operating system
> + * "os.name" - the name of the operating system, suitable for presentation
> + * to a user, as a string
> + * "os.pretty-name" - a pretty name for the operating system, suitable for
> + * presentation to a user, as a string
> + * "os.version" - the version of the operating system suitable for
> + * presentation to a user, as a string
> + * "os.version-id" - the version id of the operating system suitable for
> + * processing by scripts, as a string
> + * "os.kernel-release" - the release of the operating system kernel, as a
> + * string
> + * "os.kernel-version" - the version of the operating system kernel, as a
> + * string
> + * "os.machine" - the machine hardware name as a string
> + * "os.variant" - a specific variant or edition of the operating system
> + * suitable for presentation to a user, as a string
> + * "os.variant-id" - the id for a specific variant or edition of the
> + * operating system, as a string
> + *
> + * VIR_DOMAIN_GUEST_INFO_TIMEZONE:
> + * Returns information about the timezone within the domain. The typed
> + * parameter keys are in this format:
> + *
> + * "timezone.name" - the name of the timezone as a string
> + * "timezone.offset" - the offset to UTC in seconds as an int
> + *
> + * VIR_DOMAIN_GUEST_INFO_FILESYSTEM:
> + * Returns inforamtion about the filesystems within the domain. The typed
s/inforamtion/information
> + * parameter keys are in this format:
> + * "fs.count" - the number of filesystems defined on this domain
> + * as an unsigned int
> + * "fs.<num>.mountpoint" - the path to the mount point for the filesystem
> + * "fs.<num>.name" - device name in the guest (e.g. "sda1")
> + * "fs.<num>.fstype" - the type of filesystem
> + * "fs.<num>.total-bytes" - the total size of the filesystem
> + * "fs.<num>.used-bytes" - the number of bytes used in the filesystem
> + * "fs.<num>.disk.count" - the number of disks targeted by this filesystem
> + * "fs.<num>.disk.<num>.alias" - the device alias of the disk (e.g. sda)
> + * "fs.<num>.disk.<num>.serial" - the serial number of the disk
> + * "fs.<num>.disk.<num>.device" - the device node of the disk
> + *
> + * Using 0 for @types returns all information groups supported by the given
> + * hypervisor.
> + *
> + * This API requires the VM to run. The caller is responsible for calling
> + * virTypedParamsFree to free memory returned in @params.
> + *
> + * Returns 0 on success, -1 on error.
> + */
> +int virDomainGetGuestInfo(virDomainPtr domain,
> + unsigned int types,
> + virTypedParameterPtr *params,
> + int *nparams,
> + unsigned int flags)
> +{
> + VIR_DOMAIN_DEBUG(domain, "types=%u, params=%p, nparams=%p, flags=0x%x",
> + types, params, nparams, flags);
> +
> + virResetLastError();
> +
> + virCheckDomainReturn(domain, -1);
> + virCheckReadOnlyGoto(domain->conn->flags, error);
> +
> + virCheckNonNullArgGoto(params, error);
> + virCheckNonNullArgGoto(nparams, error);
> +
> + if (domain->conn->driver->domainGetGuestInfo) {
> + int ret;
> + ret = domain->conn->driver->domainGetGuestInfo(domain, types,
> + params, nparams, flags);
> +
> + if (ret < 0)
> + goto error;
> + return ret;
> + }
> +
> + virReportUnsupportedError();
> +
> + error:
> + virDispatchError(domain->conn);
> + return -1;
> +}
>
> /**
> * virDomainSetBlockThreshold:
> diff --git a/src/libvirt_public.syms b/src/libvirt_public.syms
> index 54256b6317..e196fd11d9 100644
> --- a/src/libvirt_public.syms
> +++ b/src/libvirt_public.syms
> @@ -850,6 +850,7 @@ LIBVIRT_5.6.0 {
> virDomainCheckpointLookupByName;
> virDomainCheckpointRef;
> virDomainListAllCheckpoints;
> + virDomainGetGuestInfo;
> } LIBVIRT_5.5.0;
>
> # .... define new API here using predicted next version number ....
--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list
© 2016 - 2024 Red Hat, Inc.