4c046ce37a
Implement a ResetContainer. This is a subclass of Object, and it implements the Resettable interface. The container holds a list of arbitrary other objects which implement Resettable, and when the container is reset, all the objects it contains are also reset. This will allow us to have a 3-phase-reset equivalent of the old qemu_register_reset() API: we will have a single "simulation reset" top level ResetContainer, and objects in it are the equivalent of the old QEMUResetHandler functions. The qemu_register_reset() API manages its list of callbacks using a QTAILQ, but here we use a GPtrArray for our list of Resettable children: we expect the "remove" operation (which will need to do an iteration through the list) to be fairly uncommon, and we get simpler code with fewer memory allocations. Since there is currently no listed owner in MAINTAINERS for the existing reset-related source files, create a new section for them, and add these new files there also. 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-7-peter.maydell@linaro.org Reviewed-by: Zhao Liu <zhao1.liu@intel.com>
49 lines
1.4 KiB
C
49 lines
1.4 KiB
C
/*
|
|
* Reset container
|
|
*
|
|
* Copyright (c) 2024 Linaro, Ltd
|
|
*
|
|
* This work is licensed under the terms of the GNU GPL, version 2 or later.
|
|
* See the COPYING file in the top-level directory.
|
|
*/
|
|
|
|
#ifndef HW_RESETCONTAINER_H
|
|
#define HW_RESETCONTAINER_H
|
|
|
|
/*
|
|
* The "reset container" is an object which implements the Resettable
|
|
* interface. It contains a list of arbitrary other objects which also
|
|
* implement Resettable. Resetting the reset container resets all the
|
|
* objects in it.
|
|
*/
|
|
|
|
#include "qom/object.h"
|
|
|
|
#define TYPE_RESETTABLE_CONTAINER "resettable-container"
|
|
OBJECT_DECLARE_TYPE(ResettableContainer, ResettableContainerClass, RESETTABLE_CONTAINER)
|
|
|
|
/**
|
|
* resettable_container_add: Add a resettable object to the container
|
|
* @rc: container
|
|
* @obj: object to add to the container
|
|
*
|
|
* Add @obj to the ResettableContainer @rc. @obj must implement the
|
|
* Resettable interface.
|
|
*
|
|
* When @rc is reset, it will reset every object that has been added
|
|
* to it, in the order they were added.
|
|
*/
|
|
void resettable_container_add(ResettableContainer *rc, Object *obj);
|
|
|
|
/**
|
|
* resettable_container_remove: Remove an object from the container
|
|
* @rc: container
|
|
* @obj: object to remove from the container
|
|
*
|
|
* Remove @obj from the ResettableContainer @rc. @obj must have been
|
|
* previously added to this container.
|
|
*/
|
|
void resettable_container_remove(ResettableContainer *rc, Object *obj);
|
|
|
|
#endif
|