memory: reorder MemoryRegion fields
[qemu/ar7.git] / include / hw / hotplug.h
blob2db025d0bdcf67875b18544900cb94c605c7f303
1 /*
2 * Hotplug handler interface.
4 * Copyright (c) 2014 Red Hat Inc.
6 * Authors:
7 * Igor Mammedov <imammedo@redhat.com>,
9 * This work is licensed under the terms of the GNU GPL, version 2 or later.
10 * See the COPYING file in the top-level directory.
12 #ifndef HOTPLUG_H
13 #define HOTPLUG_H
15 #include "qom/object.h"
16 #include "qemu/typedefs.h"
18 #define TYPE_HOTPLUG_HANDLER "hotplug-handler"
20 #define HOTPLUG_HANDLER_CLASS(klass) \
21 OBJECT_CLASS_CHECK(HotplugHandlerClass, (klass), TYPE_HOTPLUG_HANDLER)
22 #define HOTPLUG_HANDLER_GET_CLASS(obj) \
23 OBJECT_GET_CLASS(HotplugHandlerClass, (obj), TYPE_HOTPLUG_HANDLER)
24 #define HOTPLUG_HANDLER(obj) \
25 INTERFACE_CHECK(HotplugHandler, (obj), TYPE_HOTPLUG_HANDLER)
28 typedef struct HotplugHandler {
29 /* <private> */
30 Object Parent;
31 } HotplugHandler;
33 /**
34 * hotplug_fn:
35 * @plug_handler: a device performing plug/uplug action
36 * @plugged_dev: a device that has been (un)plugged
37 * @errp: returns an error if this function fails
39 typedef void (*hotplug_fn)(HotplugHandler *plug_handler,
40 DeviceState *plugged_dev, Error **errp);
42 /**
43 * HotplugDeviceClass:
45 * Interface to be implemented by a device performing
46 * hardware (un)plug functions.
48 * @parent: Opaque parent interface.
49 * @plug: plug callback.
50 * @unplug_request: unplug request callback.
51 * Used as a means to initiate device unplug for devices that
52 * require asynchronous unplug handling.
53 * @unplug: unplug callback.
54 * Used for device removal with devices that implement
55 * asynchronous and synchronous (surprise) removal.
57 typedef struct HotplugHandlerClass {
58 /* <private> */
59 InterfaceClass parent;
61 /* <public> */
62 hotplug_fn plug;
63 hotplug_fn unplug_request;
64 hotplug_fn unplug;
65 } HotplugHandlerClass;
67 /**
68 * hotplug_handler_plug:
70 * Call #HotplugHandlerClass.plug callback of @plug_handler.
72 void hotplug_handler_plug(HotplugHandler *plug_handler,
73 DeviceState *plugged_dev,
74 Error **errp);
76 /**
77 * hotplug_handler_unplug_request:
79 * Calls #HotplugHandlerClass.unplug_request callback of @plug_handler.
81 void hotplug_handler_unplug_request(HotplugHandler *plug_handler,
82 DeviceState *plugged_dev,
83 Error **errp);
84 /**
85 * hotplug_handler_unplug:
87 * Calls #HotplugHandlerClass.unplug callback of @plug_handler.
89 void hotplug_handler_unplug(HotplugHandler *plug_handler,
90 DeviceState *plugged_dev,
91 Error **errp);
92 #endif