[libvirt] [PATCH v1 13/14] docs: Document user aliases

Michal Privoznik mprivozn at redhat.com
Thu Oct 19 08:11:08 UTC 2017


Signed-off-by: Michal Privoznik <mprivozn at redhat.com>
---
 docs/formatdomain.html.in | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index b7e145e0f..57dd46dc5 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -2249,6 +2249,29 @@
       </dd>
     </dl>
 
+    <p>
+      To help users identifying devices they care about, every
+      device can have direct child <code>alias</code> element
+      which then has <code>name</code> attribute where users can
+      store identifier for the device. The identifier has to have
+      "ua-" prefix and must be unique within the domain. Additionally, the
+      identifier must consist only of the following characters:
+      <code>[a-zA-Z0-9_-]</code>.
+      <span class="since">Since 3.9.0</span>
+    </p>
+
+<pre>
+<devices>
+  <disk type='file'>
+    <alias name='ua-myDisk'/>
+  </disk>
+  <interface type='network' trustGuestRxFilters='yes'>
+    <alias name='ua-myNIC'/>
+  </interface>
+  ...
+</devices>
+</pre>
+
     <h4><a id="elementsDisks">Hard drives, floppy disks, CDROMs</a></h4>
 
     <p>
-- 
2.13.6




More information about the libvir-list mailing list