1/*
2 * Notifier lists
3 *
4 * Copyright IBM, Corp. 2010
5 *
6 * Authors:
7 * Anthony Liguori <aliguori@us.ibm.com>
8 *
9 * This work is licensed under the terms of the GNU GPL, version 2. See
10 * the COPYING file in the top-level directory.
11 *
12 */
13
14#ifndef QEMU_NOTIFY_H
15#define QEMU_NOTIFY_H
16
17#include "qemu/queue.h"
18
19typedef struct Notifier Notifier;
20
21struct Notifier
22{
23 void (*notify)(Notifier *notifier, void *data);
24 QLIST_ENTRY(Notifier) node;
25};
26
27typedef struct NotifierList
28{
29 QLIST_HEAD(, Notifier) notifiers;
30} NotifierList;
31
32#define NOTIFIER_LIST_INITIALIZER(head) \
33 { QLIST_HEAD_INITIALIZER((head).notifiers) }
34
35void notifier_list_init(NotifierList *list);
36
37void notifier_list_add(NotifierList *list, Notifier *notifier);
38
39void notifier_remove(Notifier *notifier);
40
41void notifier_list_notify(NotifierList *list, void *data);
42
43/* Same as Notifier but allows .notify() to return errors */
44typedef struct NotifierWithReturn NotifierWithReturn;
45
46struct NotifierWithReturn {
47 /**
48 * Return 0 on success (next notifier will be invoked), otherwise
49 * notifier_with_return_list_notify() will stop and return the value.
50 */
51 int (*notify)(NotifierWithReturn *notifier, void *data);
52 QLIST_ENTRY(NotifierWithReturn) node;
53};
54
55typedef struct NotifierWithReturnList {
56 QLIST_HEAD(, NotifierWithReturn) notifiers;
57} NotifierWithReturnList;
58
59#define NOTIFIER_WITH_RETURN_LIST_INITIALIZER(head) \
60 { QLIST_HEAD_INITIALIZER((head).notifiers) }
61
62void notifier_with_return_list_init(NotifierWithReturnList *list);
63
64void notifier_with_return_list_add(NotifierWithReturnList *list,
65 NotifierWithReturn *notifier);
66
67void notifier_with_return_remove(NotifierWithReturn *notifier);
68
69int notifier_with_return_list_notify(NotifierWithReturnList *list,
70 void *data);
71
72#endif
73