[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PULL v2 03/19] qemu-options: document missing memory-backe
From: |
Eduardo Habkost |
Subject: |
[Qemu-devel] [PULL v2 03/19] qemu-options: document missing memory-backend-file options |
Date: |
Fri, 19 Jan 2018 14:33:29 -0200 |
From: Stefan Hajnoczi <address@hidden>
This patch adds undocumented memory-backend-file options to the
documentation.
Signed-off-by: Stefan Hajnoczi <address@hidden>
Message-Id: <address@hidden>
Reviewed-by: Eric Blake <address@hidden>
Reviewed-by: Eduardo Habkost <address@hidden>
Signed-off-by: Eduardo Habkost <address@hidden>
---
qemu-options.hx | 48 +++++++++++++++++++++++++++++++++++++++++-------
1 file changed, 41 insertions(+), 7 deletions(-)
diff --git a/qemu-options.hx b/qemu-options.hx
index 678181c599..fe8c04f644 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -3972,18 +3972,24 @@ property must be set. These objects are placed in the
@table @option
address@hidden -object
memory-backend-file,address@hidden,address@hidden,address@hidden,address@hidden|off},address@hidden|off}
address@hidden -object
memory-backend-file,address@hidden,address@hidden,address@hidden,address@hidden|off},address@hidden|off},address@hidden|off},address@hidden|off},address@hidden|off},address@hidden,address@hidden|preferred|bind|interleave}
Creates a memory file backend object, which can be used to back
-the guest RAM with huge pages. The @option{id} parameter is a
-unique ID that will be used to reference this memory region
-when configuring the @option{-numa} argument. The @option{size}
-option provides the size of the memory region, and accepts
-common suffixes, eg @option{500M}. The @option{mem-path} provides
-the path to either a shared memory or huge page filesystem mount.
+the guest RAM with huge pages.
+
+The @option{id} parameter is a unique ID that will be used to reference this
+memory region when configuring the @option{-numa} argument.
+
+The @option{size} option provides the size of the memory region, and accepts
+common suffixes, eg @option{500M}.
+
+The @option{mem-path} provides the path to either a shared memory or huge page
+filesystem mount.
+
The @option{share} boolean option determines whether the memory
region is marked as private to QEMU, or shared. The latter allows
a co-operating external process to access the QEMU memory region.
+
Setting the @option{discard-data} boolean option to @var{on}
indicates that file contents can be destroyed when QEMU exits,
to avoid unnecessarily flushing data to the backing file. Note
@@ -3991,6 +3997,34 @@ that @option{discard-data} is only an optimization, and
QEMU
might not discard file contents if it aborts unexpectedly or is
terminated using SIGKILL.
+The @option{merge} boolean option enables memory merge, also known as
+MADV_MERGEABLE, so that Kernel Samepage Merging will consider the pages for
+memory deduplication.
+
+Setting the @option{dump} boolean option to @var{off} excludes the memory from
+core dumps. This feature is also known as MADV_DONTDUMP.
+
+The @option{prealloc} boolean option enables memory preallocation.
+
+The @option{host-nodes} option binds the memory range to a list of NUMA host
+nodes.
+
+The @option{policy} option sets the NUMA policy to one of the following values:
+
address@hidden @option
address@hidden @var{default}
+default host policy
+
address@hidden @var{preferred}
+prefer the given host node list for allocation
+
address@hidden @var{bind}
+restrict memory allocation to the given host node list
+
address@hidden @var{interleave}
+interleave memory allocations across the given host node list
address@hidden table
+
@item -object rng-random,address@hidden,address@hidden/dev/random}
Creates a random number generator backend which obtains entropy from
--
2.14.3
- [Qemu-devel] [PULL v2 00/19] machine queue, 2018-01-19, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 01/19] memfd: split qemu_memfd_alloc(), Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 02/19] memfd: remove needless include, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 03/19] qemu-options: document missing memory-backend-file options,
Eduardo Habkost <=
- [Qemu-devel] [PULL v2 04/19] qemu-options: document memory-backend-ram, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 05/19] numa: fix missing '-numa cpu' in '-help' output, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 07/19] hw/arm/virt: Allow only supported dynamic sysbus devices, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 06/19] machine: Replace has_dynamic_sysbus with list of allowed devices, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 08/19] ppc: e500: Allow only supported dynamic sysbus devices, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 09/19] spapr: Allow only supported dynamic sysbus devices, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 10/19] xen: Add only xen-sysdev to dynamic sysbus device list, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 11/19] q35: Allow only supported dynamic sysbus devices, Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 12/19] qdev_monitor: Simplify error handling in qdev_device_add(), Eduardo Habkost, 2018/01/19
- [Qemu-devel] [PULL v2 13/19] qdev: Check for the availability of a hotplug controller before adding a device, Eduardo Habkost, 2018/01/19