[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 14/18] qemu-options.hx: Update descriptions of memory options for
From: |
Alex Bennée |
Subject: |
[PATCH 14/18] qemu-options.hx: Update descriptions of memory options for NUMA node |
Date: |
Mon, 24 Apr 2023 10:22:45 +0100 |
From: Yohei Kojima <y-koj@outlook.jp>
This commit adds the following description:
1. `memdev` option is recommended over `mem` option (see [1,2])
2. users must specify memory for all NUMA nodes (see [2])
This commit also separates descriptions for `mem` and `memdev` into two
paragraphs. The old doc describes legacy `mem` option first, and it was
a bit confusing.
Related documentation:
[1] https://wiki.qemu.org/ChangeLog/5.1#Incompatible_changes
[2] https://www.qemu.org/docs/master/about/removed-features.html
Signed-off-by: Yohei Kojima <y-koj@outlook.jp>
Message-Id:
<TYZPR06MB5418D6B0175A49E8E76988439D8E9@TYZPR06MB5418.apcprd06.prod.outlook.com>
Reviewed-by: Juan Quintela <quintela@redhat.com>
Message-Id: <20230420155723.1711048-3-alex.bennee@linaro.org>
[AJB: fix documentation in commit message]
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
qemu-options.hx | 25 ++++++++++++++++---------
1 file changed, 16 insertions(+), 9 deletions(-)
diff --git a/qemu-options.hx b/qemu-options.hx
index baa0589733..b5efa648ba 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -405,15 +405,22 @@ SRST
-numa node,nodeid=0 -numa node,nodeid=1 \
-numa cpu,node-id=0,socket-id=0 -numa cpu,node-id=1,socket-id=1
- Legacy '\ ``mem``\ ' assigns a given RAM amount to a node (not supported
- for 5.1 and newer machine types). '\ ``memdev``\ ' assigns RAM from
- a given memory backend device to a node. If '\ ``mem``\ ' and
- '\ ``memdev``\ ' are omitted in all nodes, RAM is split equally between
them.
-
-
- '\ ``mem``\ ' and '\ ``memdev``\ ' are mutually exclusive.
- Furthermore, if one node uses '\ ``memdev``\ ', all of them have to
- use it.
+ '\ ``memdev``\ ' option assigns RAM from a given memory backend
+ device to a node. It is recommended to use '\ ``memdev``\ ' option
+ over legacy '\ ``mem``\ ' option. This is because '\ ``memdev``\ '
+ option provides better performance and more control over the
+ backend's RAM (e.g. '\ ``prealloc``\ ' parameter of
+ '\ ``-memory-backend-ram``\ ' allows memory preallocation).
+
+ For compatibility reasons, legacy '\ ``mem``\ ' option is
+ supported in 5.0 and older machine types. Note that '\ ``mem``\ '
+ and '\ ``memdev``\ ' are mutually exclusive. If one node uses
+ '\ ``memdev``\ ', the rest nodes have to use '\ ``memdev``\ '
+ option, and vice versa.
+
+ Users must specify memory for all NUMA nodes by '\ ``memdev``\ '
+ (or legacy '\ ``mem``\ ' if available). In QEMU 5.2, the support
+ for '\ ``-numa node``\ ' without memory specified was removed.
'\ ``initiator``\ ' is an additional option that points to an
initiator NUMA node that has best performance (the lowest latency or
--
2.39.2
- [PATCH 00/18] testing/next: avocado, docs (pre-PR), Alex Bennée, 2023/04/24
- [PATCH 01/18] tests/requirements.txt: bump up avocado-framework version to 101.0, Alex Bennée, 2023/04/24
- [PATCH 03/18] tests/avocado: Add set of boot tests on SBSA-ref, Alex Bennée, 2023/04/24
- [PATCH 02/18] tests/avocado: use the new snapshots for testing, Alex Bennée, 2023/04/24
- [PATCH 04/18] gitlab-ci: Avoid to re-run "configure" in the device-crash-test jobs, Alex Bennée, 2023/04/24
- [PATCH 08/18] tests/avocado: Make ssh_command_output_contains() globally available, Alex Bennée, 2023/04/24
- [PATCH 06/18] qemu-options: finesse the recommendations around -blockdev, Alex Bennée, 2023/04/24
- [PATCH 05/18] scripts/device-crash-test: Add a parameter to run with TCG only, Alex Bennée, 2023/04/24
- [PATCH 14/18] qemu-options.hx: Update descriptions of memory options for NUMA node,
Alex Bennée <=
- [PATCH 10/18] MAINTAINERS: Cover tests/avocado/machine_aspeed.py, Alex Bennée, 2023/04/24
- [PATCH 17/18] docs/devel: mention the spacing requirement for QOM, Alex Bennée, 2023/04/24
- [PATCH 15/18] docs/system: remove excessive punctuation from guest-loader docs, Alex Bennée, 2023/04/24
- [PATCH 07/18] .gitlab-ci.d/cirrus: Drop the CI job for compiling with FreeBSD 12, Alex Bennée, 2023/04/24
- [PATCH 12/18] tests/avocado/tuxrun_baselines.py: improve code coverage for ppc64, Alex Bennée, 2023/04/24
- [PATCH 09/18] tests/avocado/machine_aspeed: Fix the broken ast2[56]00_evb_sdk tests, Alex Bennée, 2023/04/24
- [PATCH 11/18] avocado_qemu/__init__.py: factor out the qemu-img finding, Alex Bennée, 2023/04/24
- [PATCH 13/18] tests/tcg: limit the scope of the plugin tests, Alex Bennée, 2023/04/24