c8a7fc5179
Modify migrate_add_blocker and migrate_del_blocker to take an Error ** reason. This allows migration to own the Error object, so that if an error occurs in migrate_add_blocker, migration code can free the Error and clear the client handle, simplifying client code. It also simplifies the migrate_del_blocker call site. In addition, this is a pre-requisite for a proposed future patch that would add a mode argument to migration requests to support live update, and maintain a list of blockers for each mode. A blocker may apply to a single mode or to multiple modes, and passing Error** will allow one Error object to be registered for multiple modes. No functional change. Signed-off-by: Steve Sistare <steven.sistare@oracle.com> Tested-by: Michael Galaxy <mgalaxy@akamai.com> Reviewed-by: Michael Galaxy <mgalaxy@akamai.com> Reviewed-by: Peter Xu <peterx@redhat.com> Reviewed-by: Juan Quintela <quintela@redhat.com> Signed-off-by: Juan Quintela <quintela@redhat.com> Message-ID: <1697634216-84215-1-git-send-email-steven.sistare@oracle.com>
62 lines
1.9 KiB
C
62 lines
1.9 KiB
C
/*
|
|
* QEMU migration blockers
|
|
*
|
|
* Copyright IBM, Corp. 2008
|
|
*
|
|
* Authors:
|
|
* Anthony Liguori <aliguori@us.ibm.com>
|
|
*
|
|
* This work is licensed under the terms of the GNU GPL, version 2. See
|
|
* the COPYING file in the top-level directory.
|
|
*
|
|
*/
|
|
|
|
#ifndef MIGRATION_BLOCKER_H
|
|
#define MIGRATION_BLOCKER_H
|
|
|
|
/**
|
|
* @migrate_add_blocker - prevent migration from proceeding
|
|
*
|
|
* @reasonp - address of an error to be returned whenever migration is attempted
|
|
*
|
|
* @errp - [out] The reason (if any) we cannot block migration right now.
|
|
*
|
|
* @returns - 0 on success, -EBUSY/-EACCES on failure, with errp set.
|
|
*
|
|
* *@reasonp is freed and set to NULL if failure is returned.
|
|
* On success, the caller must not free @reasonp, except by
|
|
* calling migrate_del_blocker.
|
|
*/
|
|
int migrate_add_blocker(Error **reasonp, Error **errp);
|
|
|
|
/**
|
|
* @migrate_add_blocker_internal - prevent migration from proceeding without
|
|
* only-migrate implications
|
|
*
|
|
* @reasonp - address of an error to be returned whenever migration is attempted
|
|
*
|
|
* @errp - [out] The reason (if any) we cannot block migration right now.
|
|
*
|
|
* @returns - 0 on success, -EBUSY on failure, with errp set.
|
|
*
|
|
* Some of the migration blockers can be temporary (e.g., for a few seconds),
|
|
* so it shouldn't need to conflict with "-only-migratable". For those cases,
|
|
* we can call this function rather than @migrate_add_blocker().
|
|
*
|
|
* *@reasonp is freed and set to NULL if failure is returned.
|
|
* On success, the caller must not free @reasonp, except by
|
|
* calling migrate_del_blocker.
|
|
*/
|
|
int migrate_add_blocker_internal(Error **reasonp, Error **errp);
|
|
|
|
/**
|
|
* @migrate_del_blocker - remove a blocking error from migration and free it.
|
|
*
|
|
* @reasonp - address of the error blocking migration
|
|
*
|
|
* This function frees *@reasonp and sets it to NULL.
|
|
*/
|
|
void migrate_del_blocker(Error **reasonp);
|
|
|
|
#endif
|