include/hw/resettable.h

29  * Types of reset.
31  * + Cold: reset resulting from a power cycle of the object.
32  * + Wakeup: reset resulting from a wake-up from a suspended state.
49  * See docs/devel/reset.rst for more detailed information about how QEMU models
50  * reset. This whole API must only be used when holding the iothread mutex.
52  * All objects which can be reset must implement this interface;
55  * progress of a reset operation by providing a ResettableState structure.
57  * state of the reset.
67  * for any reset event, in the order 'enter', 'hold', 'exit'.
70  * before eventually reset is deasserted and the 'exit' phase is called.
73  * functions) to be called at any point during reset after their
79  * @phases.enter: This phase is called when the object enters reset. It
80  * should reset local state of the object, but it must not do anything that
82  * line or reading or writing guest memory. It takes the reset's type as
85  * @phases.hold: This phase is called for entry into reset, once every object
86  * in the system which is being reset has had its @phases.enter method called.
89  * @phases.exit: This phase is called when the object leaves the reset state.
131  * Structure holding reset related state. The fields should not be accessed
135  * @count: Number of reset level the object is into. It is incremented when
136  * the reset operation starts and decremented when it finishes.
160  * Trigger a reset on an object @obj of type @type. @obj must implement
170  * Put an object @obj into reset. @obj must implement Resettable interface.
185  * Release the object @obj from reset. @obj must implement Resettable interface.
193  * Return true if @obj is under reset.
205  * This function will adapt the reset state of @obj so that it is coherent
206  * with the reset state of @newp. It may trigger @resettable_assert_reset()
207  * or @resettable_release_reset(). It will do such things only if the reset
210  * When using this function during reset, it must only be called during
219  * This function is typically useful to register a reset handler with
227  * Save @rc current reset phases into @parent_phases and override @rc phases