qdev: HotplugHandler: Rename unplug callback to unplug_request

'HotplugHandler.unplug' callback is currently used as async
call to issue unplug request for device that implements it.
Renaming 'unplug' callback to 'unplug_request' should help to
avoid confusion about what callback does and would allow to
introduce 'unplug' callback that would perform actual device
removal when guest is ready for it.

Signed-off-by: Igor Mammedov <imammedo@redhat.com>
Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>
Signed-off-by: Andreas Färber <afaerber@suse.de>
This commit is contained in:
Igor Mammedov 2014-09-26 09:28:19 +00:00 committed by Andreas Färber
parent ce9835e00d
commit 14d5a28fb6
11 changed files with 32 additions and 29 deletions

View file

@ -47,7 +47,9 @@ typedef void (*hotplug_fn)(HotplugHandler *plug_handler,
*
* @parent: Opaque parent interface.
* @plug: plug callback.
* @unplug: unplug callback.
* @unplug_request: unplug request callback.
* Used as a means to initiate device unplug for devices that
* require asynchronous unplug handling.
*/
typedef struct HotplugHandlerClass {
/* <private> */
@ -55,7 +57,7 @@ typedef struct HotplugHandlerClass {
/* <public> */
hotplug_fn plug;
hotplug_fn unplug;
hotplug_fn unplug_request;
} HotplugHandlerClass;
/**
@ -68,11 +70,11 @@ void hotplug_handler_plug(HotplugHandler *plug_handler,
Error **errp);
/**
* hotplug_handler_unplug:
* hotplug_handler_unplug_request:
*
* Call #HotplugHandlerClass.unplug callback of @plug_handler.
* Calls #HotplugHandlerClass.unplug_request callback of @plug_handler.
*/
void hotplug_handler_unplug(HotplugHandler *plug_handler,
DeviceState *plugged_dev,
Error **errp);
void hotplug_handler_unplug_request(HotplugHandler *plug_handler,
DeviceState *plugged_dev,
Error **errp);
#endif