X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=qm.conf.5-opts.adoc;h=65cccb68de02116b42505ad00c83da0927b5f8de;hb=776d32bda37d50c30f7fb822952c2267c20493fa;hp=8f27ed0f33be71ca61fc021752de309a81e378b9;hpb=013dc89ffce47b8c55412c016a508205768b4fd6;p=pve-docs.git diff --git a/qm.conf.5-opts.adoc b/qm.conf.5-opts.adoc index 8f27ed0..65cccb6 100644 --- a/qm.conf.5-opts.adoc +++ b/qm.conf.5-opts.adoc @@ -46,7 +46,7 @@ The number of cores per socket. Emulated CPU type. -`cputype`=`<486 | Broadwell | Broadwell-noTSX | Conroe | Haswell | Haswell-noTSX | IvyBridge | Nehalem | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | Westmere | athlon | core2duo | coreduo | host | kvm32 | kvm64 | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);; +`cputype`=`<486 | Broadwell | Broadwell-noTSX | Conroe | Haswell | Haswell-noTSX | IvyBridge | Nehalem | Opteron_G1 | Opteron_G2 | Opteron_G3 | Opteron_G4 | Opteron_G5 | Penryn | SandyBridge | Skylake-Client | Westmere | athlon | core2duo | coreduo | host | kvm32 | kvm64 | pentium | pentium2 | pentium3 | phenom | qemu32 | qemu64>` ('default =' `kvm64`);; Emulated CPU type. @@ -90,7 +90,7 @@ Disk size. This is purely informational and has no effect. Freeze CPU at startup (use 'c' monitor command to start execution). -`hostpci[n]`: `[host=] [,pcie=<1|0>] [,rombar=<1|0>] [,x-vga=<1|0>]` :: +`hostpci[n]`: `[host=] [,pcie=<1|0>] [,rombar=<1|0>] [,romfile=] [,x-vga=<1|0>]` :: Map host PCI devices into guest. + @@ -116,6 +116,10 @@ Choose the PCI-express bus (needs the 'q35' machine model). Specify whether or not the device's ROM will be visible in the guest's memory map. +`romfile`=`` ;; + +Custom pci device rom filename (must be located in /usr/share/kvm/). + `x-vga`=`` ('default =' `0`);; Enable vfio-vga device support. @@ -128,7 +132,7 @@ Selectively enable hotplug features. This is a comma separated list of hotplug f Enable/disable hugepages memory. -`ide[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_length=] [,bps_wr=] [,bps_wr_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_length=] [,iops_rd_max=] [,iops_wr=] [,iops_wr_length=] [,iops_wr_max=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,model=] [,rerror=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: +`ide[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,model=] [,replicate=<1|0>] [,rerror=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: Use volume as IDE hard disk or CD-ROM (n is 0 to 3). @@ -152,7 +156,7 @@ Maximum length of I/O bursts in seconds. Maximum read speed in bytes per second. -`bps_rd_length`=`` ;; +`bps_rd_max_length`=`` ;; Maximum length of read I/O bursts in seconds. @@ -160,7 +164,7 @@ Maximum length of read I/O bursts in seconds. Maximum write speed in bytes per second. -`bps_wr_length`=`` ;; +`bps_wr_max_length`=`` ;; Maximum length of write I/O bursts in seconds. @@ -208,26 +212,26 @@ Maximum length of I/O bursts in seconds. Maximum read I/O in operations per second. -`iops_rd_length`=`` ;; - -Maximum length of read I/O bursts in seconds. - `iops_rd_max`=`` ;; Maximum unthrottled read I/O pool in operations per second. -`iops_wr`=`` ;; +`iops_rd_max_length`=`` ;; -Maximum write I/O in operations per second. +Maximum length of read I/O bursts in seconds. -`iops_wr_length`=`` ;; +`iops_wr`=`` ;; -Maximum length of write I/O bursts in seconds. +Maximum write I/O in operations per second. `iops_wr_max`=`` ;; Maximum unthrottled write I/O pool in operations per second. +`iops_wr_max_length`=`` ;; + +Maximum length of write I/O bursts in seconds. + `mbps`=`` ;; Maximum r/w speed in megabytes per second. @@ -260,6 +264,10 @@ The drive's media type. The drive's reported model name, url-encoded, up to 40 bytes long. +`replicate`=`` ('default =' `1`);; + +Whether the drive should considered for replication jobs. + `rerror`=`` ;; Read error action. @@ -403,7 +411,7 @@ NUMA allocation policy. Specifies whether a VM will be started during system bootup. -`ostype`: `` :: +`ostype`: `` :: Specify guest operating system. This is used to enable special optimization/features for specific operating systems: @@ -437,7 +445,7 @@ Sets the protection flag of the VM. This will disable the remove VM and remove d Allow reboot. If set to '0' the VM exit on reboot. -`sata[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_length=] [,bps_wr=] [,bps_wr_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_length=] [,iops_rd_max=] [,iops_wr=] [,iops_wr_length=] [,iops_wr_max=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,rerror=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: +`sata[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,replicate=<1|0>] [,rerror=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: Use volume as SATA hard disk or CD-ROM (n is 0 to 5). @@ -461,7 +469,7 @@ Maximum length of I/O bursts in seconds. Maximum read speed in bytes per second. -`bps_rd_length`=`` ;; +`bps_rd_max_length`=`` ;; Maximum length of read I/O bursts in seconds. @@ -469,7 +477,7 @@ Maximum length of read I/O bursts in seconds. Maximum write speed in bytes per second. -`bps_wr_length`=`` ;; +`bps_wr_max_length`=`` ;; Maximum length of write I/O bursts in seconds. @@ -517,26 +525,26 @@ Maximum length of I/O bursts in seconds. Maximum read I/O in operations per second. -`iops_rd_length`=`` ;; - -Maximum length of read I/O bursts in seconds. - `iops_rd_max`=`` ;; Maximum unthrottled read I/O pool in operations per second. -`iops_wr`=`` ;; +`iops_rd_max_length`=`` ;; -Maximum write I/O in operations per second. +Maximum length of read I/O bursts in seconds. -`iops_wr_length`=`` ;; +`iops_wr`=`` ;; -Maximum length of write I/O bursts in seconds. +Maximum write I/O in operations per second. `iops_wr_max`=`` ;; Maximum unthrottled write I/O pool in operations per second. +`iops_wr_max_length`=`` ;; + +Maximum length of write I/O bursts in seconds. + `mbps`=`` ;; Maximum r/w speed in megabytes per second. @@ -565,6 +573,10 @@ Maximum unthrottled write pool in megabytes per second. The drive's media type. +`replicate`=`` ('default =' `1`);; + +Whether the drive should considered for replication jobs. + `rerror`=`` ;; Read error action. @@ -593,7 +605,7 @@ Force disk geometry bios translation mode. Write error action. -`scsi[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_length=] [,bps_wr=] [,bps_wr_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_length=] [,iops_rd_max=] [,iops_wr=] [,iops_wr_length=] [,iops_wr_max=] [,iothread=<1|0>] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,queues=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: +`scsi[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,iothread=<1|0>] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,queues=] [,replicate=<1|0>] [,rerror=] [,scsiblock=<1|0>] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: Use volume as SCSI hard disk or CD-ROM (n is 0 to 13). @@ -617,7 +629,7 @@ Maximum length of I/O bursts in seconds. Maximum read speed in bytes per second. -`bps_rd_length`=`` ;; +`bps_rd_max_length`=`` ;; Maximum length of read I/O bursts in seconds. @@ -625,7 +637,7 @@ Maximum length of read I/O bursts in seconds. Maximum write speed in bytes per second. -`bps_wr_length`=`` ;; +`bps_wr_max_length`=`` ;; Maximum length of write I/O bursts in seconds. @@ -673,26 +685,26 @@ Maximum length of I/O bursts in seconds. Maximum read I/O in operations per second. -`iops_rd_length`=`` ;; - -Maximum length of read I/O bursts in seconds. - `iops_rd_max`=`` ;; Maximum unthrottled read I/O pool in operations per second. -`iops_wr`=`` ;; +`iops_rd_max_length`=`` ;; -Maximum write I/O in operations per second. +Maximum length of read I/O bursts in seconds. -`iops_wr_length`=`` ;; +`iops_wr`=`` ;; -Maximum length of write I/O bursts in seconds. +Maximum write I/O in operations per second. `iops_wr_max`=`` ;; Maximum unthrottled write I/O pool in operations per second. +`iops_wr_max_length`=`` ;; + +Maximum length of write I/O bursts in seconds. + `iothread`=`` ;; Whether to use iothreads for this drive @@ -729,6 +741,20 @@ The drive's media type. Number of queues. +`replicate`=`` ('default =' `1`);; + +Whether the drive should considered for replication jobs. + +`rerror`=`` ;; + +Read error action. + +`scsiblock`=`` ('default =' `0`);; + +whether to use scsi-block for full passthrough of host block device ++ +WARNING: can lead to I/O errors in combination with low memory or high memory fragmentation on host + `secs`=`` ;; Force the drive's physical geometry to have a specific sector count. @@ -865,7 +891,7 @@ Number of hotplugged vcpus. 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. -`virtio[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_length=] [,bps_wr=] [,bps_wr_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_length=] [,iops_rd_max=] [,iops_wr=] [,iops_wr_length=] [,iops_wr_max=] [,iothread=<1|0>] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,rerror=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: +`virtio[n]`: `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_max_length=] [,bps_rd=] [,bps_rd_max_length=] [,bps_wr=] [,bps_wr_max_length=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_max_length=] [,iops_rd=] [,iops_rd_max=] [,iops_rd_max_length=] [,iops_wr=] [,iops_wr_max=] [,iops_wr_max_length=] [,iothread=<1|0>] [,mbps=] [,mbps_max=] [,mbps_rd=] [,mbps_rd_max=] [,mbps_wr=] [,mbps_wr_max=] [,media=] [,replicate=<1|0>] [,rerror=] [,secs=] [,serial=] [,size=] [,snapshot=<1|0>] [,trans=] [,werror=]` :: Use volume as VIRTIO hard disk (n is 0 to 15). @@ -889,7 +915,7 @@ Maximum length of I/O bursts in seconds. Maximum read speed in bytes per second. -`bps_rd_length`=`` ;; +`bps_rd_max_length`=`` ;; Maximum length of read I/O bursts in seconds. @@ -897,7 +923,7 @@ Maximum length of read I/O bursts in seconds. Maximum write speed in bytes per second. -`bps_wr_length`=`` ;; +`bps_wr_max_length`=`` ;; Maximum length of write I/O bursts in seconds. @@ -945,26 +971,26 @@ Maximum length of I/O bursts in seconds. Maximum read I/O in operations per second. -`iops_rd_length`=`` ;; - -Maximum length of read I/O bursts in seconds. - `iops_rd_max`=`` ;; Maximum unthrottled read I/O pool in operations per second. -`iops_wr`=`` ;; +`iops_rd_max_length`=`` ;; -Maximum write I/O in operations per second. +Maximum length of read I/O bursts in seconds. -`iops_wr_length`=`` ;; +`iops_wr`=`` ;; -Maximum length of write I/O bursts in seconds. +Maximum write I/O in operations per second. `iops_wr_max`=`` ;; Maximum unthrottled write I/O pool in operations per second. +`iops_wr_max_length`=`` ;; + +Maximum length of write I/O bursts in seconds. + `iothread`=`` ;; Whether to use iothreads for this drive @@ -997,6 +1023,10 @@ Maximum unthrottled write pool in megabytes per second. The drive's media type. +`replicate`=`` ('default =' `1`);; + +Whether the drive should considered for replication jobs. + `rerror`=`` ;; Read error action.