hw/core/reset: Add qemu_{register, unregister}_resettable()
Implement new functions qemu_register_resettable() and qemu_unregister_resettable(). These are intended to be three-phase-reset aware equivalents of the old qemu_register_reset() and qemu_unregister_reset(). Instead of passing in a function pointer and opaque, you register any QOM object that implements the Resettable interface. The implementation is simple: we have a single global instance of a ResettableContainer, which we reset in qemu_devices_reset(), and the Resettable objects passed to qemu_register_resettable() are added to it. Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Reviewed-by: Michael S. Tsirkin <mst@redhat.com> Reviewed-by: Richard Henderson <richard.henderson@linaro.org> Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> Message-id: 20240220160622.114437-8-peter.maydell@linaro.org Reviewed-by: Zhao Liu <zhao1.liu@intel.com>
This commit is contained in:
parent
4c046ce37a
commit
86fae16ed2
|
@ -26,8 +26,23 @@
|
||||||
#include "qemu/osdep.h"
|
#include "qemu/osdep.h"
|
||||||
#include "qemu/queue.h"
|
#include "qemu/queue.h"
|
||||||
#include "sysemu/reset.h"
|
#include "sysemu/reset.h"
|
||||||
|
#include "hw/resettable.h"
|
||||||
|
#include "hw/core/resetcontainer.h"
|
||||||
|
|
||||||
/* reset/shutdown handler */
|
/*
|
||||||
|
* Return a pointer to the singleton container that holds all the Resettable
|
||||||
|
* items that will be reset when qemu_devices_reset() is called.
|
||||||
|
*/
|
||||||
|
static ResettableContainer *get_root_reset_container(void)
|
||||||
|
{
|
||||||
|
static ResettableContainer *root_reset_container;
|
||||||
|
|
||||||
|
if (!root_reset_container) {
|
||||||
|
root_reset_container =
|
||||||
|
RESETTABLE_CONTAINER(object_new(TYPE_RESETTABLE_CONTAINER));
|
||||||
|
}
|
||||||
|
return root_reset_container;
|
||||||
|
}
|
||||||
|
|
||||||
typedef struct QEMUResetEntry {
|
typedef struct QEMUResetEntry {
|
||||||
QTAILQ_ENTRY(QEMUResetEntry) entry;
|
QTAILQ_ENTRY(QEMUResetEntry) entry;
|
||||||
|
@ -71,6 +86,16 @@ void qemu_unregister_reset(QEMUResetHandler *func, void *opaque)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
void qemu_register_resettable(Object *obj)
|
||||||
|
{
|
||||||
|
resettable_container_add(get_root_reset_container(), obj);
|
||||||
|
}
|
||||||
|
|
||||||
|
void qemu_unregister_resettable(Object *obj)
|
||||||
|
{
|
||||||
|
resettable_container_remove(get_root_reset_container(), obj);
|
||||||
|
}
|
||||||
|
|
||||||
void qemu_devices_reset(ShutdownCause reason)
|
void qemu_devices_reset(ShutdownCause reason)
|
||||||
{
|
{
|
||||||
QEMUResetEntry *re, *nre;
|
QEMUResetEntry *re, *nre;
|
||||||
|
@ -83,5 +108,7 @@ void qemu_devices_reset(ShutdownCause reason)
|
||||||
}
|
}
|
||||||
re->func(re->opaque);
|
re->func(re->opaque);
|
||||||
}
|
}
|
||||||
}
|
|
||||||
|
|
||||||
|
/* Reset the simulation */
|
||||||
|
resettable_reset(OBJECT(get_root_reset_container()), RESET_TYPE_COLD);
|
||||||
|
}
|
||||||
|
|
|
@ -31,6 +31,36 @@
|
||||||
|
|
||||||
typedef void QEMUResetHandler(void *opaque);
|
typedef void QEMUResetHandler(void *opaque);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* qemu_register_resettable: Register an object to be reset
|
||||||
|
* @obj: object to be reset: it must implement the Resettable interface
|
||||||
|
*
|
||||||
|
* Register @obj on the list of objects which will be reset when the
|
||||||
|
* simulation is reset. These objects will be reset in the order
|
||||||
|
* they were added, using the three-phase Resettable protocol,
|
||||||
|
* so first all objects go through the enter phase, then all objects
|
||||||
|
* go through the hold phase, and then finally all go through the
|
||||||
|
* exit phase.
|
||||||
|
*
|
||||||
|
* It is not permitted to register or unregister reset functions or
|
||||||
|
* resettable objects from within any of the reset phase methods of @obj.
|
||||||
|
*
|
||||||
|
* We assume that the caller holds the BQL.
|
||||||
|
*/
|
||||||
|
void qemu_register_resettable(Object *obj);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* qemu_unregister_resettable: Unregister an object to be reset
|
||||||
|
* @obj: object to unregister
|
||||||
|
*
|
||||||
|
* Remove @obj from the list of objects which are reset when the
|
||||||
|
* simulation is reset. It must have been previously added to
|
||||||
|
* the list via qemu_register_resettable().
|
||||||
|
*
|
||||||
|
* We assume that the caller holds the BQL.
|
||||||
|
*/
|
||||||
|
void qemu_unregister_resettable(Object *obj);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* qemu_register_reset: Register a callback for system reset
|
* qemu_register_reset: Register a callback for system reset
|
||||||
* @func: function to call
|
* @func: function to call
|
||||||
|
@ -44,8 +74,8 @@ typedef void QEMUResetHandler(void *opaque);
|
||||||
* for instance, device model reset is better accomplished using the
|
* for instance, device model reset is better accomplished using the
|
||||||
* methods on DeviceState.
|
* methods on DeviceState.
|
||||||
*
|
*
|
||||||
* It is not permitted to register or unregister reset functions from
|
* It is not permitted to register or unregister reset functions or
|
||||||
* within the @func callback.
|
* resettable objects from within the @func callback.
|
||||||
*
|
*
|
||||||
* We assume that the caller holds the BQL.
|
* We assume that the caller holds the BQL.
|
||||||
*/
|
*/
|
||||||
|
@ -81,7 +111,8 @@ void qemu_unregister_reset(QEMUResetHandler *func, void *opaque);
|
||||||
*
|
*
|
||||||
* This function performs the low-level work needed to do a complete reset
|
* This function performs the low-level work needed to do a complete reset
|
||||||
* of the system (calling all the callbacks registered with
|
* of the system (calling all the callbacks registered with
|
||||||
* qemu_register_reset()). It should only be called by the code in a
|
* qemu_register_reset() and resetting all the Resettable objects registered
|
||||||
|
* with qemu_register_resettable()). It should only be called by the code in a
|
||||||
* MachineClass reset method.
|
* MachineClass reset method.
|
||||||
*
|
*
|
||||||
* If you want to trigger a system reset from, for instance, a device
|
* If you want to trigger a system reset from, for instance, a device
|
||||||
|
|
Loading…
Reference in New Issue