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