[libvirt] [PATCH 5/5] docs: formatnetwork: Document xmlns:dnsmasq

Cole Robinson crobinso at redhat.com
Mon Jul 15 00:04:01 UTC 2019


Signed-off-by: Cole Robinson <crobinso at redhat.com>
---
 docs/formatnetwork.html.in | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/formatnetwork.html.in b/docs/formatnetwork.html.in
index 509cca9e8b..2448fb09e7 100644
--- a/docs/formatnetwork.html.in
+++ b/docs/formatnetwork.html.in
@@ -1096,6 +1096,28 @@
       </dd>
     </dl>
 
+    <h3><a id="elementsNamespaces">Network namespaces</a></h3>
+
+    <p>
+      A special XML namespace is available for passing options directly to the
+      underlying dnsmasq configuration file. Usage of XML namespaces comes with no
+      support guarantees, so use at your own risk.
+    </p>
+
+    <p>
+      This example XML will pass the option strings <code>foo=bar</code> and
+      <code>cname=*.foo.example.com,master.example.com</code> directly to the
+      underlying dnsmasq instance.
+      <pre>
+<network xmlns:dnsmasq='http://libvirt.org/schemas/network/dnsmasq/1.0'>
+  ...
+  <dnsmasq:options>
+    <dnsmasq:option value="foo=bar"/>
+    <dnsmasq:option value="cname=*.foo.example.com,master.example.com"/>
+  </dnsmasq:options>
+</network></pre>
+    </p>
+
     <h2><a id="examples">Example configuration</a></h2>
 
     <h3><a id="examplesNAT">NAT based network</a></h3>
-- 
2.21.0




More information about the libvir-list mailing list