be19d836cd
Pass an error object as the third parameter to "notifier with return" notifiers, so clients no longer need to bundle an error object in the opaque data. The new parameter is used in a later patch. Signed-off-by: Steve Sistare <steven.sistare@oracle.com> Reviewed-by: Peter Xu <peterx@redhat.com> Reviewed-by: David Hildenbrand <david@redhat.com> Link: https://lore.kernel.org/r/1708622920-68779-2-git-send-email-steven.sistare@oracle.com Signed-off-by: Peter Xu <peterx@redhat.com>
77 lines
2 KiB
C
77 lines
2 KiB
C
/*
|
|
* Notifier lists
|
|
*
|
|
* Copyright IBM, Corp. 2010
|
|
*
|
|
* 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 QEMU_NOTIFY_H
|
|
#define QEMU_NOTIFY_H
|
|
|
|
#include "qemu/queue.h"
|
|
|
|
typedef struct Notifier Notifier;
|
|
|
|
struct Notifier
|
|
{
|
|
void (*notify)(Notifier *notifier, void *data);
|
|
QLIST_ENTRY(Notifier) node;
|
|
};
|
|
|
|
typedef struct NotifierList
|
|
{
|
|
QLIST_HEAD(, Notifier) notifiers;
|
|
} NotifierList;
|
|
|
|
#define NOTIFIER_LIST_INITIALIZER(head) \
|
|
{ QLIST_HEAD_INITIALIZER((head).notifiers) }
|
|
|
|
void notifier_list_init(NotifierList *list);
|
|
|
|
void notifier_list_add(NotifierList *list, Notifier *notifier);
|
|
|
|
void notifier_remove(Notifier *notifier);
|
|
|
|
void notifier_list_notify(NotifierList *list, void *data);
|
|
|
|
bool notifier_list_empty(NotifierList *list);
|
|
|
|
/* Same as Notifier but allows .notify() to return errors */
|
|
typedef struct NotifierWithReturn NotifierWithReturn;
|
|
|
|
typedef int (*NotifierWithReturnFunc)(NotifierWithReturn *notifier, void *data,
|
|
Error **errp);
|
|
|
|
struct NotifierWithReturn {
|
|
/**
|
|
* Return 0 on success (next notifier will be invoked), otherwise
|
|
* notifier_with_return_list_notify() will stop and return the value.
|
|
*/
|
|
NotifierWithReturnFunc notify;
|
|
QLIST_ENTRY(NotifierWithReturn) node;
|
|
};
|
|
|
|
typedef struct NotifierWithReturnList {
|
|
QLIST_HEAD(, NotifierWithReturn) notifiers;
|
|
} NotifierWithReturnList;
|
|
|
|
#define NOTIFIER_WITH_RETURN_LIST_INITIALIZER(head) \
|
|
{ QLIST_HEAD_INITIALIZER((head).notifiers) }
|
|
|
|
void notifier_with_return_list_init(NotifierWithReturnList *list);
|
|
|
|
void notifier_with_return_list_add(NotifierWithReturnList *list,
|
|
NotifierWithReturn *notifier);
|
|
|
|
void notifier_with_return_remove(NotifierWithReturn *notifier);
|
|
|
|
int notifier_with_return_list_notify(NotifierWithReturnList *list,
|
|
void *data, Error **errp);
|
|
|
|
#endif
|