X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;ds=sidebyside;f=qm.conf.5-opts.adoc;h=89def921f2368b6fbd6a6d4fffb09276f56666b0;hb=1c5325464b3b90a1a729f36638f528edc1692347;hp=4533d64fde2dbb32adf4533bcd04104a53d8a289;hpb=95895385d2d1a3e787270b91e5a59bcae654a1d3;p=pve-docs.git diff --git a/qm.conf.5-opts.adoc b/qm.conf.5-opts.adoc index 4533d64..89def92 100644 --- a/qm.conf.5-opts.adoc +++ b/qm.conf.5-opts.adoc @@ -26,6 +26,18 @@ args: -no-reboot -no-hpet + NOTE: this option is for experts only. +`audio0`: `device= [,driver=]` :: + +Configure a audio device, useful in combination with QXL/Spice. + +`device`=`` ;; + +Configure an audio device. + +`driver`=`` ('default =' `spice`);; + +Driver backend for the audio device. + `autostart`: `` ('default =' `0`):: Automatic restart after crash (currently ignored). @@ -86,13 +98,13 @@ The number of cores per socket. Emulated CPU type. -`cputype`=`<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Conroe | EPYC | EPYC-IBPB | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | IvyBridge | IvyBridge-IBRS | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | Skylake-Client | Skylake-Client-IBRS | Skylake-Server | Skylake-Server-IBRS | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);; +`cputype`=`<486 | Broadwell | Broadwell-IBRS | Broadwell-noTSX | Broadwell-noTSX-IBRS | Cascadelake-Server | Conroe | EPYC | EPYC-IBPB | Haswell | Haswell-IBRS | Haswell-noTSX | Haswell-noTSX-IBRS | IvyBridge | IvyBridge-IBRS | KnightsMill | Nehalem | Nehalem-IBRS | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | SandyBridge-IBRS | Skylake-Client | Skylake-Client-IBRS | Skylake-Server | Skylake-Server-IBRS | Westmere | Westmere-IBRS | athlon | core2duo | coreduo | host | kvm32 | kvm64 | max | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);; Emulated CPU type. `flags`=`<+FLAG[;-FLAG...]>` ;; -List of additional CPU flags separated by ';'. Use '+FLAG' to enable, '-FLAG' to disable a flag. Currently supported flags: 'pcid', 'spec-ctrl', 'ibpb', 'ssbd', 'virt-ssbd', 'amd-ssbd', 'amd-no-ssb', 'pdpe1gb'. +List of additional CPU flags separated by ';'. Use '+FLAG' to enable, '-FLAG' to disable a flag. Currently supported flags: pcid, spec-ctrl, ibpb, ssbd, virt-ssbd, amd-ssbd, amd-no-ssb, pdpe1gb, md-clear, hv-tlbflush, hv-evmcs, aes. `hidden`=`` ('default =' `0`);; @@ -144,14 +156,14 @@ Script that will be executed during various steps in the vms lifetime. Map host PCI devices into guest. + -NOTE: This option allows direct access to host hardware. So it is no longer +NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care. + CAUTION: Experimental! User reported problems with this option. `host`=`` ;; -Host PCI device pass through. The PCI ID of a host's PCI device or a list +Host PCI device pass through. The PCI ID of a host's PCI device or a list of PCI virtual functions of the host. HOSTPCIID syntax is: + 'bus:dev.func' (hexadecimal numbers) @@ -425,7 +437,7 @@ Set the real time clock to local time. This is enabled by default if ostype indi Lock/unlock the VM. -`machine`: `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)` :: +`machine`: `(pc|pc(-i440fx)?-\d+(\.\d+)+(\.pxe)?|q35|pc-q35-\d+(\.\d+)+(\.pxe)?|virt(?:-\d+(\.\d+)+)?)` :: Specifies the Qemu machine type. @@ -947,27 +959,31 @@ CAUTION: Experimental! User reported problems with this option. Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd. -`smbios1`: `[family=] [,manufacturer=] [,product=] [,serial=] [,sku=] [,uuid=] [,version=]` :: +`smbios1`: `[base64=<1|0>] [,family=] [,manufacturer=] [,product=] [,serial=] [,sku=] [,uuid=] [,version=]` :: Specify SMBIOS type 1 fields. -`family`=`` ;; +`base64`=`` ;; + +Flag to indicate that the SMBIOS values are base64 encoded + +`family`=`` ;; Set SMBIOS1 family string. -`manufacturer`=`` ;; +`manufacturer`=`` ;; Set SMBIOS1 manufacturer. -`product`=`` ;; +`product`=`` ;; Set SMBIOS1 product ID. -`serial`=`` ;; +`serial`=`` ;; Set SMBIOS1 serial number. -`sku`=`` ;; +`sku`=`` ;; Set SMBIOS1 SKU string. @@ -975,7 +991,7 @@ Set SMBIOS1 SKU string. Set SMBIOS1 UUID. -`version`=`` ;; +`version`=`` ;; Set SMBIOS1 version. @@ -987,6 +1003,18 @@ The number of CPUs. Please use option -sockets instead. The number of CPU sockets. +`spice_enhancements`: `[foldersharing=<1|0>] [,videostreaming=]` :: + +Configure additional enhancements for SPICE. + +`foldersharing`=`` ('default =' `0`);; + +Enable folder sharing via SPICE. Needs Spice-WebDAV daemon installed in the VM. + +`videostreaming`=`` ('default =' `off`);; + +Enable video streaming. Uses compression for detected video streams. + `sshkeys`: `` :: cloud-init: Setup public SSH keys (one key per line, OpenSSH format). @@ -1035,7 +1063,7 @@ The value 'spice' can be used to add a usb redirection devices for spice. `usb3`=`` ('default =' `0`);; -Specifies whether if given host option is a USB3 device or port (this does currently not work reliably with spice redirection and is then ignored). +Specifies whether if given host option is a USB3 device or port. `vcpus`: ` (1 - N)` ('default =' `0`)::