Features/RemovedFeatures: Difference between revisions
(Add sections about removed HMP commands and devices) |
(Add more options) |
||
| Line 8: | Line 8: | ||
! <span style="font-size:90%">Removed in</span> | ! <span style="font-size:90%">Removed in</span> | ||
! Replacement | ! Replacement | ||
|- | |||
| -balloon | |||
| v2.12.0 | |||
| v3.1.0 | |||
| The '''-balloon''' option has been replaced by '''-device virtio-balloon'''. | |||
|- | |- | ||
| -bootp | | -bootp | ||
| v2.6.0 | | v2.6.0 | ||
| v3.1.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 | | 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 | | -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 | | v2.10.0 | ||
| v3.0 | | v3.0.0 | ||
| The drive geometry should now be specified via '''-device | | 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 | | -hdachs | ||
| v2.10.0 | | v2.10.0 | ||
| v2.12.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,...''' | | 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 | | -net channel | ||
| v2.6.0 | | v2.6.0 | ||
| v2.12.0 | | v2.12.0 | ||
| Option has been replaced by '''-net user,guestfwd= | | Option has been replaced by '''-net user,guestfwd=…''' | ||
|- | |- | ||
| -net dump | | -net dump | ||
| Line 33: | Line 43: | ||
| v2.12.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. | | '''<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 | | -redir | ||
| v2.6.0 | | v2.6.0 | ||
| v3.1.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 | | 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 | | -smb | ||
| v2.6.0 | | v2.6.0 | ||
| v3.1.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 | | 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 | | -tdf | ||
| Line 52: | Line 97: | ||
| v2.6.0 | | v2.6.0 | ||
| 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 | | 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" | |||
|} | |} | ||
Revision as of 11:28, 15 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 |
|---|---|---|---|
| -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 -drive trans=t -drive secs=s -drive heads=h -drive cyls=c -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 | -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. |
| -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 -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. |
| -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=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. |
| -vnc …,tls=… -vnc …,x509=… -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
| 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. |