docs/system/removed-features.rst

   1
   2 Removed features
   3 ================
   4
   5 What follows is a record of recently removed, formerly deprecated
   6 features that serves as a record for users who have encountered
   7 trouble after a recent upgrade.
   8
   9 System emulator command line arguments
  10 --------------------------------------
  11
  12 ``-net ...,name=``\ *name* (removed in 5.1)
  13 '''''''''''''''''''''''''''''''''''''''''''
  14
  15 The ``name`` parameter of the ``-net`` option was a synonym
  16 for the ``id`` parameter, which should now be used instead.
  17
  18 ``-no-kvm`` (removed in 5.2)
  19 ''''''''''''''''''''''''''''
  20
  21 The ``-no-kvm`` argument was a synonym for setting ``-machine accel=tcg``.
  22
  23 ``-realtime`` (removed in 6.0)
  24 ''''''''''''''''''''''''''''''
  25
  26 The ``-realtime mlock=on|off`` argument has been replaced by the
  27 ``-overcommit mem-lock=on|off`` argument.
  28
  29 ``-show-cursor`` option (removed in 6.0)
  30 ''''''''''''''''''''''''''''''''''''''''
  31
  32 Use ``-display sdl,show-cursor=on``, ``-display gtk,show-cursor=on``
  33 or ``-display default,show-cursor=on`` instead.
  34
  35 ``-tb-size`` option (removed in 6.0)
  36 ''''''''''''''''''''''''''''''''''''
  37
  38 QEMU 5.0 introduced an alternative syntax to specify the size of the translation
  39 block cache, ``-accel tcg,tb-size=``.
  40
  41 ``-usbdevice audio`` (removed in 6.0)
  42 '''''''''''''''''''''''''''''''''''''
  43
  44 This option lacked the possibility to specify an audio backend device.
  45 Use ``-device usb-audio`` now instead (and specify a corresponding USB
  46 host controller or ``-usb`` if necessary).
  47
  48 ``-vnc acl`` (removed in 6.0)
  49 '''''''''''''''''''''''''''''
  50
  51 The ``acl`` option to the ``-vnc`` argument has been replaced
  52 by the ``tls-authz`` and ``sasl-authz`` options.
  53
  54 ``-mon ...,control=readline,pretty=on|off`` (removed in 6.0)
  55 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
  56
  57 The ``pretty=on|off`` switch has no effect for HMP monitors and
  58 its use is rejected.
  59
  60 ``-drive file=json:{...{'driver':'file'}}`` (removed 6.0)
  61 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''
  62
  63 The 'file' driver for drives is no longer appropriate for character or host
  64 devices and will only accept regular files (S_IFREG). The correct driver
  65 for these file types is 'host_cdrom' or 'host_device' as appropriate.
  66
  67 QEMU Machine Protocol (QMP) commands
  68 ------------------------------------
  69
  70 ``block-dirty-bitmap-add`` "autoload" parameter (removed in 4.2.0)
  71 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
  72
  73 The "autoload" parameter has been ignored since 2.12.0. All bitmaps
  74 are automatically loaded from qcow2 images.
  75
  76 ``cpu-add`` (removed in 5.2)
  77 ''''''''''''''''''''''''''''
  78
  79 Use ``device_add`` for hotplugging vCPUs instead of ``cpu-add``.  See
  80 documentation of ``query-hotpluggable-cpus`` for additional details.
  81
  82 ``change`` (removed in 6.0)
  83 '''''''''''''''''''''''''''
  84
  85 Use ``blockdev-change-medium`` or ``change-vnc-password`` instead.
  86
  87 ``query-events`` (removed in 6.0)
  88 '''''''''''''''''''''''''''''''''
  89
  90 The ``query-events`` command has been superseded by the more powerful
  91 and accurate ``query-qmp-schema`` command.
  92
  93 ``migrate_set_cache_size`` and ``query-migrate-cache-size`` (removed in 6.0)
  94 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
  95
  96 Use ``migrate_set_parameter`` and ``info migrate_parameters`` instead.
  97
  98 ``migrate_set_downtime`` and ``migrate_set_speed`` (removed in 6.0)
  99 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 100
 101 Use ``migrate_set_parameter`` instead.
 102
 103 ``query-cpus`` (removed in 6.0)
 104 '''''''''''''''''''''''''''''''
 105
 106 The ``query-cpus`` command is replaced by the ``query-cpus-fast`` command.
 107
 108 ``query-cpus-fast`` ``arch`` output member (removed in 6.0)
 109 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 110
 111 The ``arch`` output member of the ``query-cpus-fast`` command is
 112 replaced by the ``target`` output member.
 113
 114 chardev client socket with ``wait`` option (removed in 6.0)
 115 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 116
 117 Character devices creating sockets in client mode should not specify
 118 the 'wait' field, which is only applicable to sockets in server mode
 119
 120 ``query-named-block-nodes`` result ``encryption_key_missing`` (removed in 6.0)
 121 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 122
 123 Removed with no replacement.
 124
 125 ``query-block`` result ``inserted.encryption_key_missing`` (removed in 6.0)
 126 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 127
 128 Removed with no replacement.
 129
 130 ``query-named-block-nodes`` and ``query-block`` result dirty-bitmaps[i].status (removed in 6.0)
 131 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 132
 133 The ``status`` field of the ``BlockDirtyInfo`` structure, returned by
 134 these commands is removed. Two new boolean fields, ``recording`` and
 135 ``busy`` effectively replace it.
 136
 137 ``query-block`` result field ``dirty-bitmaps`` (removed in 6.0)
 138 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 139
 140 The ``dirty-bitmaps`` field of the ``BlockInfo`` structure, returned by
 141 the query-block command is itself now removed. The ``dirty-bitmaps``
 142 field of the ``BlockDeviceInfo`` struct should be used instead, which is the
 143 type of the ``inserted`` field in query-block replies, as well as the
 144 type of array items in query-named-block-nodes.
 145
 146 Human Monitor Protocol (HMP) commands
 147 -------------------------------------
 148
 149 The ``hub_id`` parameter of ``hostfwd_add`` / ``hostfwd_remove`` (removed in 5.0)
 150 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 151
 152 The ``[hub_id name]`` parameter tuple of the 'hostfwd_add' and
 153 'hostfwd_remove' HMP commands has been replaced by ``netdev_id``.
 154
 155 ``cpu-add`` (removed in 5.2)
 156 ''''''''''''''''''''''''''''
 157
 158 Use ``device_add`` for hotplugging vCPUs instead of ``cpu-add``.  See
 159 documentation of ``query-hotpluggable-cpus`` for additional details.
 160
 161 ``change vnc TARGET`` (removed in 6.0)
 162 ''''''''''''''''''''''''''''''''''''''
 163
 164 No replacement.  The ``change vnc password`` and ``change DEVICE MEDIUM``
 165 commands are not affected.
 166
 167 ``acl_show``, ``acl_reset``, ``acl_policy``, ``acl_add``, ``acl_remove`` (removed in 6.0)
 168 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 169
 170 The ``acl_show``, ``acl_reset``, ``acl_policy``, ``acl_add``, and
 171 ``acl_remove`` commands were removed with no replacement. Authorization
 172 for VNC should be performed using the pluggable QAuthZ objects.
 173
 174 ``migrate-set-cache-size`` and ``info migrate-cache-size`` (removed in 6.0)
 175 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 176
 177 Use ``migrate-set-parameters`` and ``info migrate-parameters`` instead.
 178
 179 ``migrate_set_downtime`` and ``migrate_set_speed`` (removed in 6.0)
 180 '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 181
 182 Use ``migrate-set-parameters`` instead.
 183
 184 Guest Emulator ISAs
 185 -------------------
 186
 187 RISC-V ISA privilege specification version 1.09.1 (removed in 5.1)
 188 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 189
 190 The RISC-V ISA privilege specification version 1.09.1 has been removed.
 191 QEMU supports both the newer version 1.10.0 and the ratified version 1.11.0, these
 192 should be used instead of the 1.09.1 version.
 193
 194 System emulator CPUS
 195 --------------------
 196
 197 KVM guest support on 32-bit Arm hosts (removed in 5.2)
 198 ''''''''''''''''''''''''''''''''''''''''''''''''''''''
 199
 200 The Linux kernel has dropped support for allowing 32-bit Arm systems
 201 to host KVM guests as of the 5.7 kernel. Accordingly, QEMU is deprecating
 202 its support for this configuration and will remove it in a future version.
 203 Running 32-bit guests on a 64-bit Arm host remains supported.
 204
 205 RISC-V ISA Specific CPUs (removed in 5.1)
 206 '''''''''''''''''''''''''''''''''''''''''
 207
 208 The RISC-V cpus with the ISA version in the CPU name have been removed. The
 209 four CPUs are: ``rv32gcsu-v1.9.1``, ``rv32gcsu-v1.10.0``, ``rv64gcsu-v1.9.1`` and
 210 ``rv64gcsu-v1.10.0``. Instead the version can be specified via the CPU ``priv_spec``
 211 option when using the ``rv32`` or ``rv64`` CPUs.
 212
 213 RISC-V no MMU CPUs (removed in 5.1)
 214 '''''''''''''''''''''''''''''''''''
 215
 216 The RISC-V no MMU cpus have been removed. The two CPUs: ``rv32imacu-nommu`` and
 217 ``rv64imacu-nommu`` can no longer be used. Instead the MMU status can be specified
 218 via the CPU ``mmu`` option when using the ``rv32`` or ``rv64`` CPUs.
 219
 220 System emulator machines
 221 ------------------------
 222
 223 ``spike_v1.9.1`` and ``spike_v1.10`` (removed in 5.1)
 224 '''''''''''''''''''''''''''''''''''''''''''''''''''''
 225
 226 The version specific Spike machines have been removed in favour of the
 227 generic ``spike`` machine. If you need to specify an older version of the RISC-V
 228 spec you can use the ``-cpu rv64gcsu,priv_spec=v1.10.0`` command line argument.
 229
 230 mips ``r4k`` platform (removed in 5.2)
 231 ''''''''''''''''''''''''''''''''''''''
 232
 233 This machine type was very old and unmaintained. Users should use the ``malta``
 234 machine type instead.
 235
 236 mips ``fulong2e`` machine alias (removed in 6.0)
 237 ''''''''''''''''''''''''''''''''''''''''''''''''
 238
 239 This machine has been renamed ``fuloong2e``.
 240
 241 ``pc-1.0``, ``pc-1.1``, ``pc-1.2`` and ``pc-1.3`` (removed in 6.0)
 242 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 243
 244 These machine types were very old and likely could not be used for live
 245 migration from old QEMU versions anymore. Use a newer machine type instead.
 246
 247
 248 linux-user mode CPUs
 249 --------------------
 250
 251 ``tilegx`` CPUs (removed in 6.0)
 252 ''''''''''''''''''''''''''''''''
 253
 254 The ``tilegx`` guest CPU support has been removed without replacement. It was
 255 only implemented in linux-user mode, but support for this CPU was removed from
 256 the upstream Linux kernel in 2018, and it has also been dropped from glibc, so
 257 there is no new Linux development taking place with this architecture. For
 258 running the old binaries, you can use older versions of QEMU.
 259
 260 System emulator devices
 261 -----------------------
 262
 263 ``ide-drive`` (removed in 6.0)
 264 ''''''''''''''''''''''''''''''
 265
 266 The 'ide-drive' device has been removed. Users should use 'ide-hd' or
 267 'ide-cd' as appropriate to get an IDE hard disk or CD-ROM as needed.
 268
 269 ``scsi-disk`` (removed in 6.0)
 270 ''''''''''''''''''''''''''''''
 271
 272 The 'scsi-disk' device has been removed. Users should use 'scsi-hd' or
 273 'scsi-cd' as appropriate to get a SCSI hard disk or CD-ROM as needed.
 274
 275 Related binaries
 276 ----------------
 277
 278 ``qemu-nbd --partition`` (removed in 5.0)
 279 '''''''''''''''''''''''''''''''''''''''''
 280
 281 The ``qemu-nbd --partition $digit`` code (also spelled ``-P``)
 282 could only handle MBR partitions, and never correctly handled logical
 283 partitions beyond partition 5.  Exporting a partition can still be
 284 done by utilizing the ``--image-opts`` option with a raw blockdev
 285 using the ``offset`` and ``size`` parameters layered on top of
 286 any other existing blockdev. For example, if partition 1 is 100MiB
 287 long starting at 1MiB, the old command::
 288
 289   qemu-nbd -t -P 1 -f qcow2 file.qcow2
 290
 291 can be rewritten as::
 292
 293   qemu-nbd -t --image-opts driver=raw,offset=1M,size=100M,file.driver=qcow2,file.file.driver=file,file.file.filename=file.qcow2
 294
 295 ``qemu-img convert -n -o`` (removed in 5.1)
 296 '''''''''''''''''''''''''''''''''''''''''''
 297
 298 All options specified in ``-o`` are image creation options, so
 299 they are now rejected when used with ``-n`` to skip image creation.
 300
 301
 302 ``qemu-img create -b bad file $size`` (removed in 5.1)
 303 ''''''''''''''''''''''''''''''''''''''''''''''''''''''
 304
 305 When creating an image with a backing file that could not be opened,
 306 ``qemu-img create`` used to issue a warning about the failure but
 307 proceed with the image creation if an explicit size was provided.
 308 However, as the ``-u`` option exists for this purpose, it is safer to
 309 enforce that any failure to open the backing image (including if the
 310 backing file is missing or an incorrect format was specified) is an
 311 error when ``-u`` is not used.
 312
 313 Command line options
 314 --------------------
 315
 316 ``-smp`` (invalid topologies) (removed 5.2)
 317 '''''''''''''''''''''''''''''''''''''''''''
 318
 319 CPU topology properties should describe whole machine topology including
 320 possible CPUs.
 321
 322 However, historically it was possible to start QEMU with an incorrect topology
 323 where *n* <= *sockets* * *cores* * *threads* < *maxcpus*,
 324 which could lead to an incorrect topology enumeration by the guest.
 325 Support for invalid topologies is removed, the user must ensure
 326 topologies described with -smp include all possible cpus, i.e.
 327 *sockets* * *cores* * *threads* = *maxcpus*.
 328
 329 ``-numa`` node (without memory specified) (removed 5.2)
 330 '''''''''''''''''''''''''''''''''''''''''''''''''''''''
 331
 332 Splitting RAM by default between NUMA nodes had the same issues as ``mem``
 333 parameter with the difference that the role of the user plays QEMU using
 334 implicit generic or board specific splitting rule.
 335 Use ``memdev`` with *memory-backend-ram* backend or ``mem`` (if
 336 it's supported by used machine type) to define mapping explicitly instead.
 337 Users of existing VMs, wishing to preserve the same RAM distribution, should
 338 configure it explicitly using ``-numa node,memdev`` options. Current RAM
 339 distribution can be retrieved using HMP command ``info numa`` and if separate
 340 memory devices (pc|nv-dimm) are present use ``info memory-device`` and subtract
 341 device memory from output of ``info numa``.
 342
 343 ``-numa node,mem=``\ *size* (removed in 5.1)
 344 ''''''''''''''''''''''''''''''''''''''''''''
 345
 346 The parameter ``mem`` of ``-numa node`` was used to assign a part of
 347 guest RAM to a NUMA node. But when using it, it's impossible to manage a specified
 348 RAM chunk on the host side (like bind it to a host node, setting bind policy, ...),
 349 so the guest ends up with the fake NUMA configuration with suboptiomal performance.
 350 However since 2014 there is an alternative way to assign RAM to a NUMA node
 351 using parameter ``memdev``, which does the same as ``mem`` and adds
 352 means to actually manage node RAM on the host side. Use parameter ``memdev``
 353 with *memory-backend-ram* backend as replacement for parameter ``mem``
 354 to achieve the same fake NUMA effect or a properly configured
 355 *memory-backend-file* backend to actually benefit from NUMA configuration.
 356 New machine versions (since 5.1) will not accept the option but it will still
 357 work with old machine types. User can check the QAPI schema to see if the legacy
 358 option is supported by looking at MachineInfo::numa-mem-supported property.
 359
 360 ``-mem-path`` fallback to RAM (removed in 5.0)
 361 ''''''''''''''''''''''''''''''''''''''''''''''
 362
 363 If guest RAM allocation from file pointed by ``mem-path`` failed,
 364 QEMU was falling back to allocating from RAM, which might have resulted
 365 in unpredictable behavior since the backing file specified by the user
 366 as ignored. Currently, users are responsible for making sure the backing storage
 367 specified with ``-mem-path`` can actually provide the guest RAM configured with
 368 ``-m`` and QEMU fails to start up if RAM allocation is unsuccessful.
 369
 370 ``-smp`` (invalid topologies) (removed 5.2)
 371 '''''''''''''''''''''''''''''''''''''''''''
 372
 373 CPU topology properties should describe whole machine topology including
 374 possible CPUs.
 375
 376 However, historically it was possible to start QEMU with an incorrect topology
 377 where *n* <= *sockets* * *cores* * *threads* < *maxcpus*,
 378 which could lead to an incorrect topology enumeration by the guest.
 379 Support for invalid topologies is removed, the user must ensure
 380 topologies described with -smp include all possible cpus, i.e.
 381 *sockets* * *cores* * *threads* = *maxcpus*.
 382
 383 ``-machine enforce-config-section=on|off`` (removed 5.2)
 384 ''''''''''''''''''''''''''''''''''''''''''''''''''''''''
 385
 386 The ``enforce-config-section`` property was replaced by the
 387 ``-global migration.send-configuration={on|off}`` option.
 388
 389 Block devices
 390 -------------
 391
 392 VXHS backend (removed in 5.1)
 393 '''''''''''''''''''''''''''''
 394
 395 The VXHS code did not compile since v2.12.0. It was removed in 5.1.