Features/RemovedFeatures: Difference between revisions

From QEMU
(Add drive geometry options)
(Add sections about removed HMP commands and devices)
Line 53: Line 53:
| v3.1.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.
| 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.
|}
|}

Revision as of 16:16, 14 February 2019

This page is about features that have been removed from QEMU (after a deprecation period), and what new features should be used instead.

Removed command line parameters

Parameter Deprecated in Removed in 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 serial=r
-drive trans=t
-drive secs=s
-drive heads=h
-drive cyls=c
-drive 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 -net dump[,vlan=n][,file=filename][,len=maxlen] has been replaced by -object filter-dump,id=id,netdev=dev[,file=filename][,maxlen=maxlen]. Note that the new syntax works with netdev IDs instead of the old "vlan" hubs.
-redir v2.6.0 v3.1.0 The -redir [tcp|udp]:hostport:[guestaddr]:guestport argument is replaced by either -netdev user,id=x,hostfwd=[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport (for pluggable NICs, accompanied with -device ...,netdev=x) or -nic user,hostfwd=[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport (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

Parameter Deprecated in Removed in 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

Device Deprecated in Removed in 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.