[libvirt] [PATCH] clarify the xml example for NVDIMM more clealy

[Luyao Zhong]

The NVDIMM backend file can be a normal file or a real device file,
Current xml example and explainations may mislead users. So add more
info about the NVDIMM related elements and update the xml examples.

Signed-off-by: Luyao Zhong <luyao.zhong at intel.com>
---
 docs/formatdomain.html.in | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 86a5261..556a39f 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -8533,7 +8533,6 @@ qemu-kvm -net nic,model=? /dev/null
   <memory model='nvdimm'>
     <source>
       <path>/tmp/nvdimm</path>
-      <alignsize unit='KiB'>2048</alignsize>
     </source>
     <target>
       <size unit='KiB'>524288</size>
@@ -8544,9 +8543,10 @@ qemu-kvm -net nic,model=? /dev/null
       <readonly/>
     </target>
   </memory>
-  <memory model='nvdimm'>
+  <memory model='nvdimm' access='shared'>
     <source>
       <path>/dev/dax0.0</path>
+      <alignsize unit='KiB'>2048</alignsize>
       <pmem/>
     </source>
     <target>
@@ -8580,6 +8580,8 @@ qemu-kvm -net nic,model=? /dev/null
           module basis. Values are the same as
           <a href="#elementsMemoryBacking">Memory Backing</a>:
           <code>shared</code> and <code>private</code>.
+          For <code>nvdimm</code> model, if using real NVDIMM DAX device as
+          backend, <code>shared</code> is required.
         </p>
       </dd>
 
@@ -8643,7 +8645,8 @@ qemu-kvm -net nic,model=? /dev/null
               alignment used to mmap the address range for the backend
               <code>path</code>. If not supplied the host page size is used.
               For example, to mmap a real NVDIMM device a 2M-aligned page may
-              be required.
+              be required, and host page size is 4KB, then we need to set this
+              element to 2MB.
               <span class="since">Since 5.0.0</span>
             </p>
           </dd>
-- 
2.7.4