【QEMU中文文档】1.3 弃用功能

本文由 AI 翻译（ChatGPT-4）完成，并由作者进行人工校对。如有任何问题或建议，欢迎联系我。联系方式：[email protected]。

原文：Deprecated features — QEMU documentation

通常情况下，一旦某个功能引入到 QEMU 中，就计划无限期地支持它。如果需要移除某个功能，将会在本节中列出。该功能将在被弃用的发布版本和下一个发布版本中保持功能性。在这两个版本之后，该功能可能会被移除。被弃用的功能在 QEMU 启动时也可能会在控制台上生成警告，或者在通过监视器命令激活时生成警告，但这不是强制要求。

在 2.10.0 版本发布之前，没有关于功能在被移除之前会被弃用多长时间的官方政策，也没有记录哪些功能已被弃用的文档列表。因此，在 2.10.0 版本之前弃用的任何功能将被视为它们是在 2.10.0 版本中首次被弃用。

以下是当前标记为弃用的所有功能列表。

系统仿真器命令行参数

短形布尔选项（自 6.0 版起）

布尔选项（例如 share=on / share=off）可以简写为 share 和 noshare。现在已被弃用，并将引发警告。

delay 套接字字符设备选项（自 6.0 版起）

nodelay 的短格式布尔选项的替代形式是 nodelay=on，而不是 delay=off。

插件参数通过 arg=传递（自 6.1 版起）

通过 arg= 传递 TCG 插件参数是多余的，会使命令行变得不易读，特别是当参数本身包含名称和值时，例如 -plugin plugin_name,arg="arg_name=arg_value"。因此，使用 arg 是多余的。单词参数被视为短形式布尔值，并传递给插件作为 arg_name=on。然而，短形式布尔值已被弃用，更倾向于完全显式的 arg_name=on 形式。

-smp （不支持“parameter=1” SMP 配置）（自 9.0 起）

指定的 CPU 拓扑参数必须得到机器的支持。在 SMP 配置中，用户应提供目标机器支持的 CPU 拓扑参数。然而，历史上允许用户将不支持的拓扑参数指定为“1”，这是没有意义的。因此，对这种配置（例如，对于 x86 PC 机器的 -smp drawers=1, books=1, clusters=1）的支持自 9.0 版本以来已被标记为不推荐使用。用户必须确保所有使用 -smp 描述的拓扑成员都受到目标机器的支持。

-runas （自 9.1 版起）

请使用-run-with user=..替代。

用户模式仿真器命令行参数

-p （自 9.0 版起）

-p 选项假装控制主机页面大小。但是，无法更改主机页面大小，仅使用该选项会导致失败。

QEMU 机器协议（QMP）命令

blockdev-open-tray 和 blockdev-close-tray 参数 device（自 2.8 版起）

请使用参数 id。

eject 参数 device（自 2.8 版起）

请使用参数 id。

blockdev-change-medium 参数 device（自 2.8 版起）

请使用参数 id。

block_set_io_throttle 参数 device（自 2.8 版起）

请使用参数 id。

blockdev-add 空字符串参数 backing（自 2.10 版起）

请使用参数值 null。

block-commit 参数 base 和 top（自 3.1 版起）

请使用参数 base-node 和 top-node。