}
+static int
+remoteRelayDomainEventJobCompleted(virConnectPtr conn,
+ virDomainPtr dom,
+ virTypedParameterPtr params,
+ int nparams,
+ void *opaque)
+{
+ daemonClientEventCallbackPtr callback = opaque;
+ remote_domain_event_callback_job_completed_msg data;
+
+ if (callback->callbackID < 0 ||
+ !remoteRelayDomainEventCheckACL(callback->client, conn, dom))
+ return -1;
+
+ VIR_DEBUG("Relaying domain migration completed event %s %d, "
+ "callback %d, params %p %d",
+ dom->name, dom->id, callback->callbackID, params, nparams);
+
+ /* build return data */
+ memset(&data, 0, sizeof(data));
+ data.callbackID = callback->callbackID;
+ make_nonnull_domain(&data.dom, dom);
+
+ if (virTypedParamsSerialize(params, nparams,
+ (virTypedParameterRemotePtr *) &data.params.params_val,
+ &data.params.params_len,
+ VIR_TYPED_PARAM_STRING_OKAY) < 0)
+ return -1;
+
+ remoteDispatchObjectEventSend(callback->client, remoteProgram,
+ REMOTE_PROC_DOMAIN_EVENT_CALLBACK_JOB_COMPLETED,
+ (xdrproc_t)xdr_remote_domain_event_callback_job_completed_msg,
+ &data);
+ return 0;
+}
+
+
static virConnectDomainEventGenericCallback domainEventCallbacks[] = {
VIR_DOMAIN_EVENT_CALLBACK(remoteRelayDomainEventLifecycle),
VIR_DOMAIN_EVENT_CALLBACK(remoteRelayDomainEventReboot),
VIR_DOMAIN_EVENT_CALLBACK(remoteRelayDomainEventAgentLifecycle),
VIR_DOMAIN_EVENT_CALLBACK(remoteRelayDomainEventDeviceAdded),
VIR_DOMAIN_EVENT_CALLBACK(remoteRelayDomainEventMigrationIteration),
+ VIR_DOMAIN_EVENT_CALLBACK(remoteRelayDomainEventJobCompleted),
};
verify(ARRAY_CARDINALITY(domainEventCallbacks) == VIR_DOMAIN_EVENT_ID_LAST);
int iteration,
void *opaque);
+/**
+ * virConnectDomainEventJobCompletedCallback:
+ * @conn: connection object
+ * @dom: domain on which the event occurred
+ * @params: job statistics stored as an array of virTypedParameter
+ * @nparams: size of the params array
+ * @opaque: application specific data
+ *
+ * This callback occurs when a job (such as migration) running on the domain
+ * is completed. The params array will contain statistics of the just completed
+ * job as virDomainGetJobStats would return. The callback must not free @params
+ * (the array will be freed once the callback finishes).
+ *
+ * The callback signature to use when registering for an event of type
+ * VIR_DOMAIN_EVENT_ID_JOB_COMPLETED with
+ * virConnectDomainEventRegisterAny().
+ */
+typedef void (*virConnectDomainEventJobCompletedCallback)(virConnectPtr conn,
+ virDomainPtr dom,
+ virTypedParameterPtr params,
+ int nparams,
+ void *opaque);
+
/**
* VIR_DOMAIN_TUNABLE_CPU_VCPUPIN:
*
VIR_DOMAIN_EVENT_ID_AGENT_LIFECYCLE = 18,/* virConnectDomainEventAgentLifecycleCallback */
VIR_DOMAIN_EVENT_ID_DEVICE_ADDED = 19, /* virConnectDomainEventDeviceAddedCallback */
VIR_DOMAIN_EVENT_ID_MIGRATION_ITERATION = 20, /* virConnectDomainEventMigrationIterationCallback */
+ VIR_DOMAIN_EVENT_ID_JOB_COMPLETED = 21, /* virConnectDomainEventJobCompletedCallback */
# ifdef VIR_ENUM_SENTINELS
VIR_DOMAIN_EVENT_ID_LAST
static virClassPtr virDomainEventAgentLifecycleClass;
static virClassPtr virDomainEventDeviceAddedClass;
static virClassPtr virDomainEventMigrationIterationClass;
-
+static virClassPtr virDomainEventJobCompletedClass;
static void virDomainEventDispose(void *obj);
static void virDomainEventLifecycleDispose(void *obj);
static void virDomainEventAgentLifecycleDispose(void *obj);
static void virDomainEventDeviceAddedDispose(void *obj);
static void virDomainEventMigrationIterationDispose(void *obj);
+static void virDomainEventJobCompletedDispose(void *obj);
static void
virDomainEventDispatchDefaultFunc(virConnectPtr conn,
typedef struct _virDomainEventMigrationIteration virDomainEventMigrationIteration;
typedef virDomainEventMigrationIteration *virDomainEventMigrationIterationPtr;
+struct _virDomainEventJobCompleted {
+ virDomainEvent parent;
+
+ virTypedParameterPtr params;
+ int nparams;
+};
+typedef struct _virDomainEventJobCompleted virDomainEventJobCompleted;
+typedef virDomainEventJobCompleted *virDomainEventJobCompletedPtr;
static int
virDomainEventsOnceInit(void)
sizeof(virDomainEventMigrationIteration),
virDomainEventMigrationIterationDispose)))
return -1;
+ if (!(virDomainEventJobCompletedClass =
+ virClassNew(virDomainEventClass,
+ "virDomainEventJobCompleted",
+ sizeof(virDomainEventJobCompleted),
+ virDomainEventJobCompletedDispose)))
+ return -1;
return 0;
}
VIR_DEBUG("obj=%p", event);
};
+static void
+virDomainEventJobCompletedDispose(void *obj)
+{
+ virDomainEventJobCompletedPtr event = obj;
+ VIR_DEBUG("obj=%p", event);
+
+ virTypedParamsFree(event->params, event->nparams);
+}
+
static void *
virDomainEventNew(virClassPtr klass,
iteration);
}
+/* This function consumes @params, the caller must not free it.
+ */
+static virObjectEventPtr
+virDomainEventJobCompletedNew(int id,
+ const char *name,
+ const unsigned char *uuid,
+ virTypedParameterPtr params,
+ int nparams)
+{
+ virDomainEventJobCompletedPtr ev;
+
+ if (virDomainEventsInitialize() < 0)
+ goto error;
+
+ if (!(ev = virDomainEventNew(virDomainEventJobCompletedClass,
+ VIR_DOMAIN_EVENT_ID_JOB_COMPLETED,
+ id, name, uuid)))
+ goto error;
+
+ ev->params = params;
+ ev->nparams = nparams;
+
+ return (virObjectEventPtr) ev;
+
+ error:
+ virTypedParamsFree(params, nparams);
+ return NULL;
+}
+
+virObjectEventPtr
+virDomainEventJobCompletedNewFromObj(virDomainObjPtr obj,
+ virTypedParameterPtr params,
+ int nparams)
+{
+ return virDomainEventJobCompletedNew(obj->def->id, obj->def->name,
+ obj->def->uuid, params, nparams);
+}
+
+virObjectEventPtr
+virDomainEventJobCompletedNewFromDom(virDomainPtr dom,
+ virTypedParameterPtr params,
+ int nparams)
+{
+ return virDomainEventJobCompletedNew(dom->id, dom->name, dom->uuid,
+ params, nparams);
+}
+
/* This function consumes the params so caller don't have to care about
* freeing it even if error occurs. The reason is to not have to do deep
goto cleanup;
}
+ case VIR_DOMAIN_EVENT_ID_JOB_COMPLETED:
+ {
+ virDomainEventJobCompletedPtr ev;
+
+ ev = (virDomainEventJobCompletedPtr) event;
+ ((virConnectDomainEventJobCompletedCallback) cb)(conn, dom,
+ ev->params,
+ ev->nparams,
+ cbopaque);
+ goto cleanup;
+ }
+
case VIR_DOMAIN_EVENT_ID_LAST:
break;
}
virDomainEventMigrationIterationNewFromDom(virDomainPtr dom,
int iteration);
+virObjectEventPtr
+virDomainEventJobCompletedNewFromObj(virDomainObjPtr obj,
+ virTypedParameterPtr params,
+ int nparams);
+
+virObjectEventPtr
+virDomainEventJobCompletedNewFromDom(virDomainPtr dom,
+ virTypedParameterPtr params,
+ int nparams);
+
int
virDomainEventStateRegister(virConnectPtr conn,
virObjectEventStatePtr state,
* when libvirtd is restarted. Note that time information returned for
* completed migrations may be completely irrelevant unless both source and
* destination hosts have synchronized time (i.e., NTP daemon is running on
- * both of them).
+ * both of them). The statistics of a completed job can also be obtained by
+ * listening to a VIR_DOMAIN_EVENT_ID_JOB_COMPLETED event (on the source host
+ * in case of a migration job).
*
* Returns 0 in case of success and -1 in case of failure.
*/
virDomainEventIOErrorNewFromObj;
virDomainEventIOErrorReasonNewFromDom;
virDomainEventIOErrorReasonNewFromObj;
+virDomainEventJobCompletedNewFromDom;
+virDomainEventJobCompletedNewFromObj;
virDomainEventLifecycleNew;
virDomainEventLifecycleNewFromDef;
virDomainEventLifecycleNewFromDom;
virNetClientPtr client,
void *evdata, void *opaque);
+static void
+remoteDomainBuildEventCallbackJobCompleted(virNetClientProgramPtr prog,
+ virNetClientPtr client,
+ void *evdata, void *opaque);
+
static void
remoteNetworkBuildEventLifecycle(virNetClientProgramPtr prog ATTRIBUTE_UNUSED,
virNetClientPtr client ATTRIBUTE_UNUSED,
remoteConnectNotifyEventConnectionClosed,
sizeof(remote_connect_event_connection_closed_msg),
(xdrproc_t)xdr_remote_connect_event_connection_closed_msg },
+ { REMOTE_PROC_DOMAIN_EVENT_CALLBACK_JOB_COMPLETED,
+ remoteDomainBuildEventCallbackJobCompleted,
+ sizeof(remote_domain_event_callback_job_completed_msg),
+ (xdrproc_t)xdr_remote_domain_event_callback_job_completed_msg },
};
static void
}
+static void
+remoteDomainBuildEventCallbackJobCompleted(virNetClientProgramPtr prog ATTRIBUTE_UNUSED,
+ virNetClientPtr client ATTRIBUTE_UNUSED,
+ void *evdata,
+ void *opaque)
+{
+ virConnectPtr conn = opaque;
+ remote_domain_event_callback_job_completed_msg *msg = evdata;
+ struct private_data *priv = conn->privateData;
+ virDomainPtr dom;
+ virObjectEventPtr event = NULL;
+ virTypedParameterPtr params = NULL;
+ int nparams = 0;
+
+ if (virTypedParamsDeserialize((virTypedParameterRemotePtr) msg->params.params_val,
+ msg->params.params_len,
+ REMOTE_DOMAIN_JOB_STATS_MAX,
+ ¶ms, &nparams) < 0)
+ return;
+
+ if (!(dom = get_nonnull_domain(conn, msg->dom))) {
+ virTypedParamsFree(params, nparams);
+ return;
+ }
+
+ event = virDomainEventJobCompletedNewFromDom(dom, params, nparams);
+
+ virObjectUnref(dom);
+
+ remoteEventQueue(priv, event, msg->callbackID);
+}
+
+
static void
remoteNetworkBuildEventLifecycle(virNetClientProgramPtr prog ATTRIBUTE_UNUSED,
virNetClientPtr client ATTRIBUTE_UNUSED,
int iteration;
};
+struct remote_domain_event_callback_job_completed_msg {
+ int callbackID;
+ remote_nonnull_domain dom;
+ remote_typed_param params<REMOTE_DOMAIN_JOB_STATS_MAX>;
+};
+
/*----- Protocol. -----*/
/* Define the program number, protocol version and procedure numbers here. */
* @generate: none
* @acl: none
*/
- REMOTE_PROC_CONNECT_EVENT_CONNECTION_CLOSED = 362
+ REMOTE_PROC_CONNECT_EVENT_CONNECTION_CLOSED = 362,
+
+ /**
+ * @generate: both
+ * @acl: none
+ */
+ REMOTE_PROC_DOMAIN_EVENT_CALLBACK_JOB_COMPLETED = 363
};
remote_nonnull_domain dom;
int iteration;
};
+struct remote_domain_event_callback_job_completed_msg {
+ int callbackID;
+ remote_nonnull_domain dom;
+ struct {
+ u_int params_len;
+ remote_typed_param * params_val;
+ } params;
+};
enum remote_procedure {
REMOTE_PROC_CONNECT_OPEN = 1,
REMOTE_PROC_CONNECT_CLOSE = 2,
REMOTE_PROC_CONNECT_CLOSE_CALLBACK_REGISTER = 360,
REMOTE_PROC_CONNECT_CLOSE_CALLBACK_UNREGISTER = 361,
REMOTE_PROC_CONNECT_EVENT_CONNECTION_CLOSED = 362,
+ REMOTE_PROC_DOMAIN_EVENT_CALLBACK_JOB_COMPLETED = 363,
};
virshEventPrint(opaque, &buf);
}
+static void
+virshEventJobCompletedPrint(virConnectPtr conn ATTRIBUTE_UNUSED,
+ virDomainPtr dom,
+ virTypedParameterPtr params,
+ int nparams,
+ void *opaque)
+{
+ virBuffer buf = VIR_BUFFER_INITIALIZER;
+ size_t i;
+ char *value;
+
+ virBufferAsprintf(&buf, _("event 'job-completed' for domain %s:\n"),
+ virDomainGetName(dom));
+ for (i = 0; i < nparams; i++) {
+ value = virTypedParameterToString(¶ms[i]);
+ if (value) {
+ virBufferAsprintf(&buf, "\t%s: %s\n", params[i].field, value);
+ VIR_FREE(value);
+ }
+ }
+ virshEventPrint(opaque, &buf);
+}
+
static vshEventCallback vshEventCallbacks[] = {
{ "lifecycle",
VIR_DOMAIN_EVENT_CALLBACK(virshEventLifecyclePrint), },
VIR_DOMAIN_EVENT_CALLBACK(virshEventDeviceAddedPrint), },
{ "migration-iteration",
VIR_DOMAIN_EVENT_CALLBACK(virshEventMigrationIterationPrint), },
+ { "job-completed",
+ VIR_DOMAIN_EVENT_CALLBACK(virshEventJobCompletedPrint), },
};
verify(VIR_DOMAIN_EVENT_ID_LAST == ARRAY_CARDINALITY(vshEventCallbacks));