mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-12-22 21:55:25 +00:00
docs: formatdomain: document <audio> element
Document the new <audio> element which allows to specify host audio backend for a guest <sound> device, and update the <sound> element description with the new <audio> sub-element which specifies the other end of the mapping. Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
parent
26a13ec469
commit
a7292e07df
@ -6572,6 +6572,55 @@ Valid values are:
|
|||||||
Each ``sound`` element has an optional sub-element ``<address>`` which can tie
|
Each ``sound`` element has an optional sub-element ``<address>`` which can tie
|
||||||
the device to a particular PCI slot, `documented above <#elementsAddress>`__.
|
the device to a particular PCI slot, `documented above <#elementsAddress>`__.
|
||||||
|
|
||||||
|
:since:`Since 6.7.0`, a sound device could be optionally mapped to the specific
|
||||||
|
host audio backend using the ``<audio>`` sub-element:
|
||||||
|
|
||||||
|
::
|
||||||
|
|
||||||
|
...
|
||||||
|
<devices>
|
||||||
|
<sound model='ich7'>
|
||||||
|
<audio id='1'>
|
||||||
|
</sound>
|
||||||
|
</devices>
|
||||||
|
...
|
||||||
|
|
||||||
|
Where ``1`` is an id of the `audio device <#elementsAudio>`__.
|
||||||
|
This is supported for bhyve only.
|
||||||
|
|
||||||
|
:anchor:`<a id="elementsAudio"/>`
|
||||||
|
|
||||||
|
Audio devices
|
||||||
|
~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
A virtual audio device corresponds to a host audio backend that is mapped
|
||||||
|
to the guest sound device. :since:`Since 6.7.0, bhyve only`
|
||||||
|
|
||||||
|
``type``
|
||||||
|
The required ``type`` attribute specifies audio backend type.
|
||||||
|
Currently, the only supported value is 'oss'.
|
||||||
|
|
||||||
|
``id``
|
||||||
|
Integer id of the audio device. Must be greater than 0.
|
||||||
|
|
||||||
|
The 'oss' audio type supports additional configuration:
|
||||||
|
|
||||||
|
::
|
||||||
|
|
||||||
|
...
|
||||||
|
<devices>
|
||||||
|
<audio type='oss' id='1'>
|
||||||
|
<input dev='/dev/dsp0'/>
|
||||||
|
<output dev='/dev/dsp0'/>
|
||||||
|
</audio>
|
||||||
|
</devices>
|
||||||
|
|
||||||
|
``input``
|
||||||
|
Input device. The required ``dev`` attribute specifies device path.
|
||||||
|
|
||||||
|
``output``
|
||||||
|
Output device. The required ``dev`` attribute specifies device path.
|
||||||
|
|
||||||
:anchor:`<a id="elementsWatchdog"/>`
|
:anchor:`<a id="elementsWatchdog"/>`
|
||||||
|
|
||||||
Watchdog device
|
Watchdog device
|
||||||
|
Loading…
Reference in New Issue
Block a user