On Tue, Nov 01, 2016 at 12:11:16PM +0000, Jaroslav Safka wrote:
Add html documentation for memoryBacking element.
We usually merge documentation with the conf changes.
---
docs/formatdomain.html.in | 10 ++++++++++
1 file changed, 10 insertions(+)
diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index c70377b..ed15eb5 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -903,6 +903,9 @@
</hugepages>
<nosharepages/>
<locked/>
+ <source type='file|anonymous'/>
+ <access mode='shared|private'>
+ <allocation mode='immediate|ondemand'/>
</memoryBacking>
...
</domain>
@@ -942,6 +945,13 @@
most of the host's memory). Doing so may be dangerous to both the
domain and the host itself since the host's kernel may run out of
memory. <span class="since">Since 1.0.6</span></dd>
+ <dt><code>source</code></dt>
+ <dd>If the option "file" is selected, then token
"mem-path=/var/lib/libvirt/qemu" will be added to object argument.</dd>
You should say it is the <code>type</code> attribute. Also talking
about tokens being added to object argument makes no sense for the
reader. And I'm not talking about hypervisors other than QEMU where it
doesn't make sense even to developers.
+ <dt><code>access</code></dt>
+ <dd>Specify if memory is shared or private. This can be overridden by numa
cell element memAccess.
overridden *per node*. We enclose element and attribute names inside
<code/> so that others can see that you are referring to something.
+ If share is selected then token "share=yes" will be
added to object memory-backend-file.</dd>
Again, this makes no sense in high-lieve documentation.
+ <dt><code>allocation</code></dt>
+ <dd>Immediate - preallocate the memory immediately</dd>
^^ no comment.