[Spice-devel] [PATCH] Manual: add info about QEMU_AUDIO_DRV

[Jonathon Jongsma]

hramrach on IRC had an issue with audio not working. He was using
suse and his qemu defaulted to using the pulseaudio audio driver instead
of spice.  Explicitly setting the audio driver to spice using the
QEMU_AUDIO_DRV environment variable solved the problem. Add this tip to
the manual for others having the same issue in the future.
---
 docs/manual/manual.txt | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
index 9d394b6..3b097ba 100644
--- a/docs/manual/manual.txt
+++ b/docs/manual/manual.txt
@@ -257,6 +257,13 @@ communication with the client. The Spice option `disable-ticketing` is
 specifying that ticketing (simple authentication method) is not
 used. The virtio and chardev devices are required by the guest agent.
 
+The `-soundhw ac97` option provides a sound device for the guest to use for
+audio playback and recording. In order for spice audio to work to properly,
+qemu must use the 'spice' audio driver. Depending on how qemu was built,
+however, this might not be the default audio driver. To ensure qemu uses the
+spice audio driver, you can set the environment variable
+`QEMU_AUDIO_DRV=spice`.
+
 Basic configuration
 -------------------
 
-- 
2.7.4