X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=qm.adoc;h=0a1dfa6e23af2e0d0e676ea3ce92495514fd9344;hb=5e8c820206f905a27c585197994813c03b72e4da;hp=468e3729743e9ae1e84c1b1b778b90ff0913e47d;hpb=55ce3375092431c754ec63533179a1be4bc51850;p=pve-docs.git diff --git a/qm.adoc b/qm.adoc index 468e372..0a1dfa6 100644 --- a/qm.adoc +++ b/qm.adoc @@ -126,8 +126,8 @@ BIOS clock to have the UTC time. System Settings ~~~~~~~~~~~~~~~ -On VM creation you can change the type some basic system components of the new -VM. You can specify which xref:qm_display[display type] you want to use. +On VM creation you can change some basic system components of the new VM. You +can specify which xref:qm_display[display type] you want to use. [thumbnail="screenshot/gui-create-vm-system.png"] Additionally, the xref:qm_hard_disk[SCSI controller] can be changed. If you plan to install the QEMU Guest Agent, or if your selected ISO image @@ -221,10 +221,10 @@ set and a _TRIM_-enabled guest OS footnote:[TRIM, UNMAP, and discard https://en.wikipedia.org/wiki/Trim_%28computing%29], when the VM's filesystem marks blocks as unused after deleting files, the controller will relay this information to the storage, which will then shrink the disk image accordingly. -For the guest to be able to issue _TRIM_ commands, you must either use a -*VirtIO SCSI* (or *VirtIO SCSI Single*) controller or set the *SSD emulation* -option on the drive. Note that *Discard* is not supported on *VirtIO Block* -drives. +For the guest to be able to issue _TRIM_ commands, you must enable the *Discard* +option on the drive. Some guest operating systems may also require the +*SSD Emulation* flag to be set. Note that *Discard* on *VirtIO Block* drives is +only supported on guests using Linux Kernel 5.0 or higher. If you would like a drive to be presented to the guest as a solid-state drive rather than a rotational hard disk, you can set the *SSD emulation* option on @@ -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 -audio0 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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1081,7 +1103,7 @@ include::qm-pci-passthrough.adoc[] endif::wiki[] Hookscripts -~~~~~~~~~~~ +----------- You can add a hook script to VMs with the config property `hookscript`.