fa3673e497
Extend the blocker interface so that a blocker can be registered for one or more migration modes. The existing interfaces register a blocker for all modes, and the new interfaces take a varargs list of modes. Internally, maintain a separate blocker list per mode. The same Error object may be added to multiple lists. When a block is deleted, it is removed from every list, and the Error is freed. No functional change until a new mode is added. Signed-off-by: Steve Sistare <steven.sistare@oracle.com> Reviewed-by: Juan Quintela <quintela@redhat.com> Signed-off-by: Juan Quintela <quintela@redhat.com> Message-ID: <1698263069-406971-3-git-send-email-steven.sistare@oracle.com>
98 lines
3.2 KiB
C
98 lines
3.2 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
|
|
|
|
#include "qapi/qapi-types-migration.h"
|
|
|
|
#define MIG_MODE_ALL MIG_MODE__MAX
|
|
|
|
/**
|
|
* @migrate_add_blocker - prevent all modes of 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 all modes of migration from
|
|
* proceeding, but ignore -only-migratable
|
|
*
|
|
* @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 migration blocker from all modes 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);
|
|
|
|
/**
|
|
* @migrate_add_blocker_normal - prevent normal migration mode 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_normal(Error **reasonp, Error **errp);
|
|
|
|
/**
|
|
* @migrate_add_blocker_modes - prevent some modes of 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.
|
|
*
|
|
* @mode - one or more migration modes to be blocked. The list is terminated
|
|
* by -1 or MIG_MODE_ALL. For the latter, all modes are blocked.
|
|
*
|
|
* @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 before the blocker is removed.
|
|
*/
|
|
int migrate_add_blocker_modes(Error **reasonp, Error **errp, MigMode mode, ...);
|
|
|
|
#endif
|