|
|
| Line 1: |
Line 1: |
| This page is about features that have been removed from QEMU (after a [https://qemu.weilnetz.de/doc/qemu-doc.html#Deprecated-features deprecation period]), and what new features should be used instead.
| | The information about removed features has been integrated into the main QEMU documentation now. Please see this page for more details: |
|
| |
|
| == Removed command line parameters ==
| | https://www.qemu.org/docs/master/about/removed-features.html |
| | |
| {| class="wikitable" border="1"
| |
| ! Parameter
| |
| ! <span style="font-size:90%">Deprecated in</span>
| |
| ! <span style="font-size:90%">Removed in</span>
| |
| ! Replacement
| |
| |-
| |
| | -balloon
| |
| | v2.12.0
| |
| | v3.1.0
| |
| | The '''-balloon''' option has been replaced by '''-device virtio-balloon'''.
| |
| |-
| |
| | -bootp
| |
| | v2.6.0
| |
| | v3.1.0
| |
| | The '''-bootp /some/file''' argument is replaced by either '''-netdev user,id=x,bootp=/some/file''' (for pluggable NICs, accompanied with '''-device …,netdev=x'''), or '''-nic user,bootp=/some/file''' (for embedded NICs). The new syntax allows different settings to be provided per NIC.
| |
| |-
| |
| | -drive serial=r<br>-drive trans=t<br>-drive secs=s<br>-drive heads=h<br>-drive cyls=c<br>-drive addr=a
| |
| | v2.10.0
| |
| | v3.0.0
| |
| | The drive geometry should now be specified via '''-device …,drive=dr,cyls=c,heads=h,secs=s,bios-chs-trans=t,addr=a,serial=r''' (together with '''-drive if=none,id=dr,…''').
| |
| |-
| |
| | -hdachs
| |
| | v2.10.0
| |
| | v2.12.0
| |
| | The geometry defined by '''-hdachs c,h,s,t''' should now be specified via '''-device ide-hd,drive=dr,cyls=c,heads=h,secs=s,bios-chs-trans=t''' (together with '''-drive if=none,id=dr,…''').
| |
| |-
| |
| | -localtime
| |
| | v2.12.0
| |
| | v3.1.0
| |
| | Replaced by '''-rtc base=localtime'''
| |
| |-
| |
| | -net channel
| |
| | v2.6.0
| |
| | v2.12.0
| |
| | Option has been replaced by '''-net user,guestfwd=…'''
| |
| |-
| |
| | -net dump
| |
| | v2.10.0
| |
| | v2.12.0
| |
| | '''<nowiki>-net dump[,vlan=n][,file=filename][,len=maxlen]</nowiki>''' has been replaced by '''<nowiki>-object filter-dump,id=id,netdev=dev[,file=filename][,maxlen=maxlen]</nowiki>'''. Note that the new syntax works with netdev IDs instead of the old "vlan" hubs.
| |
| |-
| |
| | -net …,vlan=x
| |
| | v2.9.0
| |
| | v3.0.0
| |
| | To connect one NIC frontend with a network backend, either use '''-nic …''' (e.g. for on-board NICs) or use '''-netdev …,id=n''' together with '''-device …,netdev=n''' (for full control over pluggable NICs). To connect multiple NICs or network backends via a hub device (which is what ''vlan'' did), use '''-nic hubport,hubid=x,…''' or '''-netdev hubport,id=n,hubid=x,…''' (together with '''-device …,netdev=n''') instead.
| |
| |-
| |
| | -nodefconfig
| |
| | v2.11.0
| |
| | v3.1.0
| |
| | Use '''-no-user-config''' instead.
| |
| |-
| |
| | -no-kvm-irqchip
| |
| | v1.3.0
| |
| | v3.0.0
| |
| | Use '''-machine kernel_irqchip=off''' instead.
| |
| |-
| |
| | -no-kvm-pit
| |
| | v1.3.0
| |
| | v2.12.0
| |
| | There is no replacement, since this was just a dummy option that has been ignored.
| |
| |-
| |
| | -no-kvm-pit-reinjection
| |
| | v1.3.0
| |
| | v3.0.0
| |
| | Use '''-global kvm-pit.lost_tick_policy=discard''' instead.
| |
| |-
| |
| | -redir
| |
| | v2.6.0
| |
| | v3.1.0
| |
| | The '''<nowiki>-redir [tcp|udp]:hostport:[guestaddr]:guestport</nowiki>''' argument is replaced by either '''<nowiki>-netdev user,id=x,hostfwd=[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport</nowiki>''' (for pluggable NICs, accompanied with '''-device …,netdev=x''') or '''<nowiki>-nic user,hostfwd=[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport</nowiki>''' (for embedded NICs). The new syntax allows different settings to be provided per NIC.
| |
| |-
| |
| | -rtc-td-hack
| |
| | v2.12.0
| |
| | v3.1.0
| |
| | Use '''-rtc driftfix=slew''' instead.
| |
| |-
| |
| | -smb
| |
| | v2.6.0
| |
| | v3.1.0
| |
| | The '''-smb /some/dir''' argument is replaced by either '''-netdev user,id=x,smb=/some/dir''' (for pluggable NICs, accompanied with '''-device …,netdev=x'''), or '''-nic user,smb=/some/dir''' (for embedded NICs). The new syntax allows different settings to be provided per NIC.
| |
| |-
| |
| | -startdate
| |
| | v2.12.0
| |
| | v3.1.0
| |
| | Replaced by '''-rtc base=date'''.
| |
| |-
| |
| | -tdf
| |
| | v1.3.0
| |
| | v2.12.0
| |
| | There is no replacement, the '''-tdf''' option has just been ignored since the behaviour that could be changed by this option in qemu-kvm is now the default when using the KVM PIT. It still can be requested explicitly using '''-global kvm-pit.lost_tick_policy=discard'''.
| |
| |-
| |
| | -tftp
| |
| | v2.6.0
| |
| | v3.1.0
| |
| | The '''-tftp /some/dir''' argument is replaced by either '''-netdev user,id=x,tftp=/some/dir''' (for pluggable NICs, accompanied with '''-device …,netdev=x'''), or '''-nic user,tftp=/some/dir''' (for embedded NICs). The new syntax allows different settings to be provided per NIC.
| |
| |-
| |
| | -vnc …,tls=…<br/>-vnc …,x509=…<br/>-vnc …,x509verify=…
| |
| | v2.5.0
| |
| | v3.1.0
| |
| | The "tls-creds" option should be used instead to point to a "tls-creds-x509" object created using "-object"
| |
| |}
| |
| | |
| == Removed HMP commands ==
| |
| | |
| {| class="wikitable" border="1"
| |
| ! Parameter
| |
| ! <span style="font-size:90%">Deprecated in</span>
| |
| ! <span style="font-size:90%">Removed in</span>
| |
| ! Replacement
| |
| |-
| |
| | usb_add and usb_remove
| |
| | v2.10.0
| |
| | v2.12.0
| |
| | Replaced by '''device_add''' and '''device_del''' (use '''device_add help''' for a list of available devices)
| |
| |-
| |
| | host_net_add and host_net_remove
| |
| | v2.10.0
| |
| | v2.12.0
| |
| | Replaced by '''netdev_add''' and '''netdev_del'''
| |
| |}
| |
| | |
| == Removed devices ==
| |
| | |
| {| class="wikitable" border="1"
| |
| ! Device
| |
| ! <span style="font-size:90%">Deprecated in</span>
| |
| ! <span style="font-size:90%">Removed in</span>
| |
| ! Replacement
| |
| |-
| |
| | ivshmem
| |
| | v2.6.0
| |
| | v4.0.0
| |
| | Replaced by either the '''ivshmem-plain''' or '''ivshmem-doorbell'''
| |
| |-
| |
| | spapr-pci-vfio-host-bridge
| |
| | v2.6.0
| |
| | v2.12.0
| |
| | The '''spapr-pci-vfio-host-bridge''' device type has been replaced by the '''spapr-pci-host-bridge''' device type.
| |
| |}
| |
| | |
| == Removed machine types ==
| |
| | |
| {| class="wikitable" border="1"
| |
| ! Machine
| |
| ! <span style="font-size:90%">Deprecated in</span>
| |
| ! <span style="font-size:90%">Removed in</span>
| |
| ! Replacement
| |
| |-
| |
| | dummy (m68k)
| |
| | v2.9.0
| |
| | v2.9.0
| |
| | Use the '''none''' machine with the '''loader''' device instead.
| |
| |-
| |
| | pc-0.10 - pc-0.11
| |
| | v3.0.0
| |
| | v4.0.0
| |
| | Use a newer '''pc-i440fx-x.y''' machine type instead.
| |
| |-
| |
| | s390-virtio
| |
| | v2.6.0
| |
| | v2.6.0
| |
| | Use the '''s390-ccw-virtio''' machine instead.
| |
| |-
| |
| | xlnx-ep108
| |
| | v2.11.0
| |
| | v3.0.0
| |
| | The EP108 was an early access development board that is no longer used. Use the '''xlnx-zcu102''' machine instead.
| |
| |}
| |
