include/hw/qdev-core.h

22  * -----------
31  * information to the caller and must be re-entrant.
57  * ---------------
62  * DeviceListener can save the QOpts passed to it for re-using it
73     DEV_NVECTORS_UNSPECIFIED = -1,
101  * struct DeviceClass - The base class for all devices.
107  * @sync_config: Callback function invoked when QMP command device-sync-config
136      * ensures a compile-time error if someone attempts to assign
137      * dc->props directly.
148      * @user_creatable: Can user instantiate with -device / device_add?
165      * @legacy_reset: deprecated device reset method pointer
168      * implement a multi-phase reset.
170      * TODO: remove once every reset callback is unused
221  * struct DeviceState - common device state, accessed with qdev helpers
232      * @id: global device id
289      * @reset: ResettableState for the device; handled by Resettable interface.
291     ResettableState reset;  member
299      * Used to prevent re-entrancy confusing things.
344      * human-readable error message.
364 #define QDEV_HOTPLUG_HANDLER_PROPERTY "hotplug-handler"
402      * @reset: ResettableState for the bus; handled by Resettable interface.
404     ResettableState reset;  member
408  * typedef GlobalProperty - a global property type
414  * An error is fatal for non-hotplugged devices, when the global is applied.
461  * qdev_is_realized() - check if device is realized
469     return qatomic_load_acquire(&dev->realized);  in qdev_is_realized()
512  * via the child<> property, and so the reference-count-drop done here
526  *  - unrealize any child buses by calling qbus_unrealize()
528  *  - call the unrealize method of @dev
534  * devices which are hot-unpluggable should be unrealized (as part of
547  * qdev_get_hotplug_handler() - Get handler responsible for device wiring
593  * typedef GpioPolarity - Polarity of a GPIO line
595  * GPIO lines use either positive (active-high) logic,
596  * or negative (active-low) logic.
598  * In active-high logic (%GPIO_POLARITY_ACTIVE_HIGH), a pin is
600  * whereas in active-low logic (%GPIO_POLARITY_ACTIVE_LOW), a pin
671  * Instead, for fan-out you can use the TYPE_SPLIT_IRQ device: connect
673  * of the splitter's outputs to a different device.  For fan-in you
719  * returned does not belong to @dev -- it will be the input GPIO or
723  * You probably don't need to use this function -- it is used only
724  * by the platform-bus subsystem.
726  * Return: qemu_irq associated with GPIO or NULL if un-wired.
739  *   and is not suitable for use in non-testing parts of QEMU.
819  * qdev_init_gpio_in_named_with_opaque() - create an array of input GPIO lines
832  * qdev_init_gpio_in_named() - create an array of input GPIO lines
899  * device_cold_reset() - perform a recursive cold reset on a device
900  * @dev: device to reset.
902  * Reset device @dev and perform a recursive processing using the resettable
908  * bus_cold_reset() - perform a recursive cold reset on a bus
909  * @bus: bus to reset
911  * Reset bus @bus and perform a recursive processing using the resettable
917  * device_is_in_reset() - check device reset state
920  * Return: true if the device @dev is currently being reset.
925  * bus_is_in_reset() - check bus reset state
928  * Return: true if the bus @bus is currently being reset.
949  * Validate that the array does not have a legacy terminator at compile-time;
950  * requires -O2 and the array to be const.
956         if ((props)[props_count_ - 1].name == NULL) {                   \
975  * device_class_set_parent_realize() - set up for chaining realize fns
984  * dc->parent_realize(dev, errp)
991  * device_class_set_legacy_reset(): set the DeviceClass::reset method
993  * @dev_reset: the reset function
995  * This function sets the DeviceClass::reset method. This is widely
997  * Resettable API as documented in docs/devel/reset.rst.
999  * reset methods or which need to be subclassed must use Resettable.
1005  * device_class_set_parent_unrealize() - set up for chaining unrealize fns
1014  * dc->parent_unrealize(dev);
1048  * qdev_get_human_name() - Return a human-readable name for a device
1049  * @dev: The device. Must be a valid and non-NULL pointer.
1073     HotplugHandler *plug_handler = bus->hotplug_handler;  in qbus_is_hotpluggable()
1080         if (hdc->is_hotpluggable_bus) {  in qbus_is_hotpluggable()
1081             ret = hdc->is_hotpluggable_bus(plug_handler, bus);  in qbus_is_hotpluggable()
1100  * can use this function to mark the internal-only buses as full
1102  * created devices will appear on the expansion-port bus where
1107     bus->full = true;  in qbus_mark_full()
1114  * qdev_should_hide_device() - check if device should be hidden
1130     /* current_machine is not NULL, but current_machine->accel is NULL.  */
1134      * current_machine->accel is not NULL, but the machine properties have
1135      * not been validated and machine_class->init has not yet been called.
1145      * machine_class->init has been called, thus creating any embedded
1147      * this time are considered to be cold-plugged.
1153      * are considered to be hot-plugged.  The monitor is not restricted