X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=qm.1-synopsis.adoc;fp=qm.1-synopsis.adoc;h=eb2119effc3bc03d886e59e55a9aeeb552a9ca71;hp=973ed8f3b26121d20c25ce46ca662f7707cc998d;hb=c2993fe56c757a6b53001af4b2af6517ef598f1e;hpb=37638f5933abbe3e521b2fdeb20f52f717d75750 diff --git a/qm.1-synopsis.adoc b/qm.1-synopsis.adoc index 973ed8f..eb2119e 100644 --- a/qm.1-synopsis.adoc +++ b/qm.1-synopsis.adoc @@ -24,8 +24,7 @@ NOTE: Requires option(s): `full` `-full` `boolean` (default=`0`):: -Create a full copy of all disk. This is always done when you clone a normal -VM. For VM templates, we try to create a linked clone by default. +Create a full copy of all disk. This is always done when you clone a normal VM. For VM templates, we try to create a linked clone by default. `-name` `string` :: @@ -88,11 +87,7 @@ The backup file. `-args` `string` :: -Arbitrary arguments passed to kvm, for example: -+ -args: -no-reboot -no-hpet -+ -NOTE: this option is for experts only. +Arbitrary arguments passed to kvm. `-autostart` `boolean` (default=`0`):: @@ -100,8 +95,7 @@ Automatic restart after crash (currently ignored). `-balloon` `integer (0 - N)` :: -Amount of target RAM for the VM in MB. Using zero disables the ballon -driver. +Amount of target RAM for the VM in MB. Using zero disables the ballon driver. `-bios` `(ovmf | seabios)` (default=`seabios`):: @@ -130,22 +124,14 @@ Emulated CPU type. `-cpulimit` `number (0 - 128)` (default=`0`):: Limit of CPU usage. -+ -NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' -indicates no CPU limit. `-cpuunits` `integer (0 - 500000)` (default=`1000`):: -CPU weight for a VM. Argument is used in the kernel fair scheduler. The -larger the number is, the more CPU time this VM gets. Number is relative to -weights of all the other running VMs. -+ -NOTE: You can disable fair-scheduler configuration by setting this to 0. +CPU weight for a VM. `-description` `string` :: -Description for the VM. Only used on the configuration web interface. This -is saved as comment inside the configuration file. +Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file. `-force` `boolean` :: @@ -159,26 +145,11 @@ Freeze CPU at startup (use 'c' monitor command to start execution). `-hostpci[n]` `[host=] [,pcie=<1|0>] [,rombar=<1|0>] [,x-vga=<1|0>]` :: -Map host pci devices. HOSTPCIDEVICE syntax is: -+ -'bus:dev.func' (hexadecimal numbers) -+ -You can us the 'lspci' command to list existing pci devices. -+ -The 'rombar' option determines whether or not the device's ROM will be -visible in the guest's memory map (default is 'on'). -+ -NOTE: This option allows direct access to host hardware. So it is no longer -possible to migrate such machines - use with special care. -+ -Experimental: user reported problems with this option. +Map host PCI devices into guest. `-hotplug` `string` (default=`network,disk,usb`):: -Selectively enable hotplug features. This is a comma separated list of -hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to -disable hotplug completely. Value '1' is an alias for the default -'network,disk,usb'. +Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'. `-ide[n]` `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_rd=] [,bps_wr=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_rd=] [,iops_rd_max=] [,iops_wr=] [,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=]` :: @@ -186,8 +157,7 @@ Use volume as IDE hard disk or CD-ROM (n is 0 to 3). `-keyboard` `(da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr)` (default=`en-us`):: -Keybord layout for vnc server. Default is read from the datacenter -configuration file. +Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.conf' configuration file. `-kvm` `boolean` (default=`1`):: @@ -195,8 +165,7 @@ Enable/disable KVM hardware virtualization. `-localtime` `boolean` :: -Set the real time clock to local time. This is enabled by default if ostype -indicates a Microsoft OS. +Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS. `-lock` `(backup | migrate | rollback | snapshot)` :: @@ -208,8 +177,7 @@ Specific the Qemu machine type. `-memory` `integer (16 - N)` (default=`512`):: -Amount of RAM for the VM in MB. This is the maximum available memory when -you use the balloon device. +Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device. `-migrate_downtime` `number (0 - N)` (default=`0.1`):: @@ -226,28 +194,6 @@ Set a name for the VM. Only used on the configuration web interface. `-net[n]` `[model=] [,bridge=] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=] [,queues=] [,rate=] [,tag=] [,trunks=] [,=]` :: Specify network devices. -+ -MODEL is one of: e1000 e1000-82540em e1000-82544gc e1000-82545em i82551 -i82557b i82559er ne2k_isa ne2k_pci pcnet rtl8139 virtio vmxnet3 -+ -XX:XX:XX:XX:XX:XX should be an unique MAC address. This is -automatically generated if not specified. -+ -The bridge parameter can be used to automatically add the interface to a -bridge device. The Proxmox VE standard bridge is called 'vmbr0'. -+ -Option 'rate' is used to limit traffic bandwidth from and to this -interface. It is specified as floating point number, unit is 'Megabytes per -second'. -+ -If you specify no bridge, we create a kvm 'user' (NATed) network device, -which provides DHCP and DNS services. The following addresses are used: -+ -10.0.2.2 Gateway -10.0.2.3 DNS Server -10.0.2.4 SMB Server -+ -The DHCP server assign addresses to the guest starting from 10.0.2.15. `-numa` `boolean` (default=`0`):: @@ -255,7 +201,7 @@ Enable/disable NUMA. `-numa[n]` `cpus= [,hostnodes=] [,memory=] [,policy=]` :: -numa topology +NUMA topology. `-onboot` `boolean` (default=`0`):: @@ -263,32 +209,11 @@ Specifies whether a VM will be started during system bootup. `-ostype` `(l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win7 | win8 | wvista | wxp)` :: -Used to enable special optimization/features for specific -operating systems: -+ -other => unspecified OS -wxp => Microsoft Windows XP -w2k => Microsoft Windows 2000 -w2k3 => Microsoft Windows 2003 -w2k8 => Microsoft Windows 2008 -wvista => Microsoft Windows Vista -win7 => Microsoft Windows 7 -win8 => Microsoft Windows 8/2012 -l24 => Linux 2.4 Kernel -l26 => Linux 2.6/3.X Kernel -solaris => solaris/opensolaris/openindiania kernel -+ -other|l24|l26|solaris ... no special behaviour -wxp|w2k|w2k3|w2k8|wvista|win7|win8 ... use --localtime switch +Specify guest operating system. `-parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` :: Map host parallel devices (n is 0 to 2). -+ -NOTE: This option allows direct access to host hardware. So it is no longer -possible to migrate such machines - use with special care. -+ -Experimental: user reported problems with this option. `-pool` `string` :: @@ -296,7 +221,7 @@ Add the VM to the specified pool. `-protection` `boolean` (default=`0`):: -Sets the protection flag of the VM. This will prevent the remove operation. +Sets the protection flag of the VM. This will disable the remove VM and remove disk operations. `-reboot` `boolean` (default=`1`):: @@ -312,24 +237,15 @@ Use volume as SCSI hard disk or CD-ROM (n is 0 to 13). `-scsihw` `(lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single)` (default=`lsi`):: -scsi controller model +SCSI controller model `-serial[n]` `(/dev/.+|socket)` :: -Create a serial device inside the VM (n is 0 to 3), and pass through a host -serial device (i.e. /dev/ttyS0), or create a unix socket on the host side -(use 'qm terminal' to open a terminal connection). -+ -NOTE: If you pass through a host serial device, it is no longer possible to -migrate such machines - use with special care. -+ -Experimental: user reported problems with this option. +Create a serial device inside the VM (n is 0 to 3) `-shares` `integer (0 - 50000)` (default=`1000`):: -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 +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 `-smbios1` `[family=] [,manufacturer=] [,product=] [,serial=] [,sku=] [,uuid=] [,version=]` :: @@ -345,15 +261,11 @@ The number of CPU sockets. `-startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` (default=`now`):: -Set the initial date of the real time clock. Valid format for date are: -'now' or '2006-06-17T16:01:21' or '2006-06-17'. +Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'. `-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` :: -Startup and shutdown behavior. Order is a non-negative number defining the -general startup order. Shutdown in done with reverse ordering. Additionally -you can set the 'up' or 'down' delay in seconds, which specifies a delay to -wait before the next VM is started or stopped. +Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped. `-storage` `string` :: @@ -361,11 +273,7 @@ Default storage. `-tablet` `boolean` (default=`1`):: -Enable/disable the USB tablet device. This device is usually needed to -allow absolute mouse positioning with VNC. Else the mouse runs out of sync -with normal VNC clients. If you're running lots of console-only guests on -one host, you may consider disabling this to save some context switches. -This is turned off by default if you use spice (-vga=qxl). +Enable/disable the USB tablet device. `-tdf` `boolean` (default=`0`):: @@ -383,27 +291,11 @@ NOTE: Requires option(s): `archive` `-unused[n]` `string` :: -Reference to unused volumes. +Reference to unused volumes. This is used internally, and should not be modified manually. `-usb[n]` `[host=] [,usb3=<1|0>]` :: -Configure an USB device (n is 0 to 4). This can be used to -pass-through usb devices to the guest. HOSTUSBDEVICE syntax is: -+ -'bus-port(.port)*' (decimal numbers) or -'vendor_id:product_id' (hexadeciaml numbers) or -'spice' -+ -You can use the 'lsusb -t' command to list existing usb devices. -+ -NOTE: This option allows direct access to host hardware. So it is no longer -possible to migrate such machines - use with special care. -+ -The value 'spice' can be used to add a usb redirection devices for spice. -+ -The 'usb3' option determines whether the device is a USB3 device or not -(this does currently not work reliably with spice redirection and is then -ignored). +Configure an USB device (n is 0 to 4). `-vcpus` `integer (1 - N)` (default=`0`):: @@ -411,12 +303,7 @@ Number of hotplugged vcpus. `-vga` `(cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | 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. +Select the VGA type. `-virtio[n]` `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_rd=] [,bps_wr=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_rd=] [,iops_rd_max=] [,iops_wr=] [,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=]` :: @@ -424,10 +311,7 @@ Use volume as VIRTIO hard disk (n is 0 to 15). `-watchdog` `[[model=]] [,action=]` :: -Create a virtual hardware watchdog device. Once enabled (by a guest -action), the watchdog must be periodically polled by an agent inside the -guest or else the watchdog will reset the guest (or execute the respective -action specified) +Create a virtual hardware watchdog device. @@ -503,8 +387,7 @@ Target node. `-force` `boolean` :: -Allow to migrate VMs which use local devices. Only root may use this -option. +Allow to migrate VMs which use local devices. Only root may use this option. `-online` `boolean` :: @@ -542,13 +425,11 @@ Target storage. `-delete` `boolean` (default=`0`):: -Delete the original disk after successful copy. By default the original -disk is kept as unused disk. +Delete the original disk after successful copy. By default the original disk is kept as unused disk. `-digest` `string` :: -Prevent changes if current configuration file has different SHA1 digest. -This can be used to prevent concurrent modifications. +Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. `-format` `(qcow2 | raw | vmdk)` :: @@ -614,14 +495,11 @@ The disk you want to resize. `` `\+?\d+(\.\d+)?[KMGT]?` :: -The new size. With the '+' sign the value is added to the actual size of -the volume and without it, the value is taken as an absolute one. Shrinking -disk size is not supported. +The new size. With the '+' sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported. `-digest` `string` :: -Prevent changes if current configuration file has different SHA1 digest. -This can be used to prevent concurrent modifications. +Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. `-skiplock` `boolean` :: @@ -699,11 +577,7 @@ Enable/disable Qemu GuestAgent. `-args` `string` :: -Arbitrary arguments passed to kvm, for example: -+ -args: -no-reboot -no-hpet -+ -NOTE: this option is for experts only. +Arbitrary arguments passed to kvm. `-autostart` `boolean` (default=`0`):: @@ -711,8 +585,7 @@ Automatic restart after crash (currently ignored). `-balloon` `integer (0 - N)` :: -Amount of target RAM for the VM in MB. Using zero disables the ballon -driver. +Amount of target RAM for the VM in MB. Using zero disables the ballon driver. `-bios` `(ovmf | seabios)` (default=`seabios`):: @@ -741,17 +614,10 @@ Emulated CPU type. `-cpulimit` `number (0 - 128)` (default=`0`):: Limit of CPU usage. -+ -NOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' -indicates no CPU limit. `-cpuunits` `integer (0 - 500000)` (default=`1000`):: -CPU weight for a VM. Argument is used in the kernel fair scheduler. The -larger the number is, the more CPU time this VM gets. Number is relative to -weights of all the other running VMs. -+ -NOTE: You can disable fair-scheduler configuration by setting this to 0. +CPU weight for a VM. `-delete` `string` :: @@ -759,20 +625,15 @@ A list of settings you want to delete. `-description` `string` :: -Description for the VM. Only used on the configuration web interface. This -is saved as comment inside the configuration file. +Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file. `-digest` `string` :: -Prevent changes if current configuration file has different SHA1 digest. -This can be used to prevent concurrent modifications. +Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications. `-force` `boolean` :: -Force physical removal. Without this, we simple remove the disk from the -config file and create an additional configuration entry called -'unused[n]', which contains the volume ID. Unlink of unused[n] always cause -physical removal. +Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal. + NOTE: Requires option(s): `delete` @@ -782,26 +643,11 @@ Freeze CPU at startup (use 'c' monitor command to start execution). `-hostpci[n]` `[host=] [,pcie=<1|0>] [,rombar=<1|0>] [,x-vga=<1|0>]` :: -Map host pci devices. HOSTPCIDEVICE syntax is: -+ -'bus:dev.func' (hexadecimal numbers) -+ -You can us the 'lspci' command to list existing pci devices. -+ -The 'rombar' option determines whether or not the device's ROM will be -visible in the guest's memory map (default is 'on'). -+ -NOTE: This option allows direct access to host hardware. So it is no longer -possible to migrate such machines - use with special care. -+ -Experimental: user reported problems with this option. +Map host PCI devices into guest. `-hotplug` `string` (default=`network,disk,usb`):: -Selectively enable hotplug features. This is a comma separated list of -hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to -disable hotplug completely. Value '1' is an alias for the default -'network,disk,usb'. +Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'. `-ide[n]` `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_rd=] [,bps_wr=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_rd=] [,iops_rd_max=] [,iops_wr=] [,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=]` :: @@ -809,8 +655,7 @@ Use volume as IDE hard disk or CD-ROM (n is 0 to 3). `-keyboard` `(da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr)` (default=`en-us`):: -Keybord layout for vnc server. Default is read from the datacenter -configuration file. +Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.conf' configuration file. `-kvm` `boolean` (default=`1`):: @@ -818,8 +663,7 @@ Enable/disable KVM hardware virtualization. `-localtime` `boolean` :: -Set the real time clock to local time. This is enabled by default if ostype -indicates a Microsoft OS. +Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS. `-lock` `(backup | migrate | rollback | snapshot)` :: @@ -831,8 +675,7 @@ Specific the Qemu machine type. `-memory` `integer (16 - N)` (default=`512`):: -Amount of RAM for the VM in MB. This is the maximum available memory when -you use the balloon device. +Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device. `-migrate_downtime` `number (0 - N)` (default=`0.1`):: @@ -849,28 +692,6 @@ Set a name for the VM. Only used on the configuration web interface. `-net[n]` `[model=] [,bridge=] [,firewall=<1|0>] [,link_down=<1|0>] [,macaddr=] [,queues=] [,rate=] [,tag=] [,trunks=] [,=]` :: Specify network devices. -+ -MODEL is one of: e1000 e1000-82540em e1000-82544gc e1000-82545em i82551 -i82557b i82559er ne2k_isa ne2k_pci pcnet rtl8139 virtio vmxnet3 -+ -XX:XX:XX:XX:XX:XX should be an unique MAC address. This is -automatically generated if not specified. -+ -The bridge parameter can be used to automatically add the interface to a -bridge device. The Proxmox VE standard bridge is called 'vmbr0'. -+ -Option 'rate' is used to limit traffic bandwidth from and to this -interface. It is specified as floating point number, unit is 'Megabytes per -second'. -+ -If you specify no bridge, we create a kvm 'user' (NATed) network device, -which provides DHCP and DNS services. The following addresses are used: -+ -10.0.2.2 Gateway -10.0.2.3 DNS Server -10.0.2.4 SMB Server -+ -The DHCP server assign addresses to the guest starting from 10.0.2.15. `-numa` `boolean` (default=`0`):: @@ -878,7 +699,7 @@ Enable/disable NUMA. `-numa[n]` `cpus= [,hostnodes=] [,memory=] [,policy=]` :: -numa topology +NUMA topology. `-onboot` `boolean` (default=`0`):: @@ -886,36 +707,15 @@ Specifies whether a VM will be started during system bootup. `-ostype` `(l24 | l26 | other | solaris | w2k | w2k3 | w2k8 | win7 | win8 | wvista | wxp)` :: -Used to enable special optimization/features for specific -operating systems: -+ -other => unspecified OS -wxp => Microsoft Windows XP -w2k => Microsoft Windows 2000 -w2k3 => Microsoft Windows 2003 -w2k8 => Microsoft Windows 2008 -wvista => Microsoft Windows Vista -win7 => Microsoft Windows 7 -win8 => Microsoft Windows 8/2012 -l24 => Linux 2.4 Kernel -l26 => Linux 2.6/3.X Kernel -solaris => solaris/opensolaris/openindiania kernel -+ -other|l24|l26|solaris ... no special behaviour -wxp|w2k|w2k3|w2k8|wvista|win7|win8 ... use --localtime switch +Specify guest operating system. `-parallel[n]` `/dev/parport\d+|/dev/usb/lp\d+` :: Map host parallel devices (n is 0 to 2). -+ -NOTE: This option allows direct access to host hardware. So it is no longer -possible to migrate such machines - use with special care. -+ -Experimental: user reported problems with this option. `-protection` `boolean` (default=`0`):: -Sets the protection flag of the VM. This will prevent the remove operation. +Sets the protection flag of the VM. This will disable the remove VM and remove disk operations. `-reboot` `boolean` (default=`1`):: @@ -935,24 +735,15 @@ Use volume as SCSI hard disk or CD-ROM (n is 0 to 13). `-scsihw` `(lsi | lsi53c810 | megasas | pvscsi | virtio-scsi-pci | virtio-scsi-single)` (default=`lsi`):: -scsi controller model +SCSI controller model `-serial[n]` `(/dev/.+|socket)` :: -Create a serial device inside the VM (n is 0 to 3), and pass through a host -serial device (i.e. /dev/ttyS0), or create a unix socket on the host side -(use 'qm terminal' to open a terminal connection). -+ -NOTE: If you pass through a host serial device, it is no longer possible to -migrate such machines - use with special care. -+ -Experimental: user reported problems with this option. +Create a serial device inside the VM (n is 0 to 3) `-shares` `integer (0 - 50000)` (default=`1000`):: -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 +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 `-skiplock` `boolean` :: @@ -972,23 +763,15 @@ The number of CPU sockets. `-startdate` `(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)` (default=`now`):: -Set the initial date of the real time clock. Valid format for date are: -'now' or '2006-06-17T16:01:21' or '2006-06-17'. +Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'. `-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` :: -Startup and shutdown behavior. Order is a non-negative number defining the -general startup order. Shutdown in done with reverse ordering. Additionally -you can set the 'up' or 'down' delay in seconds, which specifies a delay to -wait before the next VM is started or stopped. +Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped. `-tablet` `boolean` (default=`1`):: -Enable/disable the USB tablet device. This device is usually needed to -allow absolute mouse positioning with VNC. Else the mouse runs out of sync -with normal VNC clients. If you're running lots of console-only guests on -one host, you may consider disabling this to save some context switches. -This is turned off by default if you use spice (-vga=qxl). +Enable/disable the USB tablet device. `-tdf` `boolean` (default=`0`):: @@ -1000,27 +783,11 @@ Enable/disable Template. `-unused[n]` `string` :: -Reference to unused volumes. +Reference to unused volumes. This is used internally, and should not be modified manually. `-usb[n]` `[host=] [,usb3=<1|0>]` :: -Configure an USB device (n is 0 to 4). This can be used to -pass-through usb devices to the guest. HOSTUSBDEVICE syntax is: -+ -'bus-port(.port)*' (decimal numbers) or -'vendor_id:product_id' (hexadeciaml numbers) or -'spice' -+ -You can use the 'lsusb -t' command to list existing usb devices. -+ -NOTE: This option allows direct access to host hardware. So it is no longer -possible to migrate such machines - use with special care. -+ -The value 'spice' can be used to add a usb redirection devices for spice. -+ -The 'usb3' option determines whether the device is a USB3 device or not -(this does currently not work reliably with spice redirection and is then -ignored). +Configure an USB device (n is 0 to 4). `-vcpus` `integer (1 - N)` (default=`0`):: @@ -1028,12 +795,7 @@ Number of hotplugged vcpus. `-vga` `(cirrus | qxl | qxl2 | qxl3 | qxl4 | serial0 | serial1 | serial2 | serial3 | std | 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. +Select the VGA type. `-virtio[n]` `[file=] [,aio=] [,backup=<1|0>] [,bps=] [,bps_rd=] [,bps_wr=] [,cache=] [,cyls=] [,detect_zeroes=<1|0>] [,discard=] [,format=] [,heads=] [,iops=] [,iops_max=] [,iops_rd=] [,iops_rd_max=] [,iops_wr=] [,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=]` :: @@ -1041,10 +803,7 @@ Use volume as VIRTIO hard disk (n is 0 to 15). `-watchdog` `[[model=]] [,action=]` :: -Create a virtual hardware watchdog device. Once enabled (by a guest -action), the watchdog must be periodically polled by an agent inside the -guest or else the watchdog will reset the guest (or execute the respective -action specified) +Create a virtual hardware watchdog device. @@ -1219,8 +978,7 @@ The (unique) ID of the VM. `-iface` `(serial0 | serial1 | serial2 | serial3)` :: -Select the serial device. By default we simply use the first suitable -device. +Select the serial device. By default we simply use the first suitable device. @@ -1235,10 +993,7 @@ The (unique) ID of the VM. `-force` `boolean` :: -Force physical removal. Without this, we simple remove the disk from the -config file and create an additional configuration entry called -'unused[n]', which contains the volume ID. Unlink of unused[n] always cause -physical removal. +Force physical removal. Without this, we simple remove the disk from the config file and create an additional configuration entry called 'unused[n]', which contains the volume ID. Unlink of unused[n] always cause physical removal. `-idlist` `string` ::