qemu/qapi/qdev.json

9 # Device infrastructure (qdev)
16 # @device-list-properties:
18 # List properties associated with a device.
20 # @typename: the type name of a device
30 { 'command': 'device-list-properties',
37 # Add a device.
39 # @driver: the name of the new device's driver
41 # @bus: the device's parent bus (device tree path)
43 # @id: the device's ID, must be unique
47 # @json-cli: If present, the "-device" command line option supports
51 # @json-cli-hotplug: If present, the "-device" command line option
60 #        the 'docs/qdev-device-use.txt' file.
62 #     3. It's possible to list device properties by running QEMU with
63 #        the ``-device DEVICE,help`` command-line argument, where
64 #        DEVICE is the device's name.
89 # Remove a device from a guest
91 # @id: the device's ID or QOM path
94 #     - If @id is not a valid device, DeviceNotFound
96 # .. note:: When this command completes, the device may not be removed
99 #    the hot removal process.  Completion of the device removal
103 #    device will not be removed and a `DEVICE_UNPLUG_GUEST_ERROR` event
117 #          "arguments": { "id": "/machine/peripheral-anon/device[0]" } }
125 # Emitted whenever the device removal completion is acknowledged by
126 # the guest.  At this point, it's safe to reuse the specified device
127 # ID.  Device removal can be initiated by the guest or by HMP/QMP
130 # @device: the device's ID if it has one
132 # @path: the device's QOM path
139 #          "data": { "device": "virtio-net-pci-0",
144   'data': { '*device': 'str', 'path': 'str' } }
149 # Emitted when a device hot unplug fails due to a guest reported
152 # @device: the device's ID if it has one
154 # @path: the device's QOM path
161 #          "data": { "device": "core1",
166   'data': { '*device': 'str', 'path': 'str' } }
169 # @device-sync-config:
171 # Synchronize device configuration from host to guest part.  First,
173 # part (frontend).  Then notify guest software that device
176 # The command may be used to notify the guest about block device
177 # capacity change.  Currently only vhost-user-blk device supports
180 # @id: the device's ID or QOM path
188 { 'command': 'device-sync-config',