Signed-off-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Paolo Bonzini <pbonzini@redhat.com> Message-Id: <20200610053247.1583243-58-armbru@redhat.com>
1298 lines
37 KiB
C
1298 lines
37 KiB
C
/*
|
|
* Dynamic device configuration and creation.
|
|
*
|
|
* Copyright (c) 2009 CodeSourcery
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/* The theory here is that it should be possible to create a machine without
|
|
knowledge of specific devices. Historically board init routines have
|
|
passed a bunch of arguments to each device, requiring the board know
|
|
exactly which device it is dealing with. This file provides an abstract
|
|
API for device configuration and initialization. Devices will generally
|
|
inherit from a particular bus (e.g. PCI or I2C) rather than
|
|
this API directly. */
|
|
|
|
#include "qemu/osdep.h"
|
|
#include "qapi/error.h"
|
|
#include "qapi/qapi-events-qdev.h"
|
|
#include "qapi/qmp/qerror.h"
|
|
#include "qapi/visitor.h"
|
|
#include "qemu/error-report.h"
|
|
#include "qemu/option.h"
|
|
#include "hw/hotplug.h"
|
|
#include "hw/irq.h"
|
|
#include "hw/qdev-properties.h"
|
|
#include "hw/boards.h"
|
|
#include "hw/sysbus.h"
|
|
#include "hw/qdev-clock.h"
|
|
#include "migration/vmstate.h"
|
|
#include "trace.h"
|
|
|
|
bool qdev_hotplug = false;
|
|
static bool qdev_hot_added = false;
|
|
bool qdev_hot_removed = false;
|
|
|
|
const VMStateDescription *qdev_get_vmsd(DeviceState *dev)
|
|
{
|
|
DeviceClass *dc = DEVICE_GET_CLASS(dev);
|
|
return dc->vmsd;
|
|
}
|
|
|
|
static void bus_remove_child(BusState *bus, DeviceState *child)
|
|
{
|
|
BusChild *kid;
|
|
|
|
QTAILQ_FOREACH(kid, &bus->children, sibling) {
|
|
if (kid->child == child) {
|
|
char name[32];
|
|
|
|
snprintf(name, sizeof(name), "child[%d]", kid->index);
|
|
QTAILQ_REMOVE(&bus->children, kid, sibling);
|
|
|
|
bus->num_children--;
|
|
|
|
/* This gives back ownership of kid->child back to us. */
|
|
object_property_del(OBJECT(bus), name);
|
|
object_unref(OBJECT(kid->child));
|
|
g_free(kid);
|
|
return;
|
|
}
|
|
}
|
|
}
|
|
|
|
static void bus_add_child(BusState *bus, DeviceState *child)
|
|
{
|
|
char name[32];
|
|
BusChild *kid = g_malloc0(sizeof(*kid));
|
|
|
|
bus->num_children++;
|
|
kid->index = bus->max_index++;
|
|
kid->child = child;
|
|
object_ref(OBJECT(kid->child));
|
|
|
|
QTAILQ_INSERT_HEAD(&bus->children, kid, sibling);
|
|
|
|
/* This transfers ownership of kid->child to the property. */
|
|
snprintf(name, sizeof(name), "child[%d]", kid->index);
|
|
object_property_add_link(OBJECT(bus), name,
|
|
object_get_typename(OBJECT(child)),
|
|
(Object **)&kid->child,
|
|
NULL, /* read-only property */
|
|
0);
|
|
}
|
|
|
|
void qdev_set_parent_bus(DeviceState *dev, BusState *bus)
|
|
{
|
|
BusState *old_parent_bus = dev->parent_bus;
|
|
DeviceClass *dc = DEVICE_GET_CLASS(dev);
|
|
|
|
assert(dc->bus_type && object_dynamic_cast(OBJECT(bus), dc->bus_type));
|
|
|
|
if (old_parent_bus) {
|
|
trace_qdev_update_parent_bus(dev, object_get_typename(OBJECT(dev)),
|
|
old_parent_bus, object_get_typename(OBJECT(old_parent_bus)),
|
|
OBJECT(bus), object_get_typename(OBJECT(bus)));
|
|
/*
|
|
* Keep a reference to the device while it's not plugged into
|
|
* any bus, to avoid it potentially evaporating when it is
|
|
* dereffed in bus_remove_child().
|
|
* Also keep the ref of the parent bus until the end, so that
|
|
* we can safely call resettable_change_parent() below.
|
|
*/
|
|
object_ref(OBJECT(dev));
|
|
bus_remove_child(dev->parent_bus, dev);
|
|
}
|
|
dev->parent_bus = bus;
|
|
object_ref(OBJECT(bus));
|
|
bus_add_child(bus, dev);
|
|
if (dev->realized) {
|
|
resettable_change_parent(OBJECT(dev), OBJECT(bus),
|
|
OBJECT(old_parent_bus));
|
|
}
|
|
if (old_parent_bus) {
|
|
object_unref(OBJECT(old_parent_bus));
|
|
object_unref(OBJECT(dev));
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Create a device on the heap.
|
|
* A type @name must exist.
|
|
* This only initializes the device state structure and allows
|
|
* properties to be set. The device still needs to be realized. See
|
|
* qdev-core.h.
|
|
*/
|
|
DeviceState *qdev_new(const char *name)
|
|
{
|
|
return DEVICE(object_new(name));
|
|
}
|
|
|
|
/*
|
|
* Try to create a device on the heap.
|
|
* This is like qdev_new(), except it returns %NULL when type @name
|
|
* does not exist.
|
|
*/
|
|
DeviceState *qdev_try_new(const char *name)
|
|
{
|
|
if (!object_class_by_name(name)) {
|
|
return NULL;
|
|
}
|
|
|
|
return DEVICE(object_new(name));
|
|
}
|
|
|
|
static QTAILQ_HEAD(, DeviceListener) device_listeners
|
|
= QTAILQ_HEAD_INITIALIZER(device_listeners);
|
|
|
|
enum ListenerDirection { Forward, Reverse };
|
|
|
|
#define DEVICE_LISTENER_CALL(_callback, _direction, _args...) \
|
|
do { \
|
|
DeviceListener *_listener; \
|
|
\
|
|
switch (_direction) { \
|
|
case Forward: \
|
|
QTAILQ_FOREACH(_listener, &device_listeners, link) { \
|
|
if (_listener->_callback) { \
|
|
_listener->_callback(_listener, ##_args); \
|
|
} \
|
|
} \
|
|
break; \
|
|
case Reverse: \
|
|
QTAILQ_FOREACH_REVERSE(_listener, &device_listeners, \
|
|
link) { \
|
|
if (_listener->_callback) { \
|
|
_listener->_callback(_listener, ##_args); \
|
|
} \
|
|
} \
|
|
break; \
|
|
default: \
|
|
abort(); \
|
|
} \
|
|
} while (0)
|
|
|
|
static int device_listener_add(DeviceState *dev, void *opaque)
|
|
{
|
|
DEVICE_LISTENER_CALL(realize, Forward, dev);
|
|
|
|
return 0;
|
|
}
|
|
|
|
void device_listener_register(DeviceListener *listener)
|
|
{
|
|
QTAILQ_INSERT_TAIL(&device_listeners, listener, link);
|
|
|
|
qbus_walk_children(sysbus_get_default(), NULL, NULL, device_listener_add,
|
|
NULL, NULL);
|
|
}
|
|
|
|
void device_listener_unregister(DeviceListener *listener)
|
|
{
|
|
QTAILQ_REMOVE(&device_listeners, listener, link);
|
|
}
|
|
|
|
bool qdev_should_hide_device(QemuOpts *opts)
|
|
{
|
|
int rc = -1;
|
|
DeviceListener *listener;
|
|
|
|
QTAILQ_FOREACH(listener, &device_listeners, link) {
|
|
if (listener->should_be_hidden) {
|
|
/*
|
|
* should_be_hidden_will return
|
|
* 1 if device matches opts and it should be hidden
|
|
* 0 if device matches opts and should not be hidden
|
|
* -1 if device doesn't match ops
|
|
*/
|
|
rc = listener->should_be_hidden(listener, opts);
|
|
}
|
|
|
|
if (rc > 0) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
return rc > 0;
|
|
}
|
|
|
|
void qdev_set_legacy_instance_id(DeviceState *dev, int alias_id,
|
|
int required_for_version)
|
|
{
|
|
assert(!dev->realized);
|
|
dev->instance_id_alias = alias_id;
|
|
dev->alias_required_for_version = required_for_version;
|
|
}
|
|
|
|
HotplugHandler *qdev_get_machine_hotplug_handler(DeviceState *dev)
|
|
{
|
|
MachineState *machine;
|
|
MachineClass *mc;
|
|
Object *m_obj = qdev_get_machine();
|
|
|
|
if (object_dynamic_cast(m_obj, TYPE_MACHINE)) {
|
|
machine = MACHINE(m_obj);
|
|
mc = MACHINE_GET_CLASS(machine);
|
|
if (mc->get_hotplug_handler) {
|
|
return mc->get_hotplug_handler(machine, dev);
|
|
}
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
bool qdev_hotplug_allowed(DeviceState *dev, Error **errp)
|
|
{
|
|
MachineState *machine;
|
|
MachineClass *mc;
|
|
Object *m_obj = qdev_get_machine();
|
|
|
|
if (object_dynamic_cast(m_obj, TYPE_MACHINE)) {
|
|
machine = MACHINE(m_obj);
|
|
mc = MACHINE_GET_CLASS(machine);
|
|
if (mc->hotplug_allowed) {
|
|
return mc->hotplug_allowed(machine, dev, errp);
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
HotplugHandler *qdev_get_bus_hotplug_handler(DeviceState *dev)
|
|
{
|
|
if (dev->parent_bus) {
|
|
return dev->parent_bus->hotplug_handler;
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
HotplugHandler *qdev_get_hotplug_handler(DeviceState *dev)
|
|
{
|
|
HotplugHandler *hotplug_ctrl = qdev_get_machine_hotplug_handler(dev);
|
|
|
|
if (hotplug_ctrl == NULL && dev->parent_bus) {
|
|
hotplug_ctrl = qdev_get_bus_hotplug_handler(dev);
|
|
}
|
|
return hotplug_ctrl;
|
|
}
|
|
|
|
static int qdev_prereset(DeviceState *dev, void *opaque)
|
|
{
|
|
trace_qdev_reset_tree(dev, object_get_typename(OBJECT(dev)));
|
|
return 0;
|
|
}
|
|
|
|
static int qbus_prereset(BusState *bus, void *opaque)
|
|
{
|
|
trace_qbus_reset_tree(bus, object_get_typename(OBJECT(bus)));
|
|
return 0;
|
|
}
|
|
|
|
static int qdev_reset_one(DeviceState *dev, void *opaque)
|
|
{
|
|
device_legacy_reset(dev);
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int qbus_reset_one(BusState *bus, void *opaque)
|
|
{
|
|
BusClass *bc = BUS_GET_CLASS(bus);
|
|
trace_qbus_reset(bus, object_get_typename(OBJECT(bus)));
|
|
if (bc->reset) {
|
|
bc->reset(bus);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
void qdev_reset_all(DeviceState *dev)
|
|
{
|
|
trace_qdev_reset_all(dev, object_get_typename(OBJECT(dev)));
|
|
qdev_walk_children(dev, qdev_prereset, qbus_prereset,
|
|
qdev_reset_one, qbus_reset_one, NULL);
|
|
}
|
|
|
|
void qdev_reset_all_fn(void *opaque)
|
|
{
|
|
qdev_reset_all(DEVICE(opaque));
|
|
}
|
|
|
|
void qbus_reset_all(BusState *bus)
|
|
{
|
|
trace_qbus_reset_all(bus, object_get_typename(OBJECT(bus)));
|
|
qbus_walk_children(bus, qdev_prereset, qbus_prereset,
|
|
qdev_reset_one, qbus_reset_one, NULL);
|
|
}
|
|
|
|
void qbus_reset_all_fn(void *opaque)
|
|
{
|
|
BusState *bus = opaque;
|
|
qbus_reset_all(bus);
|
|
}
|
|
|
|
void device_cold_reset(DeviceState *dev)
|
|
{
|
|
resettable_reset(OBJECT(dev), RESET_TYPE_COLD);
|
|
}
|
|
|
|
bool device_is_in_reset(DeviceState *dev)
|
|
{
|
|
return resettable_is_in_reset(OBJECT(dev));
|
|
}
|
|
|
|
static ResettableState *device_get_reset_state(Object *obj)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
return &dev->reset;
|
|
}
|
|
|
|
static void device_reset_child_foreach(Object *obj, ResettableChildCallback cb,
|
|
void *opaque, ResetType type)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
BusState *bus;
|
|
|
|
QLIST_FOREACH(bus, &dev->child_bus, sibling) {
|
|
cb(OBJECT(bus), opaque, type);
|
|
}
|
|
}
|
|
|
|
/* can be used as ->unplug() callback for the simple cases */
|
|
void qdev_simple_device_unplug_cb(HotplugHandler *hotplug_dev,
|
|
DeviceState *dev, Error **errp)
|
|
{
|
|
qdev_unrealize(dev);
|
|
}
|
|
|
|
/*
|
|
* Realize @dev.
|
|
* @dev must not be plugged into a bus.
|
|
* If @bus, plug @dev into @bus. This takes a reference to @dev.
|
|
* If @dev has no QOM parent, make one up, taking another reference.
|
|
* On success, return true.
|
|
* On failure, store an error through @errp and return false.
|
|
*/
|
|
bool qdev_realize(DeviceState *dev, BusState *bus, Error **errp)
|
|
{
|
|
Error *err = NULL;
|
|
|
|
assert(!dev->realized && !dev->parent_bus);
|
|
|
|
if (bus) {
|
|
qdev_set_parent_bus(dev, bus);
|
|
} else {
|
|
assert(!DEVICE_GET_CLASS(dev)->bus_type);
|
|
}
|
|
|
|
object_property_set_bool(OBJECT(dev), true, "realized", &err);
|
|
if (err) {
|
|
error_propagate(errp, err);
|
|
}
|
|
return !err;
|
|
}
|
|
|
|
/*
|
|
* Realize @dev and drop a reference.
|
|
* This is like qdev_realize(), except the caller must hold a
|
|
* (private) reference, which is dropped on return regardless of
|
|
* success or failure. Intended use:
|
|
* dev = qdev_new();
|
|
* [...]
|
|
* qdev_realize_and_unref(dev, bus, errp);
|
|
* Now @dev can go away without further ado.
|
|
*/
|
|
bool qdev_realize_and_unref(DeviceState *dev, BusState *bus, Error **errp)
|
|
{
|
|
bool ret;
|
|
|
|
ret = qdev_realize(dev, bus, errp);
|
|
object_unref(OBJECT(dev));
|
|
return ret;
|
|
}
|
|
|
|
void qdev_unrealize(DeviceState *dev)
|
|
{
|
|
object_property_set_bool(OBJECT(dev), false, "realized", &error_abort);
|
|
}
|
|
|
|
static int qdev_assert_realized_properly(Object *obj, void *opaque)
|
|
{
|
|
DeviceState *dev = DEVICE(object_dynamic_cast(obj, TYPE_DEVICE));
|
|
DeviceClass *dc;
|
|
|
|
if (dev) {
|
|
dc = DEVICE_GET_CLASS(dev);
|
|
assert(dev->realized);
|
|
assert(dev->parent_bus || !dc->bus_type);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
void qdev_machine_creation_done(void)
|
|
{
|
|
/*
|
|
* ok, initial machine setup is done, starting from now we can
|
|
* only create hotpluggable devices
|
|
*/
|
|
qdev_hotplug = true;
|
|
|
|
object_child_foreach_recursive(object_get_root(),
|
|
qdev_assert_realized_properly, NULL);
|
|
}
|
|
|
|
bool qdev_machine_modified(void)
|
|
{
|
|
return qdev_hot_added || qdev_hot_removed;
|
|
}
|
|
|
|
BusState *qdev_get_parent_bus(DeviceState *dev)
|
|
{
|
|
return dev->parent_bus;
|
|
}
|
|
|
|
static NamedGPIOList *qdev_get_named_gpio_list(DeviceState *dev,
|
|
const char *name)
|
|
{
|
|
NamedGPIOList *ngl;
|
|
|
|
QLIST_FOREACH(ngl, &dev->gpios, node) {
|
|
/* NULL is a valid and matchable name. */
|
|
if (g_strcmp0(name, ngl->name) == 0) {
|
|
return ngl;
|
|
}
|
|
}
|
|
|
|
ngl = g_malloc0(sizeof(*ngl));
|
|
ngl->name = g_strdup(name);
|
|
QLIST_INSERT_HEAD(&dev->gpios, ngl, node);
|
|
return ngl;
|
|
}
|
|
|
|
void qdev_init_gpio_in_named_with_opaque(DeviceState *dev,
|
|
qemu_irq_handler handler,
|
|
void *opaque,
|
|
const char *name, int n)
|
|
{
|
|
int i;
|
|
NamedGPIOList *gpio_list = qdev_get_named_gpio_list(dev, name);
|
|
|
|
assert(gpio_list->num_out == 0 || !name);
|
|
gpio_list->in = qemu_extend_irqs(gpio_list->in, gpio_list->num_in, handler,
|
|
opaque, n);
|
|
|
|
if (!name) {
|
|
name = "unnamed-gpio-in";
|
|
}
|
|
for (i = gpio_list->num_in; i < gpio_list->num_in + n; i++) {
|
|
gchar *propname = g_strdup_printf("%s[%u]", name, i);
|
|
|
|
object_property_add_child(OBJECT(dev), propname,
|
|
OBJECT(gpio_list->in[i]));
|
|
g_free(propname);
|
|
}
|
|
|
|
gpio_list->num_in += n;
|
|
}
|
|
|
|
void qdev_init_gpio_in(DeviceState *dev, qemu_irq_handler handler, int n)
|
|
{
|
|
qdev_init_gpio_in_named(dev, handler, NULL, n);
|
|
}
|
|
|
|
void qdev_init_gpio_out_named(DeviceState *dev, qemu_irq *pins,
|
|
const char *name, int n)
|
|
{
|
|
int i;
|
|
NamedGPIOList *gpio_list = qdev_get_named_gpio_list(dev, name);
|
|
|
|
assert(gpio_list->num_in == 0 || !name);
|
|
|
|
if (!name) {
|
|
name = "unnamed-gpio-out";
|
|
}
|
|
memset(pins, 0, sizeof(*pins) * n);
|
|
for (i = 0; i < n; ++i) {
|
|
gchar *propname = g_strdup_printf("%s[%u]", name,
|
|
gpio_list->num_out + i);
|
|
|
|
object_property_add_link(OBJECT(dev), propname, TYPE_IRQ,
|
|
(Object **)&pins[i],
|
|
object_property_allow_set_link,
|
|
OBJ_PROP_LINK_STRONG);
|
|
g_free(propname);
|
|
}
|
|
gpio_list->num_out += n;
|
|
}
|
|
|
|
void qdev_init_gpio_out(DeviceState *dev, qemu_irq *pins, int n)
|
|
{
|
|
qdev_init_gpio_out_named(dev, pins, NULL, n);
|
|
}
|
|
|
|
qemu_irq qdev_get_gpio_in_named(DeviceState *dev, const char *name, int n)
|
|
{
|
|
NamedGPIOList *gpio_list = qdev_get_named_gpio_list(dev, name);
|
|
|
|
assert(n >= 0 && n < gpio_list->num_in);
|
|
return gpio_list->in[n];
|
|
}
|
|
|
|
qemu_irq qdev_get_gpio_in(DeviceState *dev, int n)
|
|
{
|
|
return qdev_get_gpio_in_named(dev, NULL, n);
|
|
}
|
|
|
|
void qdev_connect_gpio_out_named(DeviceState *dev, const char *name, int n,
|
|
qemu_irq pin)
|
|
{
|
|
char *propname = g_strdup_printf("%s[%d]",
|
|
name ? name : "unnamed-gpio-out", n);
|
|
if (pin && !OBJECT(pin)->parent) {
|
|
/* We need a name for object_property_set_link to work */
|
|
object_property_add_child(container_get(qdev_get_machine(),
|
|
"/unattached"),
|
|
"non-qdev-gpio[*]", OBJECT(pin));
|
|
}
|
|
object_property_set_link(OBJECT(dev), OBJECT(pin), propname, &error_abort);
|
|
g_free(propname);
|
|
}
|
|
|
|
qemu_irq qdev_get_gpio_out_connector(DeviceState *dev, const char *name, int n)
|
|
{
|
|
g_autofree char *propname = g_strdup_printf("%s[%d]",
|
|
name ? name : "unnamed-gpio-out", n);
|
|
|
|
qemu_irq ret = (qemu_irq)object_property_get_link(OBJECT(dev), propname,
|
|
NULL);
|
|
|
|
return ret;
|
|
}
|
|
|
|
/* disconnect a GPIO output, returning the disconnected input (if any) */
|
|
|
|
static qemu_irq qdev_disconnect_gpio_out_named(DeviceState *dev,
|
|
const char *name, int n)
|
|
{
|
|
char *propname = g_strdup_printf("%s[%d]",
|
|
name ? name : "unnamed-gpio-out", n);
|
|
|
|
qemu_irq ret = (qemu_irq)object_property_get_link(OBJECT(dev), propname,
|
|
NULL);
|
|
if (ret) {
|
|
object_property_set_link(OBJECT(dev), NULL, propname, NULL);
|
|
}
|
|
g_free(propname);
|
|
return ret;
|
|
}
|
|
|
|
qemu_irq qdev_intercept_gpio_out(DeviceState *dev, qemu_irq icpt,
|
|
const char *name, int n)
|
|
{
|
|
qemu_irq disconnected = qdev_disconnect_gpio_out_named(dev, name, n);
|
|
qdev_connect_gpio_out_named(dev, name, n, icpt);
|
|
return disconnected;
|
|
}
|
|
|
|
void qdev_connect_gpio_out(DeviceState * dev, int n, qemu_irq pin)
|
|
{
|
|
qdev_connect_gpio_out_named(dev, NULL, n, pin);
|
|
}
|
|
|
|
void qdev_pass_gpios(DeviceState *dev, DeviceState *container,
|
|
const char *name)
|
|
{
|
|
int i;
|
|
NamedGPIOList *ngl = qdev_get_named_gpio_list(dev, name);
|
|
|
|
for (i = 0; i < ngl->num_in; i++) {
|
|
const char *nm = ngl->name ? ngl->name : "unnamed-gpio-in";
|
|
char *propname = g_strdup_printf("%s[%d]", nm, i);
|
|
|
|
object_property_add_alias(OBJECT(container), propname,
|
|
OBJECT(dev), propname);
|
|
g_free(propname);
|
|
}
|
|
for (i = 0; i < ngl->num_out; i++) {
|
|
const char *nm = ngl->name ? ngl->name : "unnamed-gpio-out";
|
|
char *propname = g_strdup_printf("%s[%d]", nm, i);
|
|
|
|
object_property_add_alias(OBJECT(container), propname,
|
|
OBJECT(dev), propname);
|
|
g_free(propname);
|
|
}
|
|
QLIST_REMOVE(ngl, node);
|
|
QLIST_INSERT_HEAD(&container->gpios, ngl, node);
|
|
}
|
|
|
|
BusState *qdev_get_child_bus(DeviceState *dev, const char *name)
|
|
{
|
|
BusState *bus;
|
|
Object *child = object_resolve_path_component(OBJECT(dev), name);
|
|
|
|
bus = (BusState *)object_dynamic_cast(child, TYPE_BUS);
|
|
if (bus) {
|
|
return bus;
|
|
}
|
|
|
|
QLIST_FOREACH(bus, &dev->child_bus, sibling) {
|
|
if (strcmp(name, bus->name) == 0) {
|
|
return bus;
|
|
}
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
int qdev_walk_children(DeviceState *dev,
|
|
qdev_walkerfn *pre_devfn, qbus_walkerfn *pre_busfn,
|
|
qdev_walkerfn *post_devfn, qbus_walkerfn *post_busfn,
|
|
void *opaque)
|
|
{
|
|
BusState *bus;
|
|
int err;
|
|
|
|
if (pre_devfn) {
|
|
err = pre_devfn(dev, opaque);
|
|
if (err) {
|
|
return err;
|
|
}
|
|
}
|
|
|
|
QLIST_FOREACH(bus, &dev->child_bus, sibling) {
|
|
err = qbus_walk_children(bus, pre_devfn, pre_busfn,
|
|
post_devfn, post_busfn, opaque);
|
|
if (err < 0) {
|
|
return err;
|
|
}
|
|
}
|
|
|
|
if (post_devfn) {
|
|
err = post_devfn(dev, opaque);
|
|
if (err) {
|
|
return err;
|
|
}
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
DeviceState *qdev_find_recursive(BusState *bus, const char *id)
|
|
{
|
|
BusChild *kid;
|
|
DeviceState *ret;
|
|
BusState *child;
|
|
|
|
QTAILQ_FOREACH(kid, &bus->children, sibling) {
|
|
DeviceState *dev = kid->child;
|
|
|
|
if (dev->id && strcmp(dev->id, id) == 0) {
|
|
return dev;
|
|
}
|
|
|
|
QLIST_FOREACH(child, &dev->child_bus, sibling) {
|
|
ret = qdev_find_recursive(child, id);
|
|
if (ret) {
|
|
return ret;
|
|
}
|
|
}
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
char *qdev_get_dev_path(DeviceState *dev)
|
|
{
|
|
BusClass *bc;
|
|
|
|
if (!dev || !dev->parent_bus) {
|
|
return NULL;
|
|
}
|
|
|
|
bc = BUS_GET_CLASS(dev->parent_bus);
|
|
if (bc->get_dev_path) {
|
|
return bc->get_dev_path(dev);
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* Legacy property handling
|
|
*/
|
|
|
|
static void qdev_get_legacy_property(Object *obj, Visitor *v,
|
|
const char *name, void *opaque,
|
|
Error **errp)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
Property *prop = opaque;
|
|
|
|
char buffer[1024];
|
|
char *ptr = buffer;
|
|
|
|
prop->info->print(dev, prop, buffer, sizeof(buffer));
|
|
visit_type_str(v, name, &ptr, errp);
|
|
}
|
|
|
|
/**
|
|
* qdev_class_add_legacy_property:
|
|
* @dev: Device to add the property to.
|
|
* @prop: The qdev property definition.
|
|
*
|
|
* Add a legacy QOM property to @dev for qdev property @prop.
|
|
*
|
|
* Legacy properties are string versions of QOM properties. The format of
|
|
* the string depends on the property type. Legacy properties are only
|
|
* needed for "info qtree".
|
|
*
|
|
* Do not use this in new code! QOM Properties added through this interface
|
|
* will be given names in the "legacy" namespace.
|
|
*/
|
|
static void qdev_class_add_legacy_property(DeviceClass *dc, Property *prop)
|
|
{
|
|
g_autofree char *name = NULL;
|
|
|
|
/* Register pointer properties as legacy properties */
|
|
if (!prop->info->print && prop->info->get) {
|
|
return;
|
|
}
|
|
|
|
name = g_strdup_printf("legacy-%s", prop->name);
|
|
object_class_property_add(OBJECT_CLASS(dc), name, "str",
|
|
prop->info->print ? qdev_get_legacy_property : prop->info->get,
|
|
NULL, NULL, prop);
|
|
}
|
|
|
|
void qdev_property_add_static(DeviceState *dev, Property *prop)
|
|
{
|
|
Object *obj = OBJECT(dev);
|
|
ObjectProperty *op;
|
|
|
|
assert(!prop->info->create);
|
|
|
|
op = object_property_add(obj, prop->name, prop->info->name,
|
|
prop->info->get, prop->info->set,
|
|
prop->info->release,
|
|
prop);
|
|
|
|
object_property_set_description(obj, prop->name,
|
|
prop->info->description);
|
|
|
|
if (prop->set_default) {
|
|
prop->info->set_default_value(op, prop);
|
|
if (op->init) {
|
|
op->init(obj, op);
|
|
}
|
|
}
|
|
}
|
|
|
|
static void qdev_class_add_property(DeviceClass *klass, Property *prop)
|
|
{
|
|
ObjectClass *oc = OBJECT_CLASS(klass);
|
|
|
|
if (prop->info->create) {
|
|
prop->info->create(oc, prop);
|
|
} else {
|
|
ObjectProperty *op;
|
|
|
|
op = object_class_property_add(oc,
|
|
prop->name, prop->info->name,
|
|
prop->info->get, prop->info->set,
|
|
prop->info->release,
|
|
prop);
|
|
if (prop->set_default) {
|
|
prop->info->set_default_value(op, prop);
|
|
}
|
|
}
|
|
object_class_property_set_description(oc, prop->name,
|
|
prop->info->description);
|
|
}
|
|
|
|
/* @qdev_alias_all_properties - Add alias properties to the source object for
|
|
* all qdev properties on the target DeviceState.
|
|
*/
|
|
void qdev_alias_all_properties(DeviceState *target, Object *source)
|
|
{
|
|
ObjectClass *class;
|
|
Property *prop;
|
|
|
|
class = object_get_class(OBJECT(target));
|
|
do {
|
|
DeviceClass *dc = DEVICE_CLASS(class);
|
|
|
|
for (prop = dc->props_; prop && prop->name; prop++) {
|
|
object_property_add_alias(source, prop->name,
|
|
OBJECT(target), prop->name);
|
|
}
|
|
class = object_class_get_parent(class);
|
|
} while (class != object_class_by_name(TYPE_DEVICE));
|
|
}
|
|
|
|
static bool device_get_realized(Object *obj, Error **errp)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
return dev->realized;
|
|
}
|
|
|
|
static bool check_only_migratable(Object *obj, Error **errp)
|
|
{
|
|
DeviceClass *dc = DEVICE_GET_CLASS(obj);
|
|
|
|
if (!vmstate_check_only_migratable(dc->vmsd)) {
|
|
error_setg(errp, "Device %s is not migratable, but "
|
|
"--only-migratable was specified",
|
|
object_get_typename(obj));
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
static void device_set_realized(Object *obj, bool value, Error **errp)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
DeviceClass *dc = DEVICE_GET_CLASS(dev);
|
|
HotplugHandler *hotplug_ctrl;
|
|
BusState *bus;
|
|
NamedClockList *ncl;
|
|
Error *local_err = NULL;
|
|
bool unattached_parent = false;
|
|
static int unattached_count;
|
|
|
|
if (dev->hotplugged && !dc->hotpluggable) {
|
|
error_setg(errp, QERR_DEVICE_NO_HOTPLUG, object_get_typename(obj));
|
|
return;
|
|
}
|
|
|
|
if (value && !dev->realized) {
|
|
if (!check_only_migratable(obj, &local_err)) {
|
|
goto fail;
|
|
}
|
|
|
|
if (!obj->parent) {
|
|
gchar *name = g_strdup_printf("device[%d]", unattached_count++);
|
|
|
|
object_property_add_child(container_get(qdev_get_machine(),
|
|
"/unattached"),
|
|
name, obj);
|
|
unattached_parent = true;
|
|
g_free(name);
|
|
}
|
|
|
|
hotplug_ctrl = qdev_get_hotplug_handler(dev);
|
|
if (hotplug_ctrl) {
|
|
hotplug_handler_pre_plug(hotplug_ctrl, dev, &local_err);
|
|
if (local_err != NULL) {
|
|
goto fail;
|
|
}
|
|
}
|
|
|
|
if (dc->realize) {
|
|
dc->realize(dev, &local_err);
|
|
if (local_err != NULL) {
|
|
goto fail;
|
|
}
|
|
}
|
|
|
|
DEVICE_LISTENER_CALL(realize, Forward, dev);
|
|
|
|
/*
|
|
* always free/re-initialize here since the value cannot be cleaned up
|
|
* in device_unrealize due to its usage later on in the unplug path
|
|
*/
|
|
g_free(dev->canonical_path);
|
|
dev->canonical_path = object_get_canonical_path(OBJECT(dev));
|
|
QLIST_FOREACH(ncl, &dev->clocks, node) {
|
|
if (ncl->alias) {
|
|
continue;
|
|
} else {
|
|
clock_setup_canonical_path(ncl->clock);
|
|
}
|
|
}
|
|
|
|
if (qdev_get_vmsd(dev)) {
|
|
if (vmstate_register_with_alias_id(VMSTATE_IF(dev),
|
|
VMSTATE_INSTANCE_ID_ANY,
|
|
qdev_get_vmsd(dev), dev,
|
|
dev->instance_id_alias,
|
|
dev->alias_required_for_version,
|
|
&local_err) < 0) {
|
|
goto post_realize_fail;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Clear the reset state, in case the object was previously unrealized
|
|
* with a dirty state.
|
|
*/
|
|
resettable_state_clear(&dev->reset);
|
|
|
|
QLIST_FOREACH(bus, &dev->child_bus, sibling) {
|
|
if (!qbus_realize(bus, errp)) {
|
|
goto child_realize_fail;
|
|
}
|
|
}
|
|
if (dev->hotplugged) {
|
|
/*
|
|
* Reset the device, as well as its subtree which, at this point,
|
|
* should be realized too.
|
|
*/
|
|
resettable_assert_reset(OBJECT(dev), RESET_TYPE_COLD);
|
|
resettable_change_parent(OBJECT(dev), OBJECT(dev->parent_bus),
|
|
NULL);
|
|
resettable_release_reset(OBJECT(dev), RESET_TYPE_COLD);
|
|
}
|
|
dev->pending_deleted_event = false;
|
|
|
|
if (hotplug_ctrl) {
|
|
hotplug_handler_plug(hotplug_ctrl, dev, &local_err);
|
|
if (local_err != NULL) {
|
|
goto child_realize_fail;
|
|
}
|
|
}
|
|
|
|
} else if (!value && dev->realized) {
|
|
QLIST_FOREACH(bus, &dev->child_bus, sibling) {
|
|
qbus_unrealize(bus);
|
|
}
|
|
if (qdev_get_vmsd(dev)) {
|
|
vmstate_unregister(VMSTATE_IF(dev), qdev_get_vmsd(dev), dev);
|
|
}
|
|
if (dc->unrealize) {
|
|
dc->unrealize(dev);
|
|
}
|
|
dev->pending_deleted_event = true;
|
|
DEVICE_LISTENER_CALL(unrealize, Reverse, dev);
|
|
}
|
|
|
|
assert(local_err == NULL);
|
|
dev->realized = value;
|
|
return;
|
|
|
|
child_realize_fail:
|
|
QLIST_FOREACH(bus, &dev->child_bus, sibling) {
|
|
qbus_unrealize(bus);
|
|
}
|
|
|
|
if (qdev_get_vmsd(dev)) {
|
|
vmstate_unregister(VMSTATE_IF(dev), qdev_get_vmsd(dev), dev);
|
|
}
|
|
|
|
post_realize_fail:
|
|
g_free(dev->canonical_path);
|
|
dev->canonical_path = NULL;
|
|
if (dc->unrealize) {
|
|
dc->unrealize(dev);
|
|
}
|
|
|
|
fail:
|
|
error_propagate(errp, local_err);
|
|
if (unattached_parent) {
|
|
/*
|
|
* Beware, this doesn't just revert
|
|
* object_property_add_child(), it also runs bus_remove()!
|
|
*/
|
|
object_unparent(OBJECT(dev));
|
|
unattached_count--;
|
|
}
|
|
}
|
|
|
|
static bool device_get_hotpluggable(Object *obj, Error **errp)
|
|
{
|
|
DeviceClass *dc = DEVICE_GET_CLASS(obj);
|
|
DeviceState *dev = DEVICE(obj);
|
|
|
|
return dc->hotpluggable && (dev->parent_bus == NULL ||
|
|
qbus_is_hotpluggable(dev->parent_bus));
|
|
}
|
|
|
|
static bool device_get_hotplugged(Object *obj, Error **errp)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
|
|
return dev->hotplugged;
|
|
}
|
|
|
|
static void device_initfn(Object *obj)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
|
|
if (qdev_hotplug) {
|
|
dev->hotplugged = 1;
|
|
qdev_hot_added = true;
|
|
}
|
|
|
|
dev->instance_id_alias = -1;
|
|
dev->realized = false;
|
|
dev->allow_unplug_during_migration = false;
|
|
|
|
QLIST_INIT(&dev->gpios);
|
|
QLIST_INIT(&dev->clocks);
|
|
}
|
|
|
|
static void device_post_init(Object *obj)
|
|
{
|
|
/*
|
|
* Note: ordered so that the user's global properties take
|
|
* precedence.
|
|
*/
|
|
object_apply_compat_props(obj);
|
|
qdev_prop_set_globals(DEVICE(obj));
|
|
}
|
|
|
|
/* Unlink device from bus and free the structure. */
|
|
static void device_finalize(Object *obj)
|
|
{
|
|
NamedGPIOList *ngl, *next;
|
|
|
|
DeviceState *dev = DEVICE(obj);
|
|
|
|
QLIST_FOREACH_SAFE(ngl, &dev->gpios, node, next) {
|
|
QLIST_REMOVE(ngl, node);
|
|
qemu_free_irqs(ngl->in, ngl->num_in);
|
|
g_free(ngl->name);
|
|
g_free(ngl);
|
|
/* ngl->out irqs are owned by the other end and should not be freed
|
|
* here
|
|
*/
|
|
}
|
|
|
|
qdev_finalize_clocklist(dev);
|
|
|
|
/* Only send event if the device had been completely realized */
|
|
if (dev->pending_deleted_event) {
|
|
g_assert(dev->canonical_path);
|
|
|
|
qapi_event_send_device_deleted(!!dev->id, dev->id, dev->canonical_path);
|
|
g_free(dev->canonical_path);
|
|
dev->canonical_path = NULL;
|
|
}
|
|
|
|
qemu_opts_del(dev->opts);
|
|
}
|
|
|
|
static void device_class_base_init(ObjectClass *class, void *data)
|
|
{
|
|
DeviceClass *klass = DEVICE_CLASS(class);
|
|
|
|
/* We explicitly look up properties in the superclasses,
|
|
* so do not propagate them to the subclasses.
|
|
*/
|
|
klass->props_ = NULL;
|
|
}
|
|
|
|
static void device_unparent(Object *obj)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
BusState *bus;
|
|
|
|
if (dev->realized) {
|
|
qdev_unrealize(dev);
|
|
}
|
|
while (dev->num_child_bus) {
|
|
bus = QLIST_FIRST(&dev->child_bus);
|
|
object_unparent(OBJECT(bus));
|
|
}
|
|
if (dev->parent_bus) {
|
|
bus_remove_child(dev->parent_bus, dev);
|
|
object_unref(OBJECT(dev->parent_bus));
|
|
dev->parent_bus = NULL;
|
|
}
|
|
}
|
|
|
|
static char *
|
|
device_vmstate_if_get_id(VMStateIf *obj)
|
|
{
|
|
DeviceState *dev = DEVICE(obj);
|
|
|
|
return qdev_get_dev_path(dev);
|
|
}
|
|
|
|
/**
|
|
* device_phases_reset:
|
|
* Transition reset method for devices to allow moving
|
|
* smoothly from legacy reset method to multi-phases
|
|
*/
|
|
static void device_phases_reset(DeviceState *dev)
|
|
{
|
|
ResettableClass *rc = RESETTABLE_GET_CLASS(dev);
|
|
|
|
if (rc->phases.enter) {
|
|
rc->phases.enter(OBJECT(dev), RESET_TYPE_COLD);
|
|
}
|
|
if (rc->phases.hold) {
|
|
rc->phases.hold(OBJECT(dev));
|
|
}
|
|
if (rc->phases.exit) {
|
|
rc->phases.exit(OBJECT(dev));
|
|
}
|
|
}
|
|
|
|
static void device_transitional_reset(Object *obj)
|
|
{
|
|
DeviceClass *dc = DEVICE_GET_CLASS(obj);
|
|
|
|
/*
|
|
* This will call either @device_phases_reset (for multi-phases transitioned
|
|
* devices) or a device's specific method for not-yet transitioned devices.
|
|
* In both case, it does not reset children.
|
|
*/
|
|
if (dc->reset) {
|
|
dc->reset(DEVICE(obj));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* device_get_transitional_reset:
|
|
* check if the device's class is ready for multi-phase
|
|
*/
|
|
static ResettableTrFunction device_get_transitional_reset(Object *obj)
|
|
{
|
|
DeviceClass *dc = DEVICE_GET_CLASS(obj);
|
|
if (dc->reset != device_phases_reset) {
|
|
/*
|
|
* dc->reset has been overridden by a subclass,
|
|
* the device is not ready for multi phase yet.
|
|
*/
|
|
return device_transitional_reset;
|
|
}
|
|
return NULL;
|
|
}
|
|
|
|
static void device_class_init(ObjectClass *class, void *data)
|
|
{
|
|
DeviceClass *dc = DEVICE_CLASS(class);
|
|
VMStateIfClass *vc = VMSTATE_IF_CLASS(class);
|
|
ResettableClass *rc = RESETTABLE_CLASS(class);
|
|
|
|
class->unparent = device_unparent;
|
|
|
|
/* by default all devices were considered as hotpluggable,
|
|
* so with intent to check it in generic qdev_unplug() /
|
|
* device_set_realized() functions make every device
|
|
* hotpluggable. Devices that shouldn't be hotpluggable,
|
|
* should override it in their class_init()
|
|
*/
|
|
dc->hotpluggable = true;
|
|
dc->user_creatable = true;
|
|
vc->get_id = device_vmstate_if_get_id;
|
|
rc->get_state = device_get_reset_state;
|
|
rc->child_foreach = device_reset_child_foreach;
|
|
|
|
/*
|
|
* @device_phases_reset is put as the default reset method below, allowing
|
|
* to do the multi-phase transition from base classes to leaf classes. It
|
|
* allows a legacy-reset Device class to extend a multi-phases-reset
|
|
* Device class for the following reason:
|
|
* + If a base class B has been moved to multi-phase, then it does not
|
|
* override this default reset method and may have defined phase methods.
|
|
* + A child class C (extending class B) which uses
|
|
* device_class_set_parent_reset() (or similar means) to override the
|
|
* reset method will still work as expected. @device_phases_reset function
|
|
* will be registered as the parent reset method and effectively call
|
|
* parent reset phases.
|
|
*/
|
|
dc->reset = device_phases_reset;
|
|
rc->get_transitional_function = device_get_transitional_reset;
|
|
|
|
object_class_property_add_bool(class, "realized",
|
|
device_get_realized, device_set_realized);
|
|
object_class_property_add_bool(class, "hotpluggable",
|
|
device_get_hotpluggable, NULL);
|
|
object_class_property_add_bool(class, "hotplugged",
|
|
device_get_hotplugged, NULL);
|
|
object_class_property_add_link(class, "parent_bus", TYPE_BUS,
|
|
offsetof(DeviceState, parent_bus), NULL, 0);
|
|
}
|
|
|
|
void device_class_set_props(DeviceClass *dc, Property *props)
|
|
{
|
|
Property *prop;
|
|
|
|
dc->props_ = props;
|
|
for (prop = props; prop && prop->name; prop++) {
|
|
qdev_class_add_legacy_property(dc, prop);
|
|
qdev_class_add_property(dc, prop);
|
|
}
|
|
}
|
|
|
|
void device_class_set_parent_reset(DeviceClass *dc,
|
|
DeviceReset dev_reset,
|
|
DeviceReset *parent_reset)
|
|
{
|
|
*parent_reset = dc->reset;
|
|
dc->reset = dev_reset;
|
|
}
|
|
|
|
void device_class_set_parent_realize(DeviceClass *dc,
|
|
DeviceRealize dev_realize,
|
|
DeviceRealize *parent_realize)
|
|
{
|
|
*parent_realize = dc->realize;
|
|
dc->realize = dev_realize;
|
|
}
|
|
|
|
void device_class_set_parent_unrealize(DeviceClass *dc,
|
|
DeviceUnrealize dev_unrealize,
|
|
DeviceUnrealize *parent_unrealize)
|
|
{
|
|
*parent_unrealize = dc->unrealize;
|
|
dc->unrealize = dev_unrealize;
|
|
}
|
|
|
|
void device_legacy_reset(DeviceState *dev)
|
|
{
|
|
DeviceClass *klass = DEVICE_GET_CLASS(dev);
|
|
|
|
trace_qdev_reset(dev, object_get_typename(OBJECT(dev)));
|
|
if (klass->reset) {
|
|
klass->reset(dev);
|
|
}
|
|
}
|
|
|
|
Object *qdev_get_machine(void)
|
|
{
|
|
static Object *dev;
|
|
|
|
if (dev == NULL) {
|
|
dev = container_get(object_get_root(), "/machine");
|
|
}
|
|
|
|
return dev;
|
|
}
|
|
|
|
static const TypeInfo device_type_info = {
|
|
.name = TYPE_DEVICE,
|
|
.parent = TYPE_OBJECT,
|
|
.instance_size = sizeof(DeviceState),
|
|
.instance_init = device_initfn,
|
|
.instance_post_init = device_post_init,
|
|
.instance_finalize = device_finalize,
|
|
.class_base_init = device_class_base_init,
|
|
.class_init = device_class_init,
|
|
.abstract = true,
|
|
.class_size = sizeof(DeviceClass),
|
|
.interfaces = (InterfaceInfo[]) {
|
|
{ TYPE_VMSTATE_IF },
|
|
{ TYPE_RESETTABLE_INTERFACE },
|
|
{ }
|
|
}
|
|
};
|
|
|
|
static void qdev_register_types(void)
|
|
{
|
|
type_register_static(&device_type_info);
|
|
}
|
|
|
|
type_init(qdev_register_types)
|