[libvirt] [PATCH] Add documentation for <sound> device XML format.

--- docs/formatdomain.html | 20 ++++++++++++++++++++ docs/formatdomain.html.in | 24 ++++++++++++++++++++++++ 2 files changed, 44 insertions(+), 0 deletions(-) diff --git a/docs/formatdomain.html b/docs/formatdomain.html index 17dc0cd..27e42ac 100644 --- a/docs/formatdomain.html +++ b/docs/formatdomain.html @@ -183,6 +183,8 @@ </li><li> <a href="#elementsCharUNIX">UNIX domain socket client/server</a> </li></ul> + </li><li> + <a href="#elementsSound">Sound devices</a> </li></ul> </li></ul> </li><li> @@ -916,6 +918,24 @@ qemu-kvm -net nic,model=? /dev/null &lt;target port="1"/&gt; &lt;/serial&gt; ...</pre> + <h4> + <a name="elementsSound" id="elementsSound">Sound devices</a> + </h4> + <p> + A virtual sound card can be attached to the host via the + <code>sound</code> element. <span class="since">Since 0.4.3</span> + </p> + <pre> + ... + &lt;sound model='es1370'/&gt; + ...</pre> + <dl><dt><code>sound</code></dt><dd> + The <code>sound</code> element has one mandatory attribute, + <code>model</code>, which specifies what real sound device is emulated. + Valid values are specific to the underlying hypervisor, though typical + choices are 'es1370', 'sb16', and 'ac97' + (<span class="since">'ac97' only since 0.6.0</span>) + </dd></dl> <h2> <a name="examples" id="examples">Example configs</a> </h2> diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index ee32354..4479a6e 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -886,6 +886,30 @@ qemu-kvm -net nic,model=? /dev/null &lt;/serial&gt; ...</pre> + + <h4><a name="elementsSound">Sound devices</a></h4> + + <p> + A virtual sound card can be attached to the host via the + <code>sound</code> element. <span class="since">Since 0.4.3</span> + </p> + + <pre> + ... + &lt;sound model='es1370'/&gt; + ...</pre> + + <dl> + <dt><code>sound</code></dt> + <dd> + The <code>sound</code> element has one mandatory attribute, + <code>model</code>, which specifies what real sound device is emulated. + Valid values are specific to the underlying hypervisor, though typical + choices are 'es1370', 'sb16', and 'ac97' + (<span class="since">'ac97' only since 0.6.0</span>) + </dd> + </dl> + <h2><a name="examples">Example configs</a></h2> <p> -- 1.6.2.2