LXR qemu/include/qemu/notify.h

   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