summaryrefslogtreecommitdiff
path: root/include
diff options
context:
space:
mode:
authorDaniel P. Berrangé <berrange@redhat.com>2021-01-22 14:48:49 +0000
committerDaniel P. Berrangé <berrange@redhat.com>2021-02-12 09:19:12 +0000
commitc80911f2de4e8aefe4ba385e4eead64ecf0d666e (patch)
tree5e3615b4c1167fa8175f19835a2e08f93e73536f /include
parent17f001c4512929eb68fa67fc1b3520a214c78fed (diff)
downloadlibvirt-c80911f2de4e8aefe4ba385e4eead64ecf0d666e.tar.gz
src: define virDomainGetMessages API
This API allows fetching a list of informational messages recorded against the domain. This provides a way to give information about tainting of the guest due to undesirable actions/configs, as well as provide details of deprecated features. The output of this API is explicitly targetted at humans, not machines, so it is inappropriate to attempt to pattern match on the strings and take action off them, not least because the messages are marked for translation. Should there be a demand for machine targetted information, this would have to be addressed via a new API, and is not planned at this point in time. Reviewed-by: Michal Privoznik <mprivozn@redhat.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
Diffstat (limited to 'include')
-rw-r--r--include/libvirt/libvirt-domain.h9
1 files changed, 9 insertions, 0 deletions
diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index de2456812c..8011cf9fe1 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -5119,4 +5119,13 @@ int virDomainAuthorizedSSHKeysSet(virDomainPtr domain,
unsigned int nkeys,
unsigned int flags);
+typedef enum {
+ VIR_DOMAIN_MESSAGE_DEPRECATION = (1 << 0),
+ VIR_DOMAIN_MESSAGE_TAINTING = (1 << 1),
+} virDomainMessageType;
+
+int virDomainGetMessages(virDomainPtr domain,
+ char ***msgs,
+ unsigned int flags);
+
#endif /* LIBVIRT_DOMAIN_H */