Virtualization Administration GuideChapter 18. qemu-kvm WhitelistProduct identificationRed Hat Enterprise Linux 6 ObjectivesThe primary objective of this whitelist is to provide a complete list of the supported options of the qemu-kvm utility used as an emulator and a virtualizer in Red Hat Enterprise Linux 6. This is a comprehensive summary of the supported options. BackgroundRed Hat Enterprise Linux 6 uses KVM as an underlying virtualization technology. The machine emulator and virtualizer used is a modified version of QEMU called qemu-kvm. This version does not support all configuration options of the original QEMU and it adds some additional options. Scope of the chapterThis chapter lists only the supported options of the qemu-kvm utility. Options not listed here are not supported by Red Hat. Used format<name> - When used in a syntax description, this string shoud be replaced by user-defined value. [a|b|c] - When used in a syntax description, only one of the strings separated by | is used. When no comment is present, an option is supported with all possible values.
Emulated machine-M <machine-type> Processor type-cpu <model>[,<FEATURE>][...] We support exposing additional features and placing restrictions. Supported models are: Opteron_G5 - AMD Opteron 63xx class CPU Opteron_G4 - AMD Opteron 62xx class CPU Opteron_G3 - AMD Opteron 23xx (AMD Opteron Gen 3) Opteron_G2 - AMD Opteron 22xx (AMD Opteron Gen 2) Opteron_G1 - AMD Opteron 240 (AMD Opteron Gen 1) Westmere - Westmere E56xx/L56xx/X56xx (Nehalem-C) Haswell - Intel Core Processor (Haswell) SandyBridge - Intel Xeon E312xx (Sandy Bridge) Nehalem - Intel Core i7 9xx (Nehalem Class Core i7) Penryn - Intel Core 2 Duo P9xxx (Penryn Class Core 2) Conroe - Intel Celeron_4x0 (Conroe/Merom Class Core 2) cpu64-rhel5 - Red Hat Enterprise Linux 5 supported QEMU Virtual CPU version cpu64-rhel6 - Red Hat Enterprise Linux 6 supported QEMU Virtual CPU version default - special option use default option from above.
Processor Topology-smp <n>[,cores=<ncores>][,threads=<nthreads>][,sockets=<nsocks>][,maxcpus=<maxcpus>] Hypervisor and guest operating system limits on processor topology apply. NUMA system-numa <nodes>[,mem=<size>][,cpus=<cpu[-cpu>]][,nodeid=<node>] Hypervisor and guest operating system limits on processor topology apply. Memory size-m <megs> Supported values are limited by guest minimal and maximal values and hypervisor limits. Keyboard layout-k <language> Guest name-name <name> Guest UUID-uuid <uuid> Generic drive-drive <option>[,<option>[,<option>[,...]]] Supported with the following options: readonly[on|off] werror[enospc|report|stop|ignore] rerror[report|stop|ignore] id=<id> Id of the drive has the following limitaton for if=none: IDE disk has to have <id> in following format: drive-ide0-<BUS>-<UNIT> Example of correct format: -drive if=none,id=drive-ide0-<BUS>-<UNIT>,... -device ide-drive,drive=drive-ide0-<BUS>-<UNIT>,bus=ide.<BUS>,unit=<UNIT>
file=<file> Value of <file> is parsed with the following rules: Passing floppy device as <file> is not supported. Passing cd-rom device as <file> is supported only with cdrom media type (media=cdrom) and only as IDE drive (either if=ide or if=none + -device ide-drive). If <file> is neither block nor character device, it must not contain ':'.
if=<interface> The following interfaces are supported: none, ide, virtio, floppy. index=<index> media=<media> cache=<cache> Supported values: none, writeback or writethrough. copy-on-read=[on|off] snapshot=[yes|no] serial=<serial> aio=<aio> format=<format> This option is not required and can be omitted. However, this is not recommended for raw images because it represents security risk. Supported formats are:
Boot option-boot [order=<drives>][,menu=[on|off]] Snapshot mode-snapshot Disable graphics-nographic VGA card emulation-vga <type> Supported types: cirrus - Cirrus Logic GD5446 Video card. std - Standard VGA card with Bochs VBE extensions. qxl - Spice paravirtual card. none - Disable VGA card.
VNC display-vnc <display>[,<option>[,<option>[,...]]] Supported display value: Supported options are: Spice desktop-spice option[,option[,...]] Supported options are: port=<number> addr=<addr> ipv4 ipv6 password=<secret> disable-ticketing disable-copy-paste tls-port=<number> x509-dir=</path/to/certificate/dir> x509-key-file=<file> x509-key-password=<file> x509-cert-file=<file> x509-cacert-file=<file> x509-dh-key-file=<file> tls-cipher=<list> tls-channel[main|display|cursor|inputs|record|playback] plaintext-channel[main|display|cursor|inputs|record|playback] image-compression=<compress> jpeg-wan-compression=<value> zlib-glz-wan-compression=<value> streaming-video=[off|all|filter] agent-mouse=[on|off] playback-compression=[on|off] seamless-migratio=[on|off]
TAP network-netdev tap,id=<id>][,<options>...] The following options are supported (all use name=value format): ifname fd script downscript sndbuf vnet_hdr vhost vhostfd vhostforce
General device-device <driver>[,<prop>[=<value>][,...]] All drivers support following properties Following drivers are supported (with available properties): pci-assign host bootindex configfd addr rombar romfile multifunction
If the device has multiple functions, all of them need to be assigned to the same guest. rtl8139 mac netdev bootindex addr
e1000 mac netdev bootindex addr
virtio-net-pci ioeventfd vectors indirect event_idx csum guest_csum gso guest_tso4 guest_tso6 guest_ecn guest_ufo host_tso4 host_tso6 host_ecn host_ufo mrg_rxbuf status ctrl_vq ctrl_rx ctrl_vlan ctrl_rx_extra mac netdev bootindex x-txtimer x-txburst tx addr
qxl ram_size vram_size revision cmdlog addr
ide-drive unit drive physical_block_size bootindex ver wwn
virtio-blk-pci class drive logical_block_size physical_block_size min_io_size opt_io_size bootindex ioeventfd vectors indirect_desc event_idx scsi addr
isa-debugcon isa-serial virtserialport virtconsole virtio-serial-pci vectors class indirect_desc event_idx max_ports flow_control addr
ES1370 AC97 intel-hda hda-duplex hda-micro hda-output i6300esb ib700 - no properties sga - no properties virtio-balloon-pci indirect_desc event_idx addr
usb-tablet usb-kbd usb-mouse usb-ccid - supported since 6.2 usb-host - tech preview since 6.2 hostbus hostaddr hostport vendorid productid isobufs port
usb-hub - supported since 6.2 usb-ehci - tech preview since 6.2 usb-storage - tech preview since 6.2 drive bootindex serial removable port
usb-redir - tech preview since 6.3 scsi-cd - tech preview for 6.3 drive logical_block_size physical_block_size min_io_size opt_io_size bootindex ver serial scsi-id lun channel-scsi wwn
scsi-hd -tech preview for 6.3 drive logical_block_size physical_block_size min_io_size opt_io_size bootindex ver serial scsi-id lun channel-scsi wwn
scsi-block -tech preview for 6.3 scsi-disk -tech preview for 6.3 drive=drive logical_block_size physical_block_size min_io_size opt_io_size bootindex ver serial scsi-id lun channel-scsi wwn
piix3-usb-uhci piix4-usb-uhci ccid-card-passthru
Global device setting-global <device>.<property>=<value> Supported devices and properties as in "General device" section with these additional devices: isa-fdc driveA driveB bootindexA bootindexB
qxl-vga ram_size vram_size revision cmdlog addr
Character device-chardev backend,id=<id>[,<options>] Supported backends are: null,id=<id> - null device socket,id=<id>,port=<port>[,host=<host>][,to=<to>][,ipv4][,ipv6][,nodelay][,server][,nowait][,telnet] - tcp socket socket,id=<id>,path=<path>[,server][,nowait][,telnet] - unix socket file,id=<id>,path=<path> - trafit to file. stdio,id=<id> - standard i/o spicevmc,id=<id>,name=<name> - spice channel
Enable USB-usb 18.7. Linux/Multiboot boot Kernel file-kernel <bzImage> Note: multiboot images are not supported Ram disk-initrd <file> Command line parameter-append <cmdline> KVM virtualization-enable-kvm Qemu-kvm supports only KVM virtualization and it is used by default if available. If -enable-kvm is used and KVM is not available, qemu-kvm fails. However, if -enable-kvm is not used and KVM is not available, qemu-kvm runs in TCG mode, which is not supported. Disable kernel mode PIT reinjection-no-kvm-pit-reinjection No shutdown-no-shutdown No reboot-no-reboot Serial port, monitor, QMP-serial <dev> -monitor <dev> -qmp <dev> Supported devices are: stdio - standard input/output null - null device file:<filename> - output to file. tcp:[<host>]:<port>[,server][,nowait][,nodelay] - TCP Net console. unix:<path>[,server][,nowait] - Unix domain socket. mon:<dev_string> - Any device above, used to multiplex monitor too. none - disable, valid only for -serial. chardev:<id> - character device created with -chardev.
Monitor redirect-mon <chardev_id>[,mode=[readline|control]][,default=[on|off]] Manual CPU start-S RTC-rtc [base=utc|localtime|date][,clock=host|vm][,driftfix=none|slew] Watchdog-watchdog model Watchdog reaction-watchdog-action <action> Guest memory backing-mem-prealloc -mem-path /dev/hugepages SMBIOS entry-smbios type=0[,vendor=<str>][,<version=str>][,date=<str>][,release=%d.%d] -smbios type=1[,manufacturer=<str>][,product=<str>][,version=<str>][,serial=<str>][,uuid=<uuid>][,sku=<str>][,family=<str>] 18.9. Help and information optionsHelp-h -help Version-version Audio help-audio-help 18.10. Miscellaneous optionsMigration-incoming No default configuration-nodefconfig -nodefaults Running without -nodefaults is not supported Device configuration file-readconfig <file> -writeconfig <file> Loaded saved state-loadvm <file> |