12c5060cdSThomas Huth 22c5060cdSThomas HuthRemoved features 32c5060cdSThomas Huth================ 42c5060cdSThomas Huth 52c5060cdSThomas HuthWhat follows is a record of recently removed, formerly deprecated 62c5060cdSThomas Huthfeatures that serves as a record for users who have encountered 72c5060cdSThomas Huthtrouble after a recent upgrade. 82c5060cdSThomas Huth 92c5060cdSThomas HuthSystem emulator command line arguments 102c5060cdSThomas Huth-------------------------------------- 112c5060cdSThomas Huth 123d9c7ec9SThomas Huth``-hdachs`` (removed in 2.12) 133d9c7ec9SThomas Huth''''''''''''''''''''''''''''' 143d9c7ec9SThomas Huth 153d9c7ec9SThomas HuthThe geometry defined by ``-hdachs c,h,s,t`` should now be specified via 163d9c7ec9SThomas Huth``-device ide-hd,drive=dr,cyls=c,heads=h,secs=s,bios-chs-trans=t`` 173d9c7ec9SThomas Huth(together with ``-drive if=none,id=dr,...``). 183d9c7ec9SThomas Huth 193d9c7ec9SThomas Huth``-net channel`` (removed in 2.12) 203d9c7ec9SThomas Huth'''''''''''''''''''''''''''''''''' 213d9c7ec9SThomas Huth 223d9c7ec9SThomas HuthThis option has been replaced by ``-net user,guestfwd=...``. 233d9c7ec9SThomas Huth 243d9c7ec9SThomas Huth``-net dump`` (removed in 2.12) 253d9c7ec9SThomas Huth''''''''''''''''''''''''''''''' 263d9c7ec9SThomas Huth 273d9c7ec9SThomas Huth``-net dump[,vlan=n][,file=filename][,len=maxlen]`` has been replaced by 283d9c7ec9SThomas Huth``-object filter-dump,id=id,netdev=dev[,file=filename][,maxlen=maxlen]``. 293d9c7ec9SThomas HuthNote that the new syntax works with netdev IDs instead of the old "vlan" hubs. 303d9c7ec9SThomas Huth 313d9c7ec9SThomas Huth``-no-kvm-pit`` (removed in 2.12) 323d9c7ec9SThomas Huth''''''''''''''''''''''''''''''''' 333d9c7ec9SThomas Huth 343d9c7ec9SThomas HuthThis was just a dummy option that has been ignored, since the in-kernel PIT 353d9c7ec9SThomas Huthcannot be disabled separately from the irqchip anymore. A similar effect 363d9c7ec9SThomas Huth(which also disables the KVM IOAPIC) can be obtained with 373d9c7ec9SThomas Huth``-M kernel_irqchip=split``. 383d9c7ec9SThomas Huth 393d9c7ec9SThomas Huth``-tdf`` (removed in 2.12) 403d9c7ec9SThomas Huth'''''''''''''''''''''''''' 413d9c7ec9SThomas Huth 423d9c7ec9SThomas HuthThere is no replacement, the ``-tdf`` option has just been ignored since the 433d9c7ec9SThomas Huthbehaviour that could be changed by this option in qemu-kvm is now the default 443d9c7ec9SThomas Huthwhen using the KVM PIT. It still can be requested explicitly using 453d9c7ec9SThomas Huth``-global kvm-pit.lost_tick_policy=delay``. 463d9c7ec9SThomas Huth 478cc461c1SThomas Huth``-drive secs=s``, ``-drive heads=h`` & ``-drive cyls=c`` (removed in 3.0) 488cc461c1SThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 498cc461c1SThomas Huth 508cc461c1SThomas HuthThe drive geometry should now be specified via 518cc461c1SThomas Huth``-device ...,drive=dr,cyls=c,heads=h,secs=s`` (together with 528cc461c1SThomas Huth``-drive if=none,id=dr,...``). 538cc461c1SThomas Huth 548cc461c1SThomas Huth``-drive serial=``, ``-drive trans=`` & ``-drive addr=`` (removed in 3.0) 558cc461c1SThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 568cc461c1SThomas Huth 578cc461c1SThomas HuthUse ``-device ...,drive=dr,serial=r,bios-chs-trans=t,addr=a`` instead 588cc461c1SThomas Huth(together with ``-drive if=none,id=dr,...``). 598cc461c1SThomas Huth 608cc461c1SThomas Huth``-net ...,vlan=x`` (removed in 3.0) 618cc461c1SThomas Huth'''''''''''''''''''''''''''''''''''' 628cc461c1SThomas Huth 638cc461c1SThomas HuthThe term "vlan" was very confusing for most users in this context (it's about 648cc461c1SThomas Huthspecifying a hub ID, not about IEEE 802.1Q or something similar), so this 658cc461c1SThomas Huthhas been removed. To connect one NIC frontend with a network backend, either 668cc461c1SThomas Huthuse ``-nic ...`` (e.g. for on-board NICs) or use ``-netdev ...,id=n`` together 678cc461c1SThomas Huthwith ``-device ...,netdev=n`` (for full control over pluggable NICs). To 688cc461c1SThomas Huthconnect multiple NICs or network backends via a hub device (which is what 698cc461c1SThomas Huthvlan did), use ``-nic hubport,hubid=x,...`` or 708cc461c1SThomas Huth``-netdev hubport,id=n,hubid=x,...`` (with ``-device ...,netdev=n``) instead. 718cc461c1SThomas Huth 728cc461c1SThomas Huth``-no-kvm-irqchip`` (removed in 3.0) 738cc461c1SThomas Huth'''''''''''''''''''''''''''''''''''' 748cc461c1SThomas Huth 758cc461c1SThomas HuthUse ``-machine kernel_irqchip=off`` instead. 768cc461c1SThomas Huth 778cc461c1SThomas Huth``-no-kvm-pit-reinjection`` (removed in 3.0) 788cc461c1SThomas Huth'''''''''''''''''''''''''''''''''''''''''''' 798cc461c1SThomas Huth 808cc461c1SThomas HuthUse ``-global kvm-pit.lost_tick_policy=discard`` instead. 818cc461c1SThomas Huth 8229e04475SThomas Huth``-balloon`` (removed in 3.1) 8329e04475SThomas Huth''''''''''''''''''''''''''''' 8429e04475SThomas Huth 8529e04475SThomas HuthThe ``-balloon virtio`` option has been replaced by ``-device virtio-balloon``. 8629e04475SThomas HuthThe ``-balloon none`` option was a no-op and has no replacement. 8729e04475SThomas Huth 8829e04475SThomas Huth``-bootp`` (removed in 3.1) 8929e04475SThomas Huth''''''''''''''''''''''''''' 9029e04475SThomas Huth 9129e04475SThomas HuthThe ``-bootp /some/file`` argument is replaced by either 9229e04475SThomas Huth``-netdev user,id=x,bootp=/some/file`` (for pluggable NICs, accompanied with 9329e04475SThomas Huth``-device ...,netdev=x``), or ``-nic user,bootp=/some/file`` (for on-board NICs). 9429e04475SThomas HuthThe new syntax allows different settings to be provided per NIC. 9529e04475SThomas Huth 9629e04475SThomas Huth``-redir`` (removed in 3.1) 9729e04475SThomas Huth''''''''''''''''''''''''''' 9829e04475SThomas Huth 9929e04475SThomas HuthThe ``-redir [tcp|udp]:hostport:[guestaddr]:guestport`` option is replaced 10029e04475SThomas Huthby either ``-netdev 10129e04475SThomas Huthuser,id=x,hostfwd=[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport`` 10229e04475SThomas Huth(for pluggable NICs, accompanied with ``-device ...,netdev=x``) or by the option 10329e04475SThomas Huth``-nic user,hostfwd=[tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport`` 10429e04475SThomas Huth(for on-board NICs). The new syntax allows different settings to be provided 10529e04475SThomas Huthper NIC. 10629e04475SThomas Huth 10729e04475SThomas Huth``-smb`` (removed in 3.1) 10829e04475SThomas Huth''''''''''''''''''''''''' 10929e04475SThomas Huth 11029e04475SThomas HuthThe ``-smb /some/dir`` argument is replaced by either 11129e04475SThomas Huth``-netdev user,id=x,smb=/some/dir`` (for pluggable NICs, accompanied with 11229e04475SThomas Huth``-device ...,netdev=x``), or ``-nic user,smb=/some/dir`` (for on-board NICs). 11329e04475SThomas HuthThe new syntax allows different settings to be provided per NIC. 11429e04475SThomas Huth 11529e04475SThomas Huth``-tftp`` (removed in 3.1) 11629e04475SThomas Huth'''''''''''''''''''''''''' 11729e04475SThomas Huth 11829e04475SThomas HuthThe ``-tftp /some/dir`` argument is replaced by either 11929e04475SThomas Huth``-netdev user,id=x,tftp=/some/dir`` (for pluggable NICs, accompanied with 12029e04475SThomas Huth``-device ...,netdev=x``), or ``-nic user,tftp=/some/dir`` (for embedded NICs). 12129e04475SThomas HuthThe new syntax allows different settings to be provided per NIC. 12229e04475SThomas Huth 12329e04475SThomas Huth``-localtime`` (removed in 3.1) 12429e04475SThomas Huth''''''''''''''''''''''''''''''' 12529e04475SThomas Huth 12629e04475SThomas HuthReplaced by ``-rtc base=localtime``. 12729e04475SThomas Huth 12829e04475SThomas Huth``-nodefconfig`` (removed in 3.1) 12929e04475SThomas Huth''''''''''''''''''''''''''''''''' 13029e04475SThomas Huth 13129e04475SThomas HuthUse ``-no-user-config`` instead. 13229e04475SThomas Huth 13329e04475SThomas Huth``-rtc-td-hack`` (removed in 3.1) 13429e04475SThomas Huth''''''''''''''''''''''''''''''''' 13529e04475SThomas Huth 13629e04475SThomas HuthUse ``-rtc driftfix=slew`` instead. 13729e04475SThomas Huth 13829e04475SThomas Huth``-startdate`` (removed in 3.1) 13929e04475SThomas Huth''''''''''''''''''''''''''''''' 14029e04475SThomas Huth 14129e04475SThomas HuthReplaced by ``-rtc base=date``. 14229e04475SThomas Huth 1437f697d7bSYanan Wang``-vnc ...,tls=...``, ``-vnc ...,x509=...`` & ``-vnc ...,x509verify=...`` (removed in 3.1) 1447f697d7bSYanan Wang'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 14529e04475SThomas Huth 14629e04475SThomas HuthThe "tls-creds" option should be used instead to point to a "tls-creds-x509" 14729e04475SThomas Huthobject created using "-object". 14829e04475SThomas Huth 14941f421e0SThomas Huth``-mem-path`` fallback to RAM (removed in 5.0) 15041f421e0SThomas Huth'''''''''''''''''''''''''''''''''''''''''''''' 15141f421e0SThomas Huth 15241f421e0SThomas HuthIf guest RAM allocation from file pointed by ``mem-path`` failed, 15341f421e0SThomas HuthQEMU was falling back to allocating from RAM, which might have resulted 15441f421e0SThomas Huthin unpredictable behavior since the backing file specified by the user 15541f421e0SThomas Huthas ignored. Currently, users are responsible for making sure the backing storage 15641f421e0SThomas Huthspecified with ``-mem-path`` can actually provide the guest RAM configured with 15741f421e0SThomas Huth``-m`` and QEMU fails to start up if RAM allocation is unsuccessful. 15841f421e0SThomas Huth 1593d9c7ec9SThomas Huth``-net ...,name=...`` (removed in 5.1) 1603d9c7ec9SThomas Huth'''''''''''''''''''''''''''''''''''''' 1612c5060cdSThomas Huth 1622c5060cdSThomas HuthThe ``name`` parameter of the ``-net`` option was a synonym 1632c5060cdSThomas Huthfor the ``id`` parameter, which should now be used instead. 1642c5060cdSThomas Huth 165662b85aaSMarkus ArmbrusterRISC-V firmware not booted by default (removed in 5.1) 166662b85aaSMarkus Armbruster'''''''''''''''''''''''''''''''''''''''''''''''''''''' 167662b85aaSMarkus Armbruster 168662b85aaSMarkus ArmbrusterQEMU 5.1 changes the default behaviour from ``-bios none`` to ``-bios default`` 169662b85aaSMarkus Armbrusterfor the RISC-V ``virt`` machine and ``sifive_u`` machine. 170662b85aaSMarkus Armbruster 17141f421e0SThomas Huth``-numa node,mem=...`` (removed in 5.1) 17241f421e0SThomas Huth''''''''''''''''''''''''''''''''''''''' 17341f421e0SThomas Huth 17441f421e0SThomas HuthThe parameter ``mem`` of ``-numa node`` was used to assign a part of guest RAM 17541f421e0SThomas Huthto a NUMA node. But when using it, it's impossible to manage a specified RAM 17641f421e0SThomas Huthchunk on the host side (like bind it to a host node, setting bind policy, ...), 17741f421e0SThomas Huthso the guest ends up with the fake NUMA configuration with suboptiomal 17841f421e0SThomas Huthperformance. 17941f421e0SThomas HuthHowever since 2014 there is an alternative way to assign RAM to a NUMA node 18041f421e0SThomas Huthusing parameter ``memdev``, which does the same as ``mem`` and adds 18141f421e0SThomas Huthmeans to actually manage node RAM on the host side. Use parameter ``memdev`` 18241f421e0SThomas Huthwith *memory-backend-ram* backend as replacement for parameter ``mem`` 18341f421e0SThomas Huthto achieve the same fake NUMA effect or a properly configured 18441f421e0SThomas Huth*memory-backend-file* backend to actually benefit from NUMA configuration. 18541f421e0SThomas HuthNew machine versions (since 5.1) will not accept the option but it will still 18641f421e0SThomas Huthwork with old machine types. User can check the QAPI schema to see if the legacy 18741f421e0SThomas Huthoption is supported by looking at MachineInfo::numa-mem-supported property. 18841f421e0SThomas Huth 18941f421e0SThomas Huth``-numa`` node (without memory specified) (removed in 5.2) 19041f421e0SThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 19141f421e0SThomas Huth 19241f421e0SThomas HuthSplitting RAM by default between NUMA nodes had the same issues as ``mem`` 19341f421e0SThomas Huthparameter with the difference that the role of the user plays QEMU using 19441f421e0SThomas Huthimplicit generic or board specific splitting rule. 19541f421e0SThomas HuthUse ``memdev`` with *memory-backend-ram* backend or ``mem`` (if 19641f421e0SThomas Huthit's supported by used machine type) to define mapping explicitly instead. 19741f421e0SThomas HuthUsers of existing VMs, wishing to preserve the same RAM distribution, should 19841f421e0SThomas Huthconfigure it explicitly using ``-numa node,memdev`` options. Current RAM 19941f421e0SThomas Huthdistribution can be retrieved using HMP command ``info numa`` and if separate 20041f421e0SThomas Huthmemory devices (pc|nv-dimm) are present use ``info memory-device`` and subtract 20141f421e0SThomas Huthdevice memory from output of ``info numa``. 20241f421e0SThomas Huth 20341f421e0SThomas Huth``-smp`` (invalid topologies) (removed in 5.2) 20441f421e0SThomas Huth'''''''''''''''''''''''''''''''''''''''''''''' 20541f421e0SThomas Huth 20641f421e0SThomas HuthCPU topology properties should describe whole machine topology including 20741f421e0SThomas Huthpossible CPUs. 20841f421e0SThomas Huth 20941f421e0SThomas HuthHowever, historically it was possible to start QEMU with an incorrect topology 21041f421e0SThomas Huthwhere *n* <= *sockets* * *cores* * *threads* < *maxcpus*, 21141f421e0SThomas Huthwhich could lead to an incorrect topology enumeration by the guest. 21241f421e0SThomas HuthSupport for invalid topologies is removed, the user must ensure 21341f421e0SThomas Huthtopologies described with -smp include all possible cpus, i.e. 21441f421e0SThomas Huth*sockets* * *cores* * *threads* = *maxcpus*. 21541f421e0SThomas Huth 21641f421e0SThomas Huth``-machine enforce-config-section=on|off`` (removed in 5.2) 21741f421e0SThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 21841f421e0SThomas Huth 21941f421e0SThomas HuthThe ``enforce-config-section`` property was replaced by the 22041f421e0SThomas Huth``-global migration.send-configuration={on|off}`` option. 22141f421e0SThomas Huth 2222c5060cdSThomas Huth``-no-kvm`` (removed in 5.2) 2232c5060cdSThomas Huth'''''''''''''''''''''''''''' 2242c5060cdSThomas Huth 2252c5060cdSThomas HuthThe ``-no-kvm`` argument was a synonym for setting ``-machine accel=tcg``. 2262c5060cdSThomas Huth 227c8c9dc42SThomas Huth``-realtime`` (removed in 6.0) 228c8c9dc42SThomas Huth'''''''''''''''''''''''''''''' 229c8c9dc42SThomas Huth 230c8c9dc42SThomas HuthThe ``-realtime mlock=on|off`` argument has been replaced by the 231c8c9dc42SThomas Huth``-overcommit mem-lock=on|off`` argument. 232c8c9dc42SThomas Huth 233e2680403SThomas Huth``-show-cursor`` option (removed in 6.0) 234e2680403SThomas Huth'''''''''''''''''''''''''''''''''''''''' 23590d6a086SThomas Huth 23690d6a086SThomas HuthUse ``-display sdl,show-cursor=on``, ``-display gtk,show-cursor=on`` 23790d6a086SThomas Huthor ``-display default,show-cursor=on`` instead. 23890d6a086SThomas Huth 2392c5060cdSThomas Huth``-tb-size`` option (removed in 6.0) 2402c5060cdSThomas Huth'''''''''''''''''''''''''''''''''''' 2412c5060cdSThomas Huth 2422c5060cdSThomas HuthQEMU 5.0 introduced an alternative syntax to specify the size of the translation 2432c5060cdSThomas Huthblock cache, ``-accel tcg,tb-size=``. 2442c5060cdSThomas Huth 2456db34277SThomas Huth``-usbdevice audio`` (removed in 6.0) 2466db34277SThomas Huth''''''''''''''''''''''''''''''''''''' 2476db34277SThomas Huth 2486db34277SThomas HuthThis option lacked the possibility to specify an audio backend device. 2496db34277SThomas HuthUse ``-device usb-audio`` now instead (and specify a corresponding USB 2506db34277SThomas Huthhost controller or ``-usb`` if necessary). 2516db34277SThomas Huth 2525994dcb8SDaniel P. Berrangé``-vnc acl`` (removed in 6.0) 2535994dcb8SDaniel P. Berrangé''''''''''''''''''''''''''''' 2545994dcb8SDaniel P. Berrangé 2555994dcb8SDaniel P. BerrangéThe ``acl`` option to the ``-vnc`` argument has been replaced 2565994dcb8SDaniel P. Berrangéby the ``tls-authz`` and ``sasl-authz`` options. 2576db34277SThomas Huth 258283d845cSDaniel P. Berrangé``-mon ...,control=readline,pretty=on|off`` (removed in 6.0) 259283d845cSDaniel P. Berrangé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 260283d845cSDaniel P. Berrangé 261283d845cSDaniel P. BerrangéThe ``pretty=on|off`` switch has no effect for HMP monitors and 262283d845cSDaniel P. Berrangéits use is rejected. 263283d845cSDaniel P. Berrangé 264e2cc363bSYanan Wang``-drive file=json:{...{'driver':'file'}}`` (removed in 6.0) 265e2cc363bSYanan Wang'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 2668d17adf3SDaniel P. Berrangé 2678d17adf3SDaniel P. BerrangéThe 'file' driver for drives is no longer appropriate for character or host 2688d17adf3SDaniel P. Berrangédevices and will only accept regular files (S_IFREG). The correct driver 2698d17adf3SDaniel P. Berrangéfor these file types is 'host_cdrom' or 'host_device' as appropriate. 2708d17adf3SDaniel P. Berrangé 27136585e2bSMarkus ArmbrusterFloppy controllers' drive properties (removed in 6.0) 27236585e2bSMarkus Armbruster''''''''''''''''''''''''''''''''''''''''''''''''''''' 27336585e2bSMarkus Armbruster 27436585e2bSMarkus ArmbrusterUse ``-device floppy,...`` instead. When configuring onboard floppy 27536585e2bSMarkus Armbrustercontrollers 27636585e2bSMarkus Armbruster:: 27736585e2bSMarkus Armbruster 27836585e2bSMarkus Armbruster -global isa-fdc.driveA=... 27936585e2bSMarkus Armbruster -global sysbus-fdc.driveA=... 28036585e2bSMarkus Armbruster -global SUNW,fdtwo.drive=... 28136585e2bSMarkus Armbruster 28236585e2bSMarkus Armbrusterbecome 28336585e2bSMarkus Armbruster:: 28436585e2bSMarkus Armbruster 28536585e2bSMarkus Armbruster -device floppy,unit=0,drive=... 28636585e2bSMarkus Armbruster 28736585e2bSMarkus Armbrusterand 28836585e2bSMarkus Armbruster:: 28936585e2bSMarkus Armbruster 29036585e2bSMarkus Armbruster -global isa-fdc.driveB=... 29136585e2bSMarkus Armbruster -global sysbus-fdc.driveB=... 29236585e2bSMarkus Armbruster 29336585e2bSMarkus Armbrusterbecome 29436585e2bSMarkus Armbruster:: 29536585e2bSMarkus Armbruster 29636585e2bSMarkus Armbruster -device floppy,unit=1,drive=... 29736585e2bSMarkus Armbruster 29836585e2bSMarkus ArmbrusterWhen plugging in a floppy controller 29936585e2bSMarkus Armbruster:: 30036585e2bSMarkus Armbruster 30136585e2bSMarkus Armbruster -device isa-fdc,...,driveA=... 30236585e2bSMarkus Armbruster 30336585e2bSMarkus Armbrusterbecomes 30436585e2bSMarkus Armbruster:: 30536585e2bSMarkus Armbruster 30636585e2bSMarkus Armbruster -device isa-fdc,... 30736585e2bSMarkus Armbruster -device floppy,unit=0,drive=... 30836585e2bSMarkus Armbruster 30936585e2bSMarkus Armbrusterand 31036585e2bSMarkus Armbruster:: 31136585e2bSMarkus Armbruster 31236585e2bSMarkus Armbruster -device isa-fdc,...,driveB=... 31336585e2bSMarkus Armbruster 31436585e2bSMarkus Armbrusterbecomes 31536585e2bSMarkus Armbruster:: 31636585e2bSMarkus Armbruster 31736585e2bSMarkus Armbruster -device isa-fdc,... 31836585e2bSMarkus Armbruster -device floppy,unit=1,drive=... 31936585e2bSMarkus Armbruster 320fe9f70a1SMarkus Armbruster``-drive`` with bogus interface type (removed in 6.0) 321fe9f70a1SMarkus Armbruster''''''''''''''''''''''''''''''''''''''''''''''''''''' 322fe9f70a1SMarkus Armbruster 323fe9f70a1SMarkus ArmbrusterDrives with interface types other than ``if=none`` are for onboard 324fe9f70a1SMarkus Armbrusterdevices. Drives the board doesn't pick up can no longer be used with 325fe9f70a1SMarkus Armbruster-device. Use ``if=none`` instead. 326fe9f70a1SMarkus Armbruster 327d2aea775SThomas Huth``-usbdevice ccid`` (removed in 6.0) 328d2aea775SThomas Huth''''''''''''''''''''''''''''''''''''' 329d2aea775SThomas Huth 330d2aea775SThomas HuthThis option was undocumented and not used in the field. 3311662ea9fSPeter MaydellUse ``-device usb-ccid`` instead. 332d2aea775SThomas Huth 333fe86fe23SThomas Huth``-no-quit`` (removed in 7.0) 334fe86fe23SThomas Huth''''''''''''''''''''''''''''' 335fe86fe23SThomas Huth 336fe86fe23SThomas HuthThe ``-no-quit`` was a synonym for ``-display ...,window-close=off`` which 337fe86fe23SThomas Huthshould be used instead. 338fe86fe23SThomas Huth 339c6b310b3SDaniel P. Berrangé``--enable-fips`` (removed in 7.1) 340c6b310b3SDaniel P. Berrangé'''''''''''''''''''''''''''''''''' 341c6b310b3SDaniel P. Berrangé 342c6b310b3SDaniel P. BerrangéThis option restricted usage of certain cryptographic algorithms when 343c6b310b3SDaniel P. Berrangéthe host is operating in FIPS mode. 344c6b310b3SDaniel P. Berrangé 345c6b310b3SDaniel P. BerrangéIf FIPS compliance is required, QEMU should be built with the ``libgcrypt`` 346c6b310b3SDaniel P. Berrangéor ``gnutls`` library enabled as a cryptography provider. 347c6b310b3SDaniel P. Berrangé 348c6b310b3SDaniel P. BerrangéNeither the ``nettle`` library, or the built-in cryptography provider are 349c6b310b3SDaniel P. Berrangésupported on FIPS enabled hosts. 350fe86fe23SThomas Huth 351e960a7eeSPaolo Bonzini``-writeconfig`` (removed in 7.1) 352e960a7eeSPaolo Bonzini''''''''''''''''''''''''''''''''' 353e960a7eeSPaolo Bonzini 354e960a7eeSPaolo BonziniThe ``-writeconfig`` option was not able to serialize the entire contents 355e960a7eeSPaolo Bonziniof the QEMU command line. It is thus considered a failed experiment 356e960a7eeSPaolo Bonziniand removed without a replacement. 357e960a7eeSPaolo Bonzini 35862eb377eSDaniel P. Berrangé``loaded`` property of secret and TLS credential objects (removed in 9.2) 35962eb377eSDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 3600310641cSPaolo Bonzini 3610310641cSPaolo BonziniThe ``loaded=on`` option in the command line or QMP ``object-add`` either had 3620310641cSPaolo Bonzinino effect (if ``loaded`` was the last option) or caused options to be 3630310641cSPaolo Bonzinieffectively ignored as if they were not given. The property is therefore 36462eb377eSDaniel P. Berrangéuseless and has been removed. 3650310641cSPaolo Bonzini 3666e577937SPaolo Bonzini``opened`` property of ``rng-*`` objects (removed in 7.1) 3676e577937SPaolo Bonzini''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 3686e577937SPaolo Bonzini 3696e577937SPaolo BonziniThe ``opened=on`` option in the command line or QMP ``object-add`` either had 3706e577937SPaolo Bonzinino effect (if ``opened`` was the last option) or caused errors. The property 3716e577937SPaolo Bonziniis therefore useless and should simply be removed. 3720310641cSPaolo Bonzini 373a743d60bSThomas Huth``-display sdl,window_close=...`` (removed in 7.1) 374a743d60bSThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''' 375a743d60bSThomas Huth 376a743d60bSThomas HuthUse ``-display sdl,window-close=...`` instead (i.e. with a minus instead of 377a743d60bSThomas Huthan underscore between "window" and "close"). 378a743d60bSThomas Huth 379a743d60bSThomas Huth``-alt-grab`` and ``-display sdl,alt_grab=on`` (removed in 7.1) 380a743d60bSThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 381a743d60bSThomas Huth 382a743d60bSThomas HuthUse ``-display sdl,grab-mod=lshift-lctrl-lalt`` instead. 383a743d60bSThomas Huth 384a743d60bSThomas Huth``-ctrl-grab`` and ``-display sdl,ctrl_grab=on`` (removed in 7.1) 385a743d60bSThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 386a743d60bSThomas Huth 387a743d60bSThomas HuthUse ``-display sdl,grab-mod=rctrl`` instead. 388a743d60bSThomas Huth 389707d93d4SThomas Huth``-sdl`` (removed in 7.1) 390707d93d4SThomas Huth''''''''''''''''''''''''' 391707d93d4SThomas Huth 392707d93d4SThomas HuthUse ``-display sdl`` instead. 393707d93d4SThomas Huth 394707d93d4SThomas Huth``-curses`` (removed in 7.1) 395707d93d4SThomas Huth'''''''''''''''''''''''''''' 396707d93d4SThomas Huth 397707d93d4SThomas HuthUse ``-display curses`` instead. 398707d93d4SThomas Huth 3999878fbf3SThomas HuthCreating sound card devices using ``-soundhw`` (removed in 7.1) 4009878fbf3SThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 4019878fbf3SThomas Huth 4029878fbf3SThomas HuthSound card devices should be created using ``-device`` or ``-audio``. 4039878fbf3SThomas HuthThe exception is ``pcspk`` which can be activated using ``-machine 4049878fbf3SThomas Huthpcspk-audiodev=<name>``. 4059878fbf3SThomas Huth 4061dd1a36dSPhilippe Mathieu-Daudé``-watchdog`` (removed in 7.2) 4071dd1a36dSPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''' 4085433af76SPaolo Bonzini 4095433af76SPaolo BonziniUse ``-device`` instead. 4105433af76SPaolo Bonzini 4111dd1a36dSPhilippe Mathieu-DaudéHexadecimal sizes with scaling multipliers (removed in 8.0) 4121dd1a36dSPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 4138b902e3dSPaolo Bonzini 4148b902e3dSPaolo BonziniInput parameters that take a size value should only use a size suffix 4158b902e3dSPaolo Bonzini(such as 'k' or 'M') when the base is written in decimal, and not when 4168b902e3dSPaolo Bonzinithe value is hexadecimal. That is, '0x20M' should be written either as 4178b902e3dSPaolo Bonzini'32M' or as '0x2000000'. 4188b902e3dSPaolo Bonzini 4196f9f6308SPaolo Bonzini``-chardev`` backend aliases ``tty`` and ``parport`` (removed in 8.0) 4206f9f6308SPaolo Bonzini''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 4216f9f6308SPaolo Bonzini 4226f9f6308SPaolo Bonzini``tty`` and ``parport`` used to be aliases for ``serial`` and ``parallel`` 4236f9f6308SPaolo Bonzinirespectively. The actual backend names should be used instead. 424a743d60bSThomas Huth 425e803a7f9SThomas Huth``-drive if=none`` for the sifive_u OTP device (removed in 8.0) 426e803a7f9SThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 427e803a7f9SThomas Huth 428e803a7f9SThomas HuthUse ``-drive if=pflash`` to configure the OTP device of the sifive_u 429e803a7f9SThomas HuthRISC-V machine instead. 430e803a7f9SThomas Huth 43136debafdSDaniel P. Berrangé``-spice password=string`` (removed in 8.0) 43236debafdSDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''' 43336debafdSDaniel P. Berrangé 43436debafdSDaniel P. BerrangéThis option was insecure because the SPICE password remained visible in 43536debafdSDaniel P. Berrangéthe process listing. This was replaced by the new ``password-secret`` 43636debafdSDaniel P. Berrangéoption which lets the password be securely provided on the command 43736debafdSDaniel P. Berrangéline using a ``secret`` object instance. 438e803a7f9SThomas Huth 43969a80279SPaolo Bonzini``QEMU_AUDIO_`` environment variables and ``-audio-help`` (removed in 8.2) 44069a80279SPaolo Bonzini'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 44169a80279SPaolo Bonzini 44269a80279SPaolo BonziniThe ``-audiodev`` and ``-audio`` command line options are now the only 44369a80279SPaolo Bonziniway to specify audio backend settings. 44469a80279SPaolo Bonzini 44522f84d4fSPaolo BonziniUsing ``-audiodev`` to define the default audio backend (removed in 8.2) 44622f84d4fSPaolo Bonzini'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 44722f84d4fSPaolo Bonzini 44822f84d4fSPaolo BonziniIf no audiodev property is specified, previous versions would use the 44922f84d4fSPaolo Bonzinifirst ``-audiodev`` command line option as a fallback. Starting with 45022f84d4fSPaolo Bonziniversion 8.2, audio backends created with ``-audiodev`` will only be 45122f84d4fSPaolo Bonziniused by clients (sound cards, machines with embedded sound hardware, VNC) 45222f84d4fSPaolo Bonzinithat refer to it in an ``audiodev=`` property. 45322f84d4fSPaolo Bonzini 45422f84d4fSPaolo BonziniIn order to configure a default audio backend, use the ``-audio`` 45522f84d4fSPaolo Bonzinicommand line option without specifying a ``model``; while previous 45622f84d4fSPaolo Bonziniversions of QEMU required a model, starting with version 8.2 45722f84d4fSPaolo BonziniQEMU does not require a model and will not create any sound card 45822f84d4fSPaolo Bonziniin this case. 45922f84d4fSPaolo Bonzini 460c753bf47SPaolo BonziniNote that the default audio backend must be configured on the command 461c753bf47SPaolo Bonziniline if the ``-nodefaults`` options is used. 462c753bf47SPaolo Bonzini 46348c1c25aSThomas Huth``-no-hpet`` (removed in 9.0) 46448c1c25aSThomas Huth''''''''''''''''''''''''''''' 46548c1c25aSThomas Huth 46648c1c25aSThomas HuthThe HPET setting has been turned into a machine property. 46748c1c25aSThomas HuthUse ``-machine hpet=off`` instead. 46848c1c25aSThomas Huth 4694a641010SThomas Huth``-no-acpi`` (removed in 9.0) 4704a641010SThomas Huth''''''''''''''''''''''''''''' 4714a641010SThomas Huth 4724a641010SThomas HuthThe ``-no-acpi`` setting has been turned into a machine property. 4734a641010SThomas HuthUse ``-machine acpi=off`` instead. 47448c1c25aSThomas Huth 4752582489fSThomas Huth``-async-teardown`` (removed in 9.0) 4762582489fSThomas Huth'''''''''''''''''''''''''''''''''''' 4772582489fSThomas Huth 4782582489fSThomas HuthUse ``-run-with async-teardown=on`` instead. 4792582489fSThomas Huth 4801e7886e9SThomas Huth``-chroot`` (removed in 9.0) 4811e7886e9SThomas Huth'''''''''''''''''''''''''''' 4821e7886e9SThomas Huth 4831e7886e9SThomas HuthUse ``-run-with chroot=dir`` instead. 4841e7886e9SThomas Huth 485c61a0d31SPhilippe Mathieu-Daudé``-singlestep`` (removed in 9.0) 486c61a0d31SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''' 487c61a0d31SPhilippe Mathieu-Daudé 488c61a0d31SPhilippe Mathieu-DaudéThe ``-singlestep`` option has been turned into an accelerator property, 489c61a0d31SPhilippe Mathieu-Daudéand given a name that better reflects what it actually does. 490c61a0d31SPhilippe Mathieu-DaudéUse ``-accel tcg,one-insn-per-tb=on`` instead. 491c61a0d31SPhilippe Mathieu-Daudé 49272d346f3SZhao Liu``-smp`` ("parameter=0" SMP configurations) (removed in 9.0) 49372d346f3SZhao Liu'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 49472d346f3SZhao Liu 49572d346f3SZhao LiuSpecified CPU topology parameters must be greater than zero. 49672d346f3SZhao Liu 49772d346f3SZhao LiuIn the SMP configuration, users should either provide a CPU topology 49872d346f3SZhao Liuparameter with a reasonable value (greater than zero) or just omit it 49972d346f3SZhao Liuand QEMU will compute the missing value. 50072d346f3SZhao Liu 50172d346f3SZhao LiuHowever, historically it was implicitly allowed for users to provide 50272d346f3SZhao Liua parameter with zero value, which is meaningless and could also possibly 50372d346f3SZhao Liucause unexpected results in the -smp parsing. So support for this kind of 50472d346f3SZhao Liuconfigurations (e.g. -smp 8,sockets=0) is removed since 9.0, users have 50572d346f3SZhao Liuto ensure that all the topology members described with -smp are greater 50672d346f3SZhao Liuthan zero. 507c61a0d31SPhilippe Mathieu-Daudé 5080222111aSFabiano Rosas``-global migration.decompress-error-check`` (removed in 9.1) 5090222111aSFabiano Rosas''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 5100222111aSFabiano Rosas 5110222111aSFabiano RosasRemoved along with the ``compression`` migration capability. 5120222111aSFabiano Rosas 5131dd1a36dSPhilippe Mathieu-Daudé``-device virtio-blk,scsi=on|off`` (removed in 9.1) 5141dd1a36dSPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''''''''''''''''' 515a271b8d7SPaolo Bonzini 516a271b8d7SPaolo BonziniThe virtio-blk SCSI passthrough feature is a legacy VIRTIO feature. VIRTIO 1.0 517a271b8d7SPaolo Bonziniand later do not support it because the virtio-scsi device was introduced for 518a271b8d7SPaolo Bonzinifull SCSI support. Use virtio-scsi instead when SCSI passthrough is required. 519a271b8d7SPaolo Bonzini 5201dd1a36dSPhilippe Mathieu-Daudé``-fsdev proxy`` and ``-virtfs proxy`` (removed in 9.2) 5211dd1a36dSPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''''''''''''''''''''' 522ed766718SPaolo Bonzini 523ed766718SPaolo BonziniThe 9p ``proxy`` filesystem backend driver was originally developed to 524ed766718SPaolo Bonzinienhance security by dispatching low level filesystem operations from 9p 525ed766718SPaolo Bonziniserver (QEMU process) over to a separate process (the virtfs-proxy-helper 526ed766718SPaolo Bonzinibinary). However the proxy backend was much slower than the local backend, 527ed766718SPaolo Bonzinididn't see any development in years, and showed to be less secure, 528ed766718SPaolo Bonziniespecially due to the fact that its helper daemon must be run as root. 529ed766718SPaolo Bonzini 530ed766718SPaolo BonziniUse ``local``, possibly mapping permissions et al by using its 'mapped' 531ed766718SPaolo Bonzinisecurity model option, or switch to ``virtiofs``. The virtiofs daemon 532ed766718SPaolo Bonzini``virtiofsd`` uses vhost to eliminate the high latency costs of the 9p 533ed766718SPaolo Bonzini``proxy`` backend. 534a271b8d7SPaolo Bonzini 5351dd1a36dSPhilippe Mathieu-Daudé``-portrait`` and ``-rotate`` (removed in 9.2) 5361dd1a36dSPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''' 537f7214f99SPeter Maydell 538f7214f99SPeter MaydellThe ``-portrait`` and ``-rotate`` options were documented as only 539f7214f99SPeter Maydellworking with the PXA LCD device, and all the machine types using 540f7214f99SPeter Maydellthat display device were removed in 9.2, so these options also 541f7214f99SPeter Maydellhave been dropped. 542f7214f99SPeter Maydell 543f7214f99SPeter MaydellThese options were intended to simulate a mobile device being 544f7214f99SPeter Maydellrotated by the user, and had three effects: 545f7214f99SPeter Maydell 546f7214f99SPeter Maydell* the display output was rotated by 90, 180 or 270 degrees 547f7214f99SPeter Maydell* the mouse/trackpad input was rotated the opposite way 548f7214f99SPeter Maydell* the machine model would signal to the guest about its 549f7214f99SPeter Maydell orientation 550f7214f99SPeter Maydell 551f7214f99SPeter MaydellOf these three things, the input-rotation was coded without being 552f7214f99SPeter Maydellrestricted to boards which supported the full set of device-rotation 553f7214f99SPeter Maydellhandling, so in theory the options were usable on other machine models 554f7214f99SPeter Maydellto produce an odd effect (rotating input but not display output). But 555f7214f99SPeter Maydellthis was never intended or documented behaviour, so we have dropped 556f7214f99SPeter Maydellthe options along with the machine models they were intended for. 557f7214f99SPeter Maydell 55800cfbdcbSThomas Huth``-runas`` (removed in 10.0) 55900cfbdcbSThomas Huth'''''''''''''''''''''''''''' 56000cfbdcbSThomas Huth 56100cfbdcbSThomas HuthUse ``-run-with user=..`` instead. 56200cfbdcbSThomas Huth 56300cfbdcbSThomas Huth 564c61a0d31SPhilippe Mathieu-DaudéUser-mode emulator command line arguments 565c61a0d31SPhilippe Mathieu-Daudé----------------------------------------- 566c61a0d31SPhilippe Mathieu-Daudé 567c61a0d31SPhilippe Mathieu-Daudé``-singlestep`` (removed in 9.0) 568c61a0d31SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''' 569c61a0d31SPhilippe Mathieu-Daudé 570c61a0d31SPhilippe Mathieu-DaudéThe ``-singlestep`` option has been given a name that better reflects 571c61a0d31SPhilippe Mathieu-Daudéwhat it actually does. For both linux-user and bsd-user, use the 572c61a0d31SPhilippe Mathieu-Daudé``-one-insn-per-tb`` option instead. 573c61a0d31SPhilippe Mathieu-Daudé 57448c1c25aSThomas Huth 5752c5060cdSThomas HuthQEMU Machine Protocol (QMP) commands 5762c5060cdSThomas Huth------------------------------------ 5772c5060cdSThomas Huth 578e2cc363bSYanan Wang``block-dirty-bitmap-add`` "autoload" parameter (removed in 4.2) 579e2cc363bSYanan Wang'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 5802c5060cdSThomas Huth 5812c5060cdSThomas HuthThe "autoload" parameter has been ignored since 2.12.0. All bitmaps 5822c5060cdSThomas Huthare automatically loaded from qcow2 images. 5832c5060cdSThomas Huth 5842c5060cdSThomas Huth``cpu-add`` (removed in 5.2) 5852c5060cdSThomas Huth'''''''''''''''''''''''''''' 5862c5060cdSThomas Huth 5872c5060cdSThomas HuthUse ``device_add`` for hotplugging vCPUs instead of ``cpu-add``. See 5882c5060cdSThomas Huthdocumentation of ``query-hotpluggable-cpus`` for additional details. 5892c5060cdSThomas Huth 5900afec757SPaolo Bonzini``change`` (removed in 6.0) 5910afec757SPaolo Bonzini''''''''''''''''''''''''''' 5920afec757SPaolo Bonzini 593abea1946SVladimir Sementsov-OgievskiyUse ``blockdev-change-medium`` or ``change-vnc-password`` or 594abea1946SVladimir Sementsov-Ogievskiy``display-update`` instead. 5950afec757SPaolo Bonzini 5968becb360SDaniel P. Berrangé``query-events`` (removed in 6.0) 5978becb360SDaniel P. Berrangé''''''''''''''''''''''''''''''''' 5988becb360SDaniel P. Berrangé 5998becb360SDaniel P. BerrangéThe ``query-events`` command has been superseded by the more powerful 6008becb360SDaniel P. Berrangéand accurate ``query-qmp-schema`` command. 6018becb360SDaniel P. Berrangé 602cbde7be9SDaniel P. Berrangé``migrate_set_cache_size`` and ``query-migrate-cache-size`` (removed in 6.0) 603cbde7be9SDaniel P. Berrangé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 604cbde7be9SDaniel P. Berrangé 605cbde7be9SDaniel P. BerrangéUse ``migrate_set_parameter`` and ``info migrate_parameters`` instead. 606cbde7be9SDaniel P. Berrangé 607cbde7be9SDaniel P. Berrangé``migrate_set_downtime`` and ``migrate_set_speed`` (removed in 6.0) 608cbde7be9SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 609cbde7be9SDaniel P. Berrangé 610cbde7be9SDaniel P. BerrangéUse ``migrate_set_parameter`` instead. 611cbde7be9SDaniel P. Berrangé 6128af54b91SDaniel P. Berrangé``query-cpus`` (removed in 6.0) 6138af54b91SDaniel P. Berrangé''''''''''''''''''''''''''''''' 6148af54b91SDaniel P. Berrangé 6158af54b91SDaniel P. BerrangéThe ``query-cpus`` command is replaced by the ``query-cpus-fast`` command. 6168af54b91SDaniel P. Berrangé 617445a5b40SDaniel P. Berrangé``query-cpus-fast`` ``arch`` output member (removed in 6.0) 618445a5b40SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 619445a5b40SDaniel P. Berrangé 620445a5b40SDaniel P. BerrangéThe ``arch`` output member of the ``query-cpus-fast`` command is 621445a5b40SDaniel P. Berrangéreplaced by the ``target`` output member. 622445a5b40SDaniel P. Berrangé 62324e13a4dSDaniel P. Berrangéchardev client socket with ``wait`` option (removed in 6.0) 62424e13a4dSDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 62524e13a4dSDaniel P. Berrangé 62624e13a4dSDaniel P. BerrangéCharacter devices creating sockets in client mode should not specify 62724e13a4dSDaniel P. Berrangéthe 'wait' field, which is only applicable to sockets in server mode 62824e13a4dSDaniel P. Berrangé 629ad1324e0SDaniel P. Berrangé``query-named-block-nodes`` result ``encryption_key_missing`` (removed in 6.0) 630ad1324e0SDaniel P. Berrangé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 631ad1324e0SDaniel P. Berrangé 632ad1324e0SDaniel P. BerrangéRemoved with no replacement. 633ad1324e0SDaniel P. Berrangé 634ad1324e0SDaniel P. Berrangé``query-block`` result ``inserted.encryption_key_missing`` (removed in 6.0) 635ad1324e0SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 636ad1324e0SDaniel P. Berrangé 637ad1324e0SDaniel P. BerrangéRemoved with no replacement. 638ad1324e0SDaniel P. Berrangé 63981cbfd50SDaniel P. Berrangé``query-named-block-nodes`` and ``query-block`` result dirty-bitmaps[i].status (removed in 6.0) 64081cbfd50SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 64181cbfd50SDaniel P. Berrangé 64281cbfd50SDaniel P. BerrangéThe ``status`` field of the ``BlockDirtyInfo`` structure, returned by 64381cbfd50SDaniel P. Berrangéthese commands is removed. Two new boolean fields, ``recording`` and 64481cbfd50SDaniel P. Berrangé``busy`` effectively replace it. 64581cbfd50SDaniel P. Berrangé 646e67d8e29SDaniel P. Berrangé``query-block`` result field ``dirty-bitmaps`` (removed in 6.0) 647e67d8e29SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 648e67d8e29SDaniel P. Berrangé 649e67d8e29SDaniel P. BerrangéThe ``dirty-bitmaps`` field of the ``BlockInfo`` structure, returned by 650e67d8e29SDaniel P. Berrangéthe query-block command is itself now removed. The ``dirty-bitmaps`` 651e67d8e29SDaniel P. Berrangéfield of the ``BlockDeviceInfo`` struct should be used instead, which is the 652e67d8e29SDaniel P. Berrangétype of the ``inserted`` field in query-block replies, as well as the 653e67d8e29SDaniel P. Berrangétype of array items in query-named-block-nodes. 654e67d8e29SDaniel P. Berrangé 65550243407SKevin Wolf``object-add`` option ``props`` (removed in 6.0) 65650243407SKevin Wolf'''''''''''''''''''''''''''''''''''''''''''''''' 65750243407SKevin Wolf 65850243407SKevin WolfSpecify the properties for the object as top-level arguments instead. 65950243407SKevin Wolf 660fb418b51SPaolo Bonzini``query-sgx`` return value member ``section-size`` (removed in 8.0) 661fb418b51SPaolo Bonzini''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 662fb418b51SPaolo Bonzini 663fb418b51SPaolo BonziniMember ``section-size`` in the return value of ``query-sgx`` 664fb418b51SPaolo Bonziniwas superseded by ``sections``. 665fb418b51SPaolo Bonzini 666fb418b51SPaolo Bonzini 667fb418b51SPaolo Bonzini``query-sgx-capabilities`` return value member ``section-size`` (removed in 8.0) 668fb418b51SPaolo Bonzini'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 669fb418b51SPaolo Bonzini 670fb418b51SPaolo BonziniMember ``section-size`` in the return value of ``query-sgx-capabilities`` 671fb418b51SPaolo Bonziniwas superseded by ``sections``. 672fb418b51SPaolo Bonzini 673f7b1cd3cSFabiano Rosas``query-migrate`` return value member ``skipped`` (removed in 9.1) 674f7b1cd3cSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 675f7b1cd3cSFabiano Rosas 676f7b1cd3cSFabiano RosasMember ``skipped`` of the ``MigrationStats`` struct hasn't been used 677f7b1cd3cSFabiano Rosasfor more than 10 years. Removed with no replacement. 678f7b1cd3cSFabiano Rosas 67961c4e39fSFabiano Rosas``migrate`` command option ``inc`` (removed in 9.1) 68061c4e39fSFabiano Rosas''''''''''''''''''''''''''''''''''''''''''''''''''' 68161c4e39fSFabiano Rosas 68261c4e39fSFabiano RosasUse blockdev-mirror with NBD instead. See "QMP invocation for live 68361c4e39fSFabiano Rosasstorage migration with ``blockdev-mirror`` + NBD" in 68461c4e39fSFabiano Rosasdocs/interop/live-block-operations.rst for a detailed explanation. 68561c4e39fSFabiano Rosas 68618d154f5SFabiano Rosas``migrate`` command option ``blk`` (removed in 9.1) 68718d154f5SFabiano Rosas''''''''''''''''''''''''''''''''''''''''''''''''''' 68818d154f5SFabiano Rosas 68918d154f5SFabiano RosasUse blockdev-mirror with NBD instead. See "QMP invocation for live 69018d154f5SFabiano Rosasstorage migration with ``blockdev-mirror`` + NBD" in 69118d154f5SFabiano Rosasdocs/interop/live-block-operations.rst for a detailed explanation. 69218d154f5SFabiano Rosas 693eef0bae3SFabiano Rosas``migrate-set-capabilities`` ``block`` option (removed in 9.1) 694eef0bae3SFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 695eef0bae3SFabiano Rosas 696eef0bae3SFabiano RosasBlock migration has been removed. For a replacement, see "QMP 697eef0bae3SFabiano Rosasinvocation for live storage migration with ``blockdev-mirror`` + NBD" 698eef0bae3SFabiano Rosasin docs/interop/live-block-operations.rst. 699eef0bae3SFabiano Rosas 7000222111aSFabiano Rosas``migrate-set-parameter`` ``compress-level`` option (removed in 9.1) 7010222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7020222111aSFabiano Rosas 7030222111aSFabiano RosasUse ``multifd-zlib-level`` or ``multifd-zstd-level`` instead. 7040222111aSFabiano Rosas 7050222111aSFabiano Rosas``migrate-set-parameter`` ``compress-threads`` option (removed in 9.1) 7060222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7070222111aSFabiano Rosas 7080222111aSFabiano RosasUse ``multifd-channels`` instead. 7090222111aSFabiano Rosas 7100222111aSFabiano Rosas``migrate-set-parameter`` ``compress-wait-thread`` option (removed in 9.1) 7110222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7120222111aSFabiano Rosas 7130222111aSFabiano RosasRemoved with no replacement. 7140222111aSFabiano Rosas 7150222111aSFabiano Rosas``migrate-set-parameter`` ``decompress-threads`` option (removed in 9.1) 7160222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7170222111aSFabiano Rosas 7180222111aSFabiano RosasUse ``multifd-channels`` instead. 7190222111aSFabiano Rosas 7200222111aSFabiano Rosas``migrate-set-capability`` ``compress`` option (removed in 9.1) 7210222111aSFabiano Rosas''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7220222111aSFabiano Rosas 7230222111aSFabiano RosasUse ``multifd-compression`` instead. 7240222111aSFabiano Rosas 725428d1789SMarkus ArmbrusterIncorrectly typed ``device_add`` arguments (since 9.2) 726428d1789SMarkus Armbruster'''''''''''''''''''''''''''''''''''''''''''''''''''''' 727428d1789SMarkus Armbruster 728428d1789SMarkus ArmbrusterDue to shortcomings in the internal implementation of ``device_add``, 729428d1789SMarkus ArmbrusterQEMU used to incorrectly accept certain invalid arguments. Any object 730428d1789SMarkus Armbrusteror list arguments were silently ignored. Other argument types were not 731428d1789SMarkus Armbrusterchecked, but an implicit conversion happened, so that e.g. string 732428d1789SMarkus Armbrustervalues could be assigned to integer device properties or vice versa. 733428d1789SMarkus Armbruster 7340f910b87SPhilippe Mathieu-DaudéQEMU Machine Protocol (QMP) events 7350f910b87SPhilippe Mathieu-Daudé---------------------------------- 7360f910b87SPhilippe Mathieu-Daudé 7370f910b87SPhilippe Mathieu-Daudé``MEM_UNPLUG_ERROR`` (removed in 9.1) 7380f910b87SPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''' 7390f910b87SPhilippe Mathieu-Daudé 7400f910b87SPhilippe Mathieu-DaudéMEM_UNPLUG_ERROR has been replaced by the more generic ``DEVICE_UNPLUG_GUEST_ERROR`` event. 7410f910b87SPhilippe Mathieu-Daudé 7427ffc4894SPhilippe Mathieu-Daudé``vcpu`` trace events (removed in 9.1) 7437ffc4894SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''' 7447ffc4894SPhilippe Mathieu-Daudé 7457ffc4894SPhilippe Mathieu-DaudéThe ability to instrument QEMU helper functions with vCPU-aware trace 7467ffc4894SPhilippe Mathieu-Daudépoints was removed in 7.0. 7477ffc4894SPhilippe Mathieu-Daudé 7480f910b87SPhilippe Mathieu-Daudé 7492c5060cdSThomas HuthHuman Monitor Protocol (HMP) commands 7502c5060cdSThomas Huth------------------------------------- 7512c5060cdSThomas Huth 7525d82c101SThomas Huth``usb_add`` and ``usb_remove`` (removed in 2.12) 7535d82c101SThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''' 7545d82c101SThomas Huth 7555d82c101SThomas HuthReplaced by ``device_add`` and ``device_del`` (use ``device_add help`` for a 7565d82c101SThomas Huthlist of available devices). 7575d82c101SThomas Huth 7585d82c101SThomas Huth``host_net_add`` and ``host_net_remove`` (removed in 2.12) 7595d82c101SThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7605d82c101SThomas Huth 7615d82c101SThomas HuthReplaced by ``netdev_add`` and ``netdev_del``. 7625d82c101SThomas Huth 7632c5060cdSThomas HuthThe ``hub_id`` parameter of ``hostfwd_add`` / ``hostfwd_remove`` (removed in 5.0) 7642c5060cdSThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7652c5060cdSThomas Huth 7662c5060cdSThomas HuthThe ``[hub_id name]`` parameter tuple of the 'hostfwd_add' and 7672c5060cdSThomas Huth'hostfwd_remove' HMP commands has been replaced by ``netdev_id``. 7682c5060cdSThomas Huth 7692c5060cdSThomas Huth``cpu-add`` (removed in 5.2) 7702c5060cdSThomas Huth'''''''''''''''''''''''''''' 7712c5060cdSThomas Huth 7722c5060cdSThomas HuthUse ``device_add`` for hotplugging vCPUs instead of ``cpu-add``. See 7732c5060cdSThomas Huthdocumentation of ``query-hotpluggable-cpus`` for additional details. 7742c5060cdSThomas Huth 775cfb5387aSPaolo Bonzini``change vnc TARGET`` (removed in 6.0) 776cfb5387aSPaolo Bonzini'''''''''''''''''''''''''''''''''''''' 777cfb5387aSPaolo Bonzini 778cfb5387aSPaolo BonziniNo replacement. The ``change vnc password`` and ``change DEVICE MEDIUM`` 779cfb5387aSPaolo Bonzinicommands are not affected. 780cfb5387aSPaolo Bonzini 7815994dcb8SDaniel P. Berrangé``acl_show``, ``acl_reset``, ``acl_policy``, ``acl_add``, ``acl_remove`` (removed in 6.0) 7825994dcb8SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 7835994dcb8SDaniel P. Berrangé 7845994dcb8SDaniel P. BerrangéThe ``acl_show``, ``acl_reset``, ``acl_policy``, ``acl_add``, and 7855994dcb8SDaniel P. Berrangé``acl_remove`` commands were removed with no replacement. Authorization 7865994dcb8SDaniel P. Berrangéfor VNC should be performed using the pluggable QAuthZ objects. 7875994dcb8SDaniel P. Berrangé 788cbde7be9SDaniel P. Berrangé``migrate-set-cache-size`` and ``info migrate-cache-size`` (removed in 6.0) 789cbde7be9SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 790cbde7be9SDaniel P. Berrangé 791cbde7be9SDaniel P. BerrangéUse ``migrate-set-parameters`` and ``info migrate-parameters`` instead. 792cbde7be9SDaniel P. Berrangé 793cbde7be9SDaniel P. Berrangé``migrate_set_downtime`` and ``migrate_set_speed`` (removed in 6.0) 794cbde7be9SDaniel P. Berrangé''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 795cbde7be9SDaniel P. Berrangé 796cbde7be9SDaniel P. BerrangéUse ``migrate-set-parameters`` instead. 797cbde7be9SDaniel P. Berrangé 798ca24b0b9SBruno Larsen (billionai)``info cpustats`` (removed in 6.1) 799ca24b0b9SBruno Larsen (billionai)'''''''''''''''''''''''''''''''''' 800ca24b0b9SBruno Larsen (billionai) 801ca24b0b9SBruno Larsen (billionai)This command didn't produce any output already. Removed with no replacement. 802ca24b0b9SBruno Larsen (billionai) 80397b6e1d3SPhilippe Mathieu-Daudé``singlestep`` (removed in 9.0) 80497b6e1d3SPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''' 80597b6e1d3SPhilippe Mathieu-Daudé 80697b6e1d3SPhilippe Mathieu-DaudéThe ``singlestep`` command has been replaced by the ``one-insn-per-tb`` 80797b6e1d3SPhilippe Mathieu-Daudécommand, which has the same behaviour but a less misleading name. 80897b6e1d3SPhilippe Mathieu-Daudé 80961c4e39fSFabiano Rosas``migrate`` command ``-i`` option (removed in 9.1) 81061c4e39fSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''' 81161c4e39fSFabiano Rosas 81261c4e39fSFabiano RosasUse blockdev-mirror with NBD instead. See "QMP invocation for live 81361c4e39fSFabiano Rosasstorage migration with ``blockdev-mirror`` + NBD" in 81461c4e39fSFabiano Rosasdocs/interop/live-block-operations.rst for a detailed explanation. 81561c4e39fSFabiano Rosas 81618d154f5SFabiano Rosas``migrate`` command ``-b`` option (removed in 9.1) 81718d154f5SFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''' 81818d154f5SFabiano Rosas 81918d154f5SFabiano RosasUse blockdev-mirror with NBD instead. See "QMP invocation for live 82018d154f5SFabiano Rosasstorage migration with ``blockdev-mirror`` + NBD" in 82118d154f5SFabiano Rosasdocs/interop/live-block-operations.rst for a detailed explanation. 82218d154f5SFabiano Rosas 823eef0bae3SFabiano Rosas``migrate_set_capability`` ``block`` option (removed in 9.1) 824eef0bae3SFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 825eef0bae3SFabiano Rosas 826eef0bae3SFabiano RosasBlock migration has been removed. For a replacement, see "QMP 827eef0bae3SFabiano Rosasinvocation for live storage migration with ``blockdev-mirror`` + NBD" 828eef0bae3SFabiano Rosasin docs/interop/live-block-operations.rst. 829eef0bae3SFabiano Rosas 8300222111aSFabiano Rosas``migrate_set_parameter`` ``compress-level`` option (removed in 9.1) 8310222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 8320222111aSFabiano Rosas 8330222111aSFabiano RosasUse ``multifd-zlib-level`` or ``multifd-zstd-level`` instead. 8340222111aSFabiano Rosas 8350222111aSFabiano Rosas``migrate_set_parameter`` ``compress-threads`` option (removed in 9.1) 8360222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 8370222111aSFabiano Rosas 8380222111aSFabiano RosasUse ``multifd-channels`` instead. 8390222111aSFabiano Rosas 8400222111aSFabiano Rosas``migrate_set_parameter`` ``compress-wait-thread`` option (removed in 9.1) 8410222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 8420222111aSFabiano Rosas 8430222111aSFabiano RosasRemoved with no replacement. 8440222111aSFabiano Rosas 8450222111aSFabiano Rosas``migrate_set_parameter`` ``decompress-threads`` option (removed in 9.1) 8460222111aSFabiano Rosas'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 8470222111aSFabiano Rosas 8480222111aSFabiano RosasUse ``multifd-channels`` instead. 8490222111aSFabiano Rosas 8500222111aSFabiano Rosas``migrate_set_capability`` ``compress`` option (removed in 9.1) 8510222111aSFabiano Rosas''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 8520222111aSFabiano Rosas 8530222111aSFabiano RosasUse ``multifd-compression`` instead. 8540222111aSFabiano Rosas 85534fabc85SPeter MaydellHost Architectures 85634fabc85SPeter Maydell------------------ 85734fabc85SPeter Maydell 85834fabc85SPeter MaydellSystem emulation on 32-bit Windows hosts (removed in 9.0) 85934fabc85SPeter Maydell''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 86034fabc85SPeter Maydell 86134fabc85SPeter MaydellWindows 11 has no support for 32-bit host installs, and Windows 10 did 86234fabc85SPeter Maydellnot support new 32-bit installs, only upgrades. 32-bit Windows support 86334fabc85SPeter Maydellhas now been dropped by the MSYS2 project. QEMU also is deprecating 86434fabc85SPeter Maydelland dropping support for 32-bit x86 host deployments in 86534fabc85SPeter Maydellgeneral. 32-bit Windows is therefore no longer a supported host for 86634fabc85SPeter MaydellQEMU. Since all recent x86 hardware from the past >10 years is 86734fabc85SPeter Maydellcapable of the 64-bit x86 extensions, a corresponding 64-bit OS should 86834fabc85SPeter Maydellbe used instead. 86934fabc85SPeter Maydell 870f3ca7ca2SRichard Henderson32-bit hosts for 64-bit guests (removed in 10.0) 871f3ca7ca2SRichard Henderson'''''''''''''''''''''''''''''''''''''''''''''''' 872f3ca7ca2SRichard Henderson 873f3ca7ca2SRichard HendersonIn general, 32-bit hosts cannot support the memory space or atomicity 874f3ca7ca2SRichard Hendersonrequirements of 64-bit guests. Prior to 10.0, QEMU attempted to 875f3ca7ca2SRichard Hendersonwork around the atomicity issues in system mode by running all vCPUs 876f3ca7ca2SRichard Hendersonin a single thread context; in user mode atomicity was simply broken. 877f3ca7ca2SRichard HendersonFrom 10.0, QEMU has disabled configuration of 64-bit guests on 32-bit hosts. 878f3ca7ca2SRichard Henderson 8792c5060cdSThomas HuthGuest Emulator ISAs 8802c5060cdSThomas Huth------------------- 8812c5060cdSThomas Huth 8822c5060cdSThomas HuthRISC-V ISA privilege specification version 1.09.1 (removed in 5.1) 8832c5060cdSThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 8842c5060cdSThomas Huth 8852c5060cdSThomas HuthThe RISC-V ISA privilege specification version 1.09.1 has been removed. 8862c5060cdSThomas HuthQEMU supports both the newer version 1.10.0 and the ratified version 1.11.0, these 8872c5060cdSThomas Huthshould be used instead of the 1.09.1 version. 8882c5060cdSThomas Huth 8892c5060cdSThomas HuthSystem emulator CPUS 8902c5060cdSThomas Huth-------------------- 8912c5060cdSThomas Huth 8922c5060cdSThomas HuthKVM guest support on 32-bit Arm hosts (removed in 5.2) 8932c5060cdSThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''''''' 8942c5060cdSThomas Huth 8952c5060cdSThomas HuthThe Linux kernel has dropped support for allowing 32-bit Arm systems 8969d3f8b32SPaolo Bonzinito host KVM guests as of the 5.7 kernel, and was thus removed from QEMU 8979d3f8b32SPaolo Bonzinias well. Running 32-bit guests on a 64-bit Arm host remains supported. 8982c5060cdSThomas Huth 8992c5060cdSThomas HuthRISC-V ISA Specific CPUs (removed in 5.1) 9002c5060cdSThomas Huth''''''''''''''''''''''''''''''''''''''''' 9012c5060cdSThomas Huth 9022c5060cdSThomas HuthThe RISC-V cpus with the ISA version in the CPU name have been removed. The 9032c5060cdSThomas Huthfour CPUs are: ``rv32gcsu-v1.9.1``, ``rv32gcsu-v1.10.0``, ``rv64gcsu-v1.9.1`` and 9042c5060cdSThomas Huth``rv64gcsu-v1.10.0``. Instead the version can be specified via the CPU ``priv_spec`` 9052c5060cdSThomas Huthoption when using the ``rv32`` or ``rv64`` CPUs. 9062c5060cdSThomas Huth 9072c5060cdSThomas HuthRISC-V no MMU CPUs (removed in 5.1) 9082c5060cdSThomas Huth''''''''''''''''''''''''''''''''''' 9092c5060cdSThomas Huth 9102c5060cdSThomas HuthThe RISC-V no MMU cpus have been removed. The two CPUs: ``rv32imacu-nommu`` and 9112c5060cdSThomas Huth``rv64imacu-nommu`` can no longer be used. Instead the MMU status can be specified 9122c5060cdSThomas Huthvia the CPU ``mmu`` option when using the ``rv32`` or ``rv64`` CPUs. 9132c5060cdSThomas Huth 914a058b895SGreg Kurz``compat`` property of server class POWER CPUs (removed in 6.0) 915a058b895SGreg Kurz''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 916a058b895SGreg Kurz 917a058b895SGreg KurzThe ``max-cpu-compat`` property of the ``pseries`` machine type should be used 918a058b895SGreg Kurzinstead. 919a058b895SGreg Kurz 920875bb7e3SThomas Huth``moxie`` CPU (removed in 6.1) 921875bb7e3SThomas Huth'''''''''''''''''''''''''''''' 922875bb7e3SThomas Huth 923875bb7e3SThomas HuthNobody was using this CPU emulation in QEMU, and there were no test images 924875bb7e3SThomas Huthavailable to make sure that the code is still working, so it has been removed 925875bb7e3SThomas Huthwithout replacement. 926875bb7e3SThomas Huth 927e2cc363bSYanan Wang``lm32`` CPUs (removed in 6.1) 928e2cc363bSYanan Wang'''''''''''''''''''''''''''''' 9299d49bcf6SMarkus Armbruster 9309d49bcf6SMarkus ArmbrusterThe only public user of this architecture was the milkymist project, 9319d49bcf6SMarkus Armbrusterwhich has been dead for years; there was never an upstream Linux 9329d49bcf6SMarkus Armbrusterport. Removed without replacement. 9339d49bcf6SMarkus Armbruster 934e2cc363bSYanan Wang``unicore32`` CPUs (removed in 6.1) 935e2cc363bSYanan Wang''''''''''''''''''''''''''''''''''' 93643692239SMarkus Armbruster 93743692239SMarkus ArmbrusterSupport for this CPU was removed from the upstream Linux kernel, and 93843692239SMarkus Armbrusterthere is no available upstream toolchain to build binaries for it. 93943692239SMarkus ArmbrusterRemoved without replacement. 94043692239SMarkus Armbruster 9416df39f5eSRobert Hoox86 ``Icelake-Client`` CPU (removed in 7.1) 9426df39f5eSRobert Hoo''''''''''''''''''''''''''''''''''''''''''' 9436df39f5eSRobert Hoo 9446df39f5eSRobert HooThere isn't ever Icelake Client CPU, it is some wrong and imaginary one. 9456df39f5eSRobert HooUse ``Icelake-Server`` instead. 9466df39f5eSRobert Hoo 9476c301485SPhilippe Mathieu-DaudéNios II CPU (removed in 9.1) 9486c301485SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''' 9496c301485SPhilippe Mathieu-Daudé 9506c301485SPhilippe Mathieu-DaudéQEMU Nios II architecture was orphan; Intel has EOL'ed the Nios II 9516c301485SPhilippe Mathieu-Daudéprocessor IP (see `Intel discontinuance notification`_). 9526c301485SPhilippe Mathieu-Daudé 95344e4075bSPhilippe Mathieu-DaudéCRIS CPU architecture (removed in 9.2) 95444e4075bSPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''' 95544e4075bSPhilippe Mathieu-Daudé 95644e4075bSPhilippe Mathieu-DaudéThe CRIS architecture was pulled from Linux in 4.17 and the compiler 95744e4075bSPhilippe Mathieu-Daudéwas no longer packaged in any distro making it harder to run the 95844e4075bSPhilippe Mathieu-Daudé``check-tcg`` tests. 95944e4075bSPhilippe Mathieu-Daudé 960662b85aaSMarkus ArmbrusterRISC-V 'any' CPU type ``-cpu any`` (removed in 9.2) 961662b85aaSMarkus Armbruster''''''''''''''''''''''''''''''''''''''''''''''''''' 962662b85aaSMarkus Armbruster 963662b85aaSMarkus ArmbrusterThe 'any' CPU type was introduced back in 2018 and was around since the 964662b85aaSMarkus Armbrusterinitial RISC-V QEMU port. Its usage was always been unclear: users don't know 965662b85aaSMarkus Armbrusterwhat to expect from a CPU called 'any', and in fact the CPU does not do anything 966662b85aaSMarkus Armbrusterspecial that isn't already done by the default CPUs rv32/rv64. 967662b85aaSMarkus Armbruster 968eaaaf8abSPaolo BonziniSystem accelerators 969eaaaf8abSPaolo Bonzini------------------- 970eaaaf8abSPaolo Bonzini 971b91b0fc1SPhilippe Mathieu-DaudéUserspace local APIC with KVM (x86, removed in 8.0) 972b91b0fc1SPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''''''''''''''''' 973eaaaf8abSPaolo Bonzini 974eaaaf8abSPaolo Bonzini``-M kernel-irqchip=off`` cannot be used on KVM if the CPU model includes 975eaaaf8abSPaolo Bonzinia local APIC. The ``split`` setting is supported, as is using ``-M 976eaaaf8abSPaolo Bonzinikernel-irqchip=off`` when the CPU does not have a local APIC. 977eaaaf8abSPaolo Bonzini 978a8448735SPaolo BonziniMIPS "Trap-and-Emulate" KVM support (removed in 8.0) 979a8448735SPaolo Bonzini'''''''''''''''''''''''''''''''''''''''''''''''''''' 980a8448735SPaolo Bonzini 981a8448735SPaolo BonziniThe MIPS "Trap-and-Emulate" KVM host and guest support was removed 982a8448735SPaolo Bonzinifrom Linux in 2021, and is not supported anymore by QEMU either. 983a8448735SPaolo Bonzini 984662b85aaSMarkus ArmbrusterHAXM (``-accel hax``) (removed in 8.2) 985662b85aaSMarkus Armbruster'''''''''''''''''''''''''''''''''''''' 986662b85aaSMarkus Armbruster 987662b85aaSMarkus ArmbrusterThe HAXM project has been retired (see https://github.com/intel/haxm#status). 988662b85aaSMarkus ArmbrusterUse "whpx" (on Windows) or "hvf" (on macOS) instead. 989662b85aaSMarkus Armbruster 9902c5060cdSThomas HuthSystem emulator machines 9912c5060cdSThomas Huth------------------------ 9922c5060cdSThomas Huth 99383e256c0SDaniel P. BerrangéVersioned machine types (aarch64, arm, i386, m68k, ppc64, s390x, x86_64) 99483e256c0SDaniel P. Berrangé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 99583e256c0SDaniel P. Berrangé 99683e256c0SDaniel P. BerrangéIn accordance with our versioned machine type deprecation policy, all machine 99783e256c0SDaniel P. Berrangétypes with version |VER_MACHINE_DELETION_VERSION|, or older, have been 99883e256c0SDaniel P. Berrangéremoved. 9996f9a1a01SThomas Huth 100036b50899SThomas Huth``s390-virtio`` (removed in 2.6) 100136b50899SThomas Huth'''''''''''''''''''''''''''''''' 100236b50899SThomas Huth 100336b50899SThomas HuthUse the ``s390-ccw-virtio`` machine instead. 100436b50899SThomas Huth 100536b50899SThomas HuthThe m68k ``dummy`` machine (removed in 2.9) 100636b50899SThomas Huth''''''''''''''''''''''''''''''''''''''''''' 100736b50899SThomas Huth 100836b50899SThomas HuthUse the ``none`` machine with the ``loader`` device instead. 100936b50899SThomas Huth 101036b50899SThomas Huth``xlnx-ep108`` (removed in 3.0) 101136b50899SThomas Huth''''''''''''''''''''''''''''''' 101236b50899SThomas Huth 101336b50899SThomas HuthThe EP108 was an early access development board that is no longer used. 101436b50899SThomas HuthUse the ``xlnx-zcu102`` machine instead. 101536b50899SThomas Huth 10162c5060cdSThomas Huth``spike_v1.9.1`` and ``spike_v1.10`` (removed in 5.1) 10172c5060cdSThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''' 10182c5060cdSThomas Huth 10192c5060cdSThomas HuthThe version specific Spike machines have been removed in favour of the 10202c5060cdSThomas Huthgeneric ``spike`` machine. If you need to specify an older version of the RISC-V 10212c5060cdSThomas Huthspec you can use the ``-cpu rv64gcsu,priv_spec=v1.10.0`` command line argument. 10222c5060cdSThomas Huth 10232c5060cdSThomas Huthmips ``r4k`` platform (removed in 5.2) 10242c5060cdSThomas Huth'''''''''''''''''''''''''''''''''''''' 10252c5060cdSThomas Huth 10262c5060cdSThomas HuthThis machine type was very old and unmaintained. Users should use the ``malta`` 10272c5060cdSThomas Huthmachine type instead. 10282c5060cdSThomas Huth 1029cd669e20SPhilippe Mathieu-Daudémips ``fulong2e`` machine alias (removed in 6.0) 1030cd669e20SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''''' 1031cd669e20SPhilippe Mathieu-Daudé 1032cd669e20SPhilippe Mathieu-DaudéThis machine has been renamed ``fuloong2e``. 1033cd669e20SPhilippe Mathieu-Daudé 103457469ed3SPhilippe Mathieu-DaudéRaspberry Pi ``raspi2`` and ``raspi3`` machines (removed in 6.2) 103557469ed3SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 103657469ed3SPhilippe Mathieu-Daudé 103757469ed3SPhilippe Mathieu-DaudéThe Raspberry Pi machines come in various models (A, A+, B, B+). To be able 103857469ed3SPhilippe Mathieu-Daudéto distinguish which model QEMU is implementing, the ``raspi2`` and ``raspi3`` 103957469ed3SPhilippe Mathieu-Daudémachines have been renamed ``raspi2b`` and ``raspi3b``. 104057469ed3SPhilippe Mathieu-Daudé 104150f97a0eSJoel StanleyAspeed ``swift-bmc`` machine (removed in 7.0) 104250f97a0eSJoel Stanley''''''''''''''''''''''''''''''''''''''''''''' 104350f97a0eSJoel Stanley 104450f97a0eSJoel StanleyThis machine was removed because it was unused. Alternative AST2500 based 104550f97a0eSJoel StanleyOpenPOWER machines are ``witherspoon-bmc`` and ``romulus-bmc``. 10462cc1a901SThomas Huth 10471335caf3SCédric Le Goaterppc ``taihu`` machine (removed in 7.2) 10481335caf3SCédric Le Goater''''''''''''''''''''''''''''''''''''''''''''' 10491335caf3SCédric Le Goater 10501335caf3SCédric Le GoaterThis machine was removed because it was partially emulated and 405 10511335caf3SCédric Le Goatermachines are very similar. Use the ``ref405ep`` machine instead. 10521335caf3SCédric Le Goater 10536c301485SPhilippe Mathieu-DaudéNios II ``10m50-ghrd`` and ``nios2-generic-nommu`` machines (removed in 9.1) 10546c301485SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 10556c301485SPhilippe Mathieu-Daudé 10566c301485SPhilippe Mathieu-DaudéThe Nios II architecture was orphan. 10576c301485SPhilippe Mathieu-Daudé 10580ea0538fSPhilippe Mathieu-Daudé``shix`` (removed in 9.2) 10590ea0538fSPhilippe Mathieu-Daudé''''''''''''''''''''''''' 10600ea0538fSPhilippe Mathieu-Daudé 10610ea0538fSPhilippe Mathieu-DaudéThe machine was unmaintained. 10620ea0538fSPhilippe Mathieu-Daudé 106321c1270fSPeter MaydellArm machines ``akita``, ``borzoi``, ``cheetah``, ``connex``, ``mainstone``, ``n800``, ``n810``, ``spitz``, ``terrier``, ``tosa``, ``verdex``, ``z2`` (removed in 9.2) 106421c1270fSPeter Maydell''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 106521c1270fSPeter Maydell 106621c1270fSPeter MaydellQEMU included models of some machine types where the QEMU code that 106721c1270fSPeter Maydellemulates their SoCs was very old and unmaintained. This code was 106821c1270fSPeter Maydellblocking our ability to move forward with various changes across 106921c1270fSPeter Maydellthe codebase, and over many years nobody has been interested in 107021c1270fSPeter Maydelltrying to modernise it. We don't expect any of these machines to have 107121c1270fSPeter Maydella large number of users, because they're all modelling hardware that 107221c1270fSPeter Maydellhas now passed away into history. We are therefore dropping support 107321c1270fSPeter Maydellfor all machine types using the PXA2xx and OMAP2 SoCs. We are also 107421c1270fSPeter Maydelldropping the ``cheetah`` OMAP1 board, because we don't have any 107521c1270fSPeter Maydelltest images for it and don't know of anybody who does. 107621c1270fSPeter Maydell 1077662b85aaSMarkus ArmbrusterAspeed ``tacoma-bmc`` machine (removed in 10.0) 1078662b85aaSMarkus Armbruster''''''''''''''''''''''''''''''''''''''''''''''' 1079662b85aaSMarkus Armbruster 1080662b85aaSMarkus ArmbrusterThe ``tacoma-bmc`` machine was removed because it didn't bring much 1081662b85aaSMarkus Armbrustercompared to the ``rainier-bmc`` machine. Also, the ``tacoma-bmc`` was 1082662b85aaSMarkus Armbrustera board used for bring up of the AST2600 SoC that never left the 1083662b85aaSMarkus Armbrusterlabs. It can be easily replaced by the ``rainier-bmc`` machine, which 1084662b85aaSMarkus Armbrusterwas the actual final product, or by the ``ast2600-evb`` with some 1085662b85aaSMarkus Armbrustertweaks. 1086662b85aaSMarkus Armbruster 1087e7dba30eSCédric Le Goaterppc ``ref405ep`` machine (removed in 10.0) 1088e7dba30eSCédric Le Goater'''''''''''''''''''''''''''''''''''''''''' 1089e7dba30eSCédric Le Goater 1090e7dba30eSCédric Le GoaterThis machine was removed because PPC 405 CPU have no known users, 1091e7dba30eSCédric Le Goaterfirmware images are not available, OpenWRT dropped support in 2019, 1092e7dba30eSCédric Le GoaterU-Boot in 2017, and Linux in 2024. 1093e7dba30eSCédric Le Goater 1094*0e259fa5SThomas HuthBig-Endian variants of ``petalogix-ml605`` and ``xlnx-zynqmp-pmu`` machines (removed in 10.1) 1095*0e259fa5SThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 1096*0e259fa5SThomas Huth 1097*0e259fa5SThomas HuthBoth the MicroBlaze ``petalogix-ml605`` and ``xlnx-zynqmp-pmu`` machines 1098*0e259fa5SThomas Huthwere added for little endian CPUs. Big endian support was never tested 1099*0e259fa5SThomas Huthand likely never worked. Starting with QEMU v10.1, the machines are now 1100*0e259fa5SThomas Huthonly available as little-endian machines. 1101*0e259fa5SThomas Huth 1102*0e259fa5SThomas Huth 11032cc1a901SThomas Huthlinux-user mode CPUs 11042cc1a901SThomas Huth-------------------- 11052cc1a901SThomas Huth 11062cc1a901SThomas Huth``tilegx`` CPUs (removed in 6.0) 11072cc1a901SThomas Huth'''''''''''''''''''''''''''''''' 11082cc1a901SThomas Huth 11092cc1a901SThomas HuthThe ``tilegx`` guest CPU support has been removed without replacement. It was 11102cc1a901SThomas Huthonly implemented in linux-user mode, but support for this CPU was removed from 11112cc1a901SThomas Huththe upstream Linux kernel in 2018, and it has also been dropped from glibc, so 11122cc1a901SThomas Huththere is no new Linux development taking place with this architecture. For 11132cc1a901SThomas Huthrunning the old binaries, you can use older versions of QEMU. 11142cc1a901SThomas Huth 111574154d7eSThomas Huth``ppc64abi32`` CPUs (removed in 7.0) 111674154d7eSThomas Huth'''''''''''''''''''''''''''''''''''' 111774154d7eSThomas Huth 111874154d7eSThomas HuthThe ``ppc64abi32`` architecture has a number of issues which regularly 111974154d7eSThomas Huthtripped up the CI testing and was suspected to be quite broken. For that 112074154d7eSThomas Huthreason the maintainers strongly suspected no one actually used it. 112174154d7eSThomas Huth 11226c301485SPhilippe Mathieu-Daudé``nios2`` CPU (removed in 9.1) 11236c301485SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''' 11246c301485SPhilippe Mathieu-Daudé 11256c301485SPhilippe Mathieu-DaudéQEMU Nios II architecture was orphan; Intel has EOL'ed the Nios II 11266c301485SPhilippe Mathieu-Daudéprocessor IP (see `Intel discontinuance notification`_). 112774154d7eSThomas Huth 1128d9a6bad5SAlex BennéeTCG introspection features 1129d9a6bad5SAlex Bennée-------------------------- 1130d9a6bad5SAlex Bennée 1131b4859e8fSPhilippe Mathieu-DaudéTCG trace-events (removed in 7.0) 1132b4859e8fSPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''' 1133d9a6bad5SAlex Bennée 1134d9a6bad5SAlex BennéeThe ability to add new TCG trace points had bit rotted and as the 1135d9a6bad5SAlex Bennéefeature can be replicated with TCG plugins it was removed. If 1136d9a6bad5SAlex Bennéeany user is currently using this feature and needs help with 1137d9a6bad5SAlex Bennéeconverting to using TCG plugins they should contact the qemu-devel 1138d9a6bad5SAlex Bennéemailing list. 1139d9a6bad5SAlex Bennée 1140d9a6bad5SAlex Bennée 1141b5010183SDaniel P. BerrangéSystem emulator devices 1142b5010183SDaniel P. Berrangé----------------------- 1143b5010183SDaniel P. Berrangé 11445643fcddSThomas Huth``spapr-pci-vfio-host-bridge`` (removed in 2.12) 11455643fcddSThomas Huth''''''''''''''''''''''''''''''''''''''''''''''''' 11465643fcddSThomas Huth 11475643fcddSThomas HuthThe ``spapr-pci-vfio-host-bridge`` device type has been replaced by the 11485643fcddSThomas Huth``spapr-pci-host-bridge`` device type. 11495643fcddSThomas Huth 11505643fcddSThomas Huth``ivshmem`` (removed in 4.0) 11515643fcddSThomas Huth'''''''''''''''''''''''''''' 11525643fcddSThomas Huth 11535643fcddSThomas HuthReplaced by either the ``ivshmem-plain`` or ``ivshmem-doorbell``. 11545643fcddSThomas Huth 1155b5010183SDaniel P. Berrangé``ide-drive`` (removed in 6.0) 1156b5010183SDaniel P. Berrangé'''''''''''''''''''''''''''''' 1157b5010183SDaniel P. Berrangé 1158b5010183SDaniel P. BerrangéThe 'ide-drive' device has been removed. Users should use 'ide-hd' or 1159b5010183SDaniel P. Berrangé'ide-cd' as appropriate to get an IDE hard disk or CD-ROM as needed. 11602cc1a901SThomas Huth 1161879be3afSDaniel P. Berrangé``scsi-disk`` (removed in 6.0) 1162879be3afSDaniel P. Berrangé'''''''''''''''''''''''''''''' 1163879be3afSDaniel P. Berrangé 1164879be3afSDaniel P. BerrangéThe 'scsi-disk' device has been removed. Users should use 'scsi-hd' or 1165879be3afSDaniel P. Berrangé'scsi-cd' as appropriate to get a SCSI hard disk or CD-ROM as needed. 1166879be3afSDaniel P. Berrangé 1167b482fb43SThomas Huth``sga`` (removed in 8.0) 1168b482fb43SThomas Huth'''''''''''''''''''''''' 1169b482fb43SThomas Huth 1170b482fb43SThomas HuthThe ``sga`` device loaded an option ROM for x86 targets which enabled 1171b482fb43SThomas HuthSeaBIOS to send messages to the serial console. SeaBIOS 1.11.0 onwards 1172b482fb43SThomas Huthcontains native support for this feature and thus use of the option 1173b482fb43SThomas HuthROM approach was obsolete. The native SeaBIOS support can be activated 1174b482fb43SThomas Huthby using ``-machine graphics=off``. 1175b482fb43SThomas Huth 11761dfd42c4SPhilippe Mathieu-Daudé``pvrdma`` and the RDMA subsystem (removed in 9.1) 11771dfd42c4SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''''''' 11781dfd42c4SPhilippe Mathieu-Daudé 11791dfd42c4SPhilippe Mathieu-DaudéThe 'pvrdma' device and the whole RDMA subsystem have been removed. 1180b482fb43SThomas Huth 11812c5060cdSThomas HuthRelated binaries 11822c5060cdSThomas Huth---------------- 11832c5060cdSThomas Huth 11842c5060cdSThomas Huth``qemu-nbd --partition`` (removed in 5.0) 11852c5060cdSThomas Huth''''''''''''''''''''''''''''''''''''''''' 11862c5060cdSThomas Huth 11872c5060cdSThomas HuthThe ``qemu-nbd --partition $digit`` code (also spelled ``-P``) 11882c5060cdSThomas Huthcould only handle MBR partitions, and never correctly handled logical 11892c5060cdSThomas Huthpartitions beyond partition 5. Exporting a partition can still be 11902c5060cdSThomas Huthdone by utilizing the ``--image-opts`` option with a raw blockdev 11912c5060cdSThomas Huthusing the ``offset`` and ``size`` parameters layered on top of 11922c5060cdSThomas Huthany other existing blockdev. For example, if partition 1 is 100MiB 11932c5060cdSThomas Huthlong starting at 1MiB, the old command:: 11942c5060cdSThomas Huth 11952c5060cdSThomas Huth qemu-nbd -t -P 1 -f qcow2 file.qcow2 11962c5060cdSThomas Huth 11972c5060cdSThomas Huthcan be rewritten as:: 11982c5060cdSThomas Huth 11992c5060cdSThomas Huth qemu-nbd -t --image-opts driver=raw,offset=1M,size=100M,file.driver=qcow2,file.file.driver=file,file.file.filename=file.qcow2 12002c5060cdSThomas Huth 12012c5060cdSThomas Huth``qemu-img convert -n -o`` (removed in 5.1) 12022c5060cdSThomas Huth''''''''''''''''''''''''''''''''''''''''''' 12032c5060cdSThomas Huth 12042c5060cdSThomas HuthAll options specified in ``-o`` are image creation options, so 12052c5060cdSThomas Huththey are now rejected when used with ``-n`` to skip image creation. 12062c5060cdSThomas Huth 12072c5060cdSThomas Huth 12082c5060cdSThomas Huth``qemu-img create -b bad file $size`` (removed in 5.1) 12092c5060cdSThomas Huth'''''''''''''''''''''''''''''''''''''''''''''''''''''' 12102c5060cdSThomas Huth 12112c5060cdSThomas HuthWhen creating an image with a backing file that could not be opened, 12122c5060cdSThomas Huth``qemu-img create`` used to issue a warning about the failure but 12132c5060cdSThomas Huthproceed with the image creation if an explicit size was provided. 12142c5060cdSThomas HuthHowever, as the ``-u`` option exists for this purpose, it is safer to 12152c5060cdSThomas Huthenforce that any failure to open the backing image (including if the 12162c5060cdSThomas Huthbacking file is missing or an incorrect format was specified) is an 12172c5060cdSThomas Hutherror when ``-u`` is not used. 12182c5060cdSThomas Huth 1219c5ba6219SPhilippe Mathieu-Daudé``qemu-img amend`` to adjust backing file (removed in 6.1) 1220c5ba6219SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 12215a385bf5SEric Blake 12225a385bf5SEric BlakeThe use of ``qemu-img amend`` to modify the name or format of a qcow2 12235a385bf5SEric Blakebacking image was never fully documented or tested, and interferes 12245a385bf5SEric Blakewith other amend operations that need access to the original backing 12255a385bf5SEric Blakeimage (such as deciding whether a v3 zero cluster may be left 12265a385bf5SEric Blakeunallocated when converting to a v2 image). Any changes to the 12275a385bf5SEric Blakebacking chain should be performed with ``qemu-img rebase -u`` either 12285a385bf5SEric Blakebefore or after the remaining changes being performed by amend, as 12295a385bf5SEric Blakeappropriate. 12305a385bf5SEric Blake 1231c5ba6219SPhilippe Mathieu-Daudé``qemu-img`` backing file without format (removed in 6.1) 1232c5ba6219SPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 1233497a30dbSEric Blake 1234497a30dbSEric BlakeThe use of ``qemu-img create``, ``qemu-img rebase``, or ``qemu-img 1235497a30dbSEric Blakeconvert`` to create or modify an image that depends on a backing file 1236497a30dbSEric Blakenow requires that an explicit backing format be provided. This is 1237497a30dbSEric Blakefor safety: if QEMU probes a different format than what you thought, 1238497a30dbSEric Blakethe data presented to the guest will be corrupt; similarly, presenting 1239497a30dbSEric Blakea raw image to a guest allows a potential security exploit if a future 1240497a30dbSEric Blakeprobe sees a non-raw image based on guest writes. 1241497a30dbSEric Blake 1242497a30dbSEric BlakeTo avoid creating unsafe backing chains, you must pass ``-o 1243497a30dbSEric Blakebacking_fmt=`` (or the shorthand ``-F`` during create) to specify the 1244497a30dbSEric Blakeintended backing format. You may use ``qemu-img rebase -u`` to 1245497a30dbSEric Blakeretroactively add a backing format to an existing image. However, be 1246497a30dbSEric Blakeaware that there are already potential security risks to blindly using 1247497a30dbSEric Blake``qemu-img info`` to probe the format of an untrusted backing image, 1248497a30dbSEric Blakewhen deciding what format to add into an existing image. 1249497a30dbSEric Blake 12502c5060cdSThomas HuthBlock devices 12512c5060cdSThomas Huth------------- 12522c5060cdSThomas Huth 12532c5060cdSThomas HuthVXHS backend (removed in 5.1) 12542c5060cdSThomas Huth''''''''''''''''''''''''''''' 12552c5060cdSThomas Huth 12562c5060cdSThomas HuthThe VXHS code did not compile since v2.12.0. It was removed in 5.1. 125709ec8517SMarkus Armbruster 125809ec8517SMarkus Armbruster``sheepdog`` driver (removed in 6.0) 125909ec8517SMarkus Armbruster'''''''''''''''''''''''''''''''''''' 126009ec8517SMarkus Armbruster 126109ec8517SMarkus ArmbrusterThe corresponding upstream server project is no longer maintained. 126209ec8517SMarkus ArmbrusterUsers are recommended to switch to an alternative distributed block 126309ec8517SMarkus Armbrusterdevice driver such as RBD. 1264a6bfdaedSDr. David Alan Gilbert 1265a6bfdaedSDr. David Alan GilbertTools 1266a6bfdaedSDr. David Alan Gilbert----- 1267a6bfdaedSDr. David Alan Gilbert 1268a6bfdaedSDr. David Alan Gilbertvirtiofsd (removed in 8.0) 1269a6bfdaedSDr. David Alan Gilbert'''''''''''''''''''''''''' 1270a6bfdaedSDr. David Alan Gilbert 1271a6bfdaedSDr. David Alan GilbertThere is a newer Rust implementation of ``virtiofsd`` at 1272a6bfdaedSDr. David Alan Gilbert``https://gitlab.com/virtio-fs/virtiofsd``; this has been 1273a6bfdaedSDr. David Alan Gilbertstable for some time and is now widely used. 1274a6bfdaedSDr. David Alan GilbertThe command line and feature set is very close to the removed 1275a6bfdaedSDr. David Alan GilbertC implementation. 1276a6bfdaedSDr. David Alan Gilbert 1277a7a2d636SPhilippe Mathieu-DaudéQEMU guest agent 1278a7a2d636SPhilippe Mathieu-Daudé---------------- 1279a7a2d636SPhilippe Mathieu-Daudé 1280a7a2d636SPhilippe Mathieu-Daudé``--blacklist`` command line option (removed in 9.1) 1281a7a2d636SPhilippe Mathieu-Daudé'''''''''''''''''''''''''''''''''''''''''''''''''''' 1282a7a2d636SPhilippe Mathieu-Daudé 1283a7a2d636SPhilippe Mathieu-Daudé``--blacklist`` has been replaced by ``--block-rpcs`` (which is a better 1284a7a2d636SPhilippe Mathieu-Daudéwording for what this option does). The short form ``-b`` still stays 1285a7a2d636SPhilippe Mathieu-Daudéthe same and thus is the preferred way for scripts that should run with 1286a7a2d636SPhilippe Mathieu-Daudéboth, older and future versions of QEMU. 1287a7a2d636SPhilippe Mathieu-Daudé 1288a7a2d636SPhilippe Mathieu-Daudé``blacklist`` config file option (removed in 9.1) 1289a7a2d636SPhilippe Mathieu-Daudé''''''''''''''''''''''''''''''''''''''''''''''''' 1290a7a2d636SPhilippe Mathieu-Daudé 1291a7a2d636SPhilippe Mathieu-DaudéThe ``blacklist`` config file option has been renamed to ``block-rpcs`` 1292a7a2d636SPhilippe Mathieu-Daudé(to be in sync with the renaming of the corresponding command line 1293a7a2d636SPhilippe Mathieu-Daudéoption). 1294a7a2d636SPhilippe Mathieu-Daudé 12956c301485SPhilippe Mathieu-Daudé.. _Intel discontinuance notification: https://www.intel.com/content/www/us/en/content-details/781327/intel-is-discontinuing-ip-ordering-codes-listed-in-pdn2312-for-nios-ii-ip.html 1296