Re: [libvirt] [PATCH 2/2] docs: Document configuration quirks for virtio devices

Some devices (namely virtio-scsi, virtio-gpu, virtio-keyboard, virtio-tablet and virtio-mouse, plus virtio-crypto which is not supported by libvirt) don't follow the same rules as all other virtio devices, which is something that ought to be documented. Signed-off-by: Andrea Bolognani <abologna(a)redhat.com&gt; --- docs/formatdomain.html.in | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index eb00c01d96..a9a8cfcd46 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -4132,6 +4132,24 @@ </dd> </dl> + <p> + While the information outlined above apply to most virtio devices,

+ there are a few exceptions: + </p> + + <ul> + <li> + for SCSI controllers, <code>virtio-scsi</code> must be used instead + of <code>virtio</code> for backwards compatibility reasons; + </li> + <li> + some devices, such as GPUs and input devices (keyboard, tablet and + mouse), are only defined in the virtio 1.0 spec and as such don't + have a transitional variant: the only accepted model is + <code>virtio</code>, which will result in a non-transitional device. + </li> + </ul> + <p> For more details see the <a href="https://lists.gnu.org/archive/html/qemu-devel/2018-12/msg00923... patch posting</a> and the