Features/RemovedFeatures: Difference between revisions

From QEMU
(Add sections about removed HMP commands and devices)
(Removed features have now been integrated into the main docs)
Tag: Replaced
 
(3 intermediate revisions by 2 users not shown)
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
|-
| -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&nbsp;serial=r<br>-drive&nbsp;trans=t<br>-drive&nbsp;secs=s<br>-drive&nbsp;heads=h<br>-drive&nbsp;cyls=c<br>-drive&nbsp;addr=a
| v2.10.0
| v3.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,...''').
|-
| -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.
|-
| -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.
|-
| -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.
|-
| -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=slew'''.
|-
| -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.
|}
 
== 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.
|}

Latest revision as of 05:41, 18 August 2021

The information about removed features has been integrated into the main QEMU documentation now. Please see this page for more details:

https://www.qemu.org/docs/master/about/removed-features.html