1 /* 2 * Notifier lists 3 * 4 * Copyright IBM, Corp. 2010 5 * 6 * Authors: 7 * Anthony Liguori <aliguori (at) 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 19 typedef struct Notifier Notifier; 20 21 struct Notifier 22 { 23 void (*notify)(Notifier *notifier, void *data); 24 QLIST_ENTRY(Notifier) node; 25 }; 26 27 typedef struct NotifierList 28 { 29 QLIST_HEAD(, Notifier) notifiers; 30 } NotifierList; 31 32 #define NOTIFIER_LIST_INITIALIZER(head) \ 33 { QLIST_HEAD_INITIALIZER((head).notifiers) } 34 35 void notifier_list_init(NotifierList *list); 36 37 void notifier_list_add(NotifierList *list, Notifier *notifier); 38 39 void notifier_remove(Notifier *notifier); 40 41 void notifier_list_notify(NotifierList *list, void *data); 42 43 /* Same as Notifier but allows .notify() to return errors */ 44 typedef struct NotifierWithReturn NotifierWithReturn; 45 46 struct 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 55 typedef 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 62 void notifier_with_return_list_init(NotifierWithReturnList *list); 63 64 void notifier_with_return_list_add(NotifierWithReturnList *list, 65 NotifierWithReturn *notifier); 66 67 void notifier_with_return_remove(NotifierWithReturn *notifier); 68 69 int notifier_with_return_list_notify(NotifierWithReturnList *list, 70 void *data); 71 72 #endif 73