Signed-off-by: Han Han <hhan(a)redhat.com&gt; --- include/libvirt/libvirt-domain.h | 14 +++++++------- include/libvirt/libvirt-secret.h | 2 +- include/libvirt/libvirt-storage.h | 2 +- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h index 0647361952..4da1a63a14 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -3281,7 +3281,7 @@ typedef enum { * @conn: virConnect connection * @dom: The domain on which the event occurred * @event: The specific virDomainEventType which occurred - * @detail: event specific detail information + * @detail: event specific detail information (virDomainEvent*DetailType) * @opaque: opaque user data * * A callback function to be registered, and called when a domain event occurs @@ -3783,7 +3783,7 @@ typedef enum { * virConnectDomainEventWatchdogCallback: * @conn: connection object * @dom: domain on which the event occurred - * @action: action that is to be taken due to watchdog firing + * @action: action that is to be taken due to watchdog firing (virDomainEventWatchdogAction) * @opaque: application specified data * * The callback signature to use when registering for an event of type @@ -3817,7 +3817,7 @@ typedef enum { * @dom: domain on which the event occurred * @srcPath: The host file on which the IO error occurred * @devAlias: The guest device alias associated with the path - * @action: action that is to be taken due to the IO error + * @action: action that is to be taken due to the IO error (virDomainEventIOErrorAction) * @opaque: application specified data * * The callback signature to use when registering for an event of type @@ -3836,7 +3836,7 @@ typedef void (*virConnectDomainEventIOErrorCallback)(virConnectPtr conn, * @dom: domain on which the event occurred * @srcPath: The host file on which the IO error occurred * @devAlias: The guest device alias associated with the path - * @action: action that is to be taken due to the IO error + * @action: action that is to be taken due to the IO error (virDomainEventIOErrorAction) * @reason: the cause of the IO error * @opaque: application specified data * @@ -3940,7 +3940,7 @@ typedef virDomainEventGraphicsSubject *virDomainEventGraphicsSubjectPtr; * virConnectDomainEventGraphicsCallback: * @conn: connection object * @dom: domain on which the event occurred - * @phase: the phase of the connection + * @phase: the phase of the connection (virDomainEventGraphicsPhase) * @local: the local server address * @remote: the remote client address * @authScheme: the authentication scheme activated @@ -4072,7 +4072,7 @@ typedef enum { * @conn: connection object * @dom: domain on which the event occurred * @devAlias: device alias - * @reason: why the tray status was changed? + * @reason: why the tray status was changed? (virDomainEventTrayChangeReason) * @opaque: application specified data * * This callback occurs when the tray of a removable device is moved. @@ -4653,7 +4653,7 @@ typedef void (*virConnectDomainEventBlockThresholdCallback)(virConnectPtr conn, * (virDomainMemoryFailureRecipientType) * @action: the action of hardware memory failure * (virDomainMemoryFailureActionType) - * @flags: the flags of hardware memory failure + * @flags: the flags of hardware memory failure (virDomainMemoryFailureFlags) * @opaque: application specified data * * The callback occurs when the hypervisor handles the hardware memory diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-secret.h index bc1286883c..d24c5e96a2 100644 --- a/include/libvirt/libvirt-secret.h +++ b/include/libvirt/libvirt-secret.h @@ -191,7 +191,7 @@ typedef enum { * @conn: connection object * @secret: secret on which the event occurred * @event: The specific virSecretEventLifecycleType which occurred - * @detail: contains some details on the reason of the event. + * @detail: contains some details on the reason of the event. It will be 0 for the while. * @opaque: application specified data * * This callback is called when a secret lifecycle action is performed, diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h index f8c665a18f..3431cb35e0 100644 --- a/include/libvirt/libvirt-storage.h +++ b/include/libvirt/libvirt-storage.h @@ -489,7 +489,7 @@ typedef enum { * @conn: connection object * @pool: pool on which the event occurred * @event: The specific virStoragePoolEventLifecycleType which occurred - * @detail: contains some details on the reason of the event. + * @detail: contains some details on the reason of the event. It will be 0 for the while. * @opaque: application specified data * * This callback is called when a pool lifecycle action is performed, like start -- 2.34.1