[libvirt] [PATCH 1/4] Fix docs for PM event callbacks

Jiri Denemark jdenemar at redhat.com
Thu Sep 6 15:09:10 UTC 2012


PM{Suspend,Wakeup} event callbacks were designed with a reason parameter
which could be used in the future. However, we do not transfer the
reason over RPC and thus we can never use it in the future. Make it
explicit in the docs.
---
 include/libvirt/libvirt.h.in | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/include/libvirt/libvirt.h.in b/include/libvirt/libvirt.h.in
index cfe5047..44c1649 100644
--- a/include/libvirt/libvirt.h.in
+++ b/include/libvirt/libvirt.h.in
@@ -3902,8 +3902,7 @@ typedef void (*virConnectDomainEventTrayChangeCallback)(virConnectPtr conn,
  * virConnectDomainEventPMWakeupCallback:
  * @conn: connection object
  * @dom: domain on which the event occurred
- * @reason: reason why the callback was called, unused currently,
- *          always passes 0
+ * @reason: unused, will always be 0
  * @opaque: application specified data
  *
  * This callback occurs when the guest is waken up.
@@ -3920,8 +3919,7 @@ typedef void (*virConnectDomainEventPMWakeupCallback)(virConnectPtr conn,
  * virConnectDomainEventPMSuspendCallback:
  * @conn: connection object
  * @dom: domain on which the event occurred
- * @reason: reason why the callback was called, unused currently,
- *          always passes 0
+ * @reason: unused, will always be 0
  * @opaque: application specified data
  *
  * This callback occurs when the guest is waken up.
-- 
1.7.12




More information about the libvir-list mailing list