From e10b599a24205576de1d4b9f85b9b4e9968865e2 Mon Sep 17 00:00:00 2001 From: Cole Robinson Date: Sun, 14 Jul 2019 19:46:15 -0400 Subject: [PATCH] docs: formatnetwork: Document xmlns:dnsmasq Reviewed-by: Laine Stump Signed-off-by: Cole Robinson --- 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 @@ +

Network namespaces

+ +

+ 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. +

+ +

+ This example XML will pass the option strings foo=bar and + cname=*.foo.example.com,master.example.com directly to the + underlying dnsmasq instance. + 

+<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>
+

+

Example configuration

NAT based network