[pve-devel] [PATCH docs] Add audio device documentation

[Thomas Lamprecht]

On 7/19/19 3:02 PM, Aaron Lauterer wrote:
> Signed-off-by: Aaron Lauterer <a.lauterer at proxmox.com>
> ---
>  qm.adoc | 22 ++++++++++++++++++++++
>  1 file changed, 22 insertions(+)
> 
> diff --git a/qm.adoc b/qm.adoc
> index 81fd39e..d6a0228 100644
> --- a/qm.adoc
> +++ b/qm.adoc
> @@ -753,6 +753,28 @@ footnote:[Looking Glass: https://looking-glass.hostfission.com/] project,
>  which enables high performance, low-latency display mirroring between
>  host and guest.
>  
> +[[qm_audio_device]]
> +Audio Device
> +~~~~~~~~~~~~
> +
> +To add an audio device run the following command:
> +
> +----
> +qm set <vmid> -audio0 device=<device>
> +----
> +
> +Supported audio devices are:
> +
> +* `ich9-intel-hda`: Intel HD Audio Controller, emulates ICH9
> +* `intel-hda`: Intel HD Audio Controller, emulates ICH6
> +* `AC97`: Audio Codec '97, useful for older operating systems like Windows XP
> +
> +NOTE: The audio device works only in combination with SPICE. Remote protocols
> +like Microsoft's RDP have options to play sound. To use the physical audio
> +device of the host use device passthrough (see
> +xref:qm_pci_passthrough[PCI Passthrough] and
> +xref:qm_usb_passthrough[USB Passthrough]).
> +
>  [[qm_startup_and_shutdown]]
>  Automatic Start and Shutdown of Virtual Machines
>  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> 

Looks OK. I'd maybe also refer to the webGUI so that people know that this is
not CLI only, but I can add this after applying, if wanted...