xref: /qemu/docs/about/removed-features.rst (revision 0e259fa5a13a3d0ff65aa4199b1e03832e51e1b2)
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