]> git.proxmox.com Git - pve-docs.git/blobdiff - qm.conf.5-opts.adoc
make update-static
[pve-docs.git] / qm.conf.5-opts.adoc
index df598afd739fa12acb14e363e4758587e474b26c..1e28f21d6060a6e466877d18d1dca4bca600eb45 100644 (file)
@@ -2,10 +2,18 @@
 
 Enable/disable ACPI.
 
-`agent`: `<boolean>` ('default =' `0`)::
+`agent`: `[enabled=]<1|0> [,fstrim_cloned_disks=<1|0>]` ::
+
+Enable/disable Qemu GuestAgent and its properties.
+
+`enabled`=`<boolean>` ('default =' `0`);;
 
 Enable/disable Qemu GuestAgent.
 
+`fstrim_cloned_disks`=`<boolean>` ('default =' `0`);;
+
+Run fstrim after cloning/moving a disk.
+
 `args`: `<string>` ::
 
 Arbitrary arguments passed to kvm, for example:
@@ -64,7 +72,7 @@ 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'.
+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'.
 
 `hidden`=`<boolean>` ('default =' `0`);;
 
@@ -365,7 +373,7 @@ Lock/unlock the VM.
 
 `machine`: `(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?)` ::
 
-Specific the Qemu machine type.
+Specifies the Qemu machine type.
 
 `memory`: `<integer> (16 - N)` ('default =' `512`)::
 
@@ -963,7 +971,7 @@ Specifies whether if given host option is a USB3 device or port (this does curre
 
 Number of hotplugged vcpus.
 
-`vga`: `<cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | vmware>` ::
+`vga`: `<cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | virtio | vmware>` ::
 
 Select the VGA type. If you want to use high resolution modes (>= 1280x1024x16) then you should use the options 'std' or 'vmware'. Default is 'std' for win8/win7/w2k8, and 'cirrus' for other OS types. The 'qxl' option enables the SPICE display sever. For win* OS you can select how many independent displays you want, Linux guests can add displays them self. You can also run without any graphic card, using a serial device as terminal.
 
@@ -1137,6 +1145,11 @@ Force disk geometry bios translation mode.
 
 Write error action.
 
+`vmgenid`: `<UUID>` ('default =' `1 (autogenerated)`)::
+
+The VM generation ID (vmgenid) device exposes a 128-bit integer value identifier to the guest OS. This allows to notify the guest operating system when the virtual machine is executed with a different configuration (e.g. snapshot execution or creation from a template). The guest operating system notices the change, and is then able to react as appropriate by marking its copies of distributed databases as dirty, re-initializing its random number generator, etc.
+Note that auto-creation only works when done throug API/CLI create or update methods, but not when manually editing the config file.
+
 `vmstatestorage`: `<string>` ::
 
 Default storage for VM state volumes/files.