[libvirt] [PATCH] docs: domain: Document network <filterref>

The proper nwfilter docs go into full detail, but we should still have a brief bit about domain XML in the domain documentation --- docs/formatdomain.html.in | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 9bcef6a..f6ce22d 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -4908,6 +4908,47 @@ qemu-kvm -net nic,model=? /dev/null <code>&lt;model&gt;</code> element is mandatory. </p> + <h5><a name="elementNwfilter">Traffic filtering with NWFilter</a></h5> + + <p> + <span class="since">Since 0.8.0</span> an <code>nwfilter</code> profile + can be assigned to an interface device, which allows configuring + traffic filter rules for the virtual machine. + + See the <a href="formatnwfilter.html">nwfilter</a> documentation for more + complete details. + </p> + +<pre> + ... + &lt;devices&gt; + &lt;interface ...&gt; + ... + &lt;filterref filter='clean-traffic'/&gt; + &lt;/interface&gt; + &lt;interface ...&gt; + ... + &lt;filterref filter='myfilter'&gt; + &lt;parameter name='IP' value='104.207.129.11'/&gt; + &lt;parameter name='IP6_ADDR' value='2001:19f0:300:2102::'/&gt; + &lt;parameter name='IP6_MASK' value='64'/&gt; + ... + &lt;/filterref&gt; + &lt;/interface&gt; + &lt;/devices&gt; + ...</pre> + + <p> + The <code>&lt;filterref&gt;</code> <code>filter</code> attribute + specifies the name of the <a href="formatnwfilter.html">nwfilter</a> + to use. Optional <code>&lt;parameter&gt;</code> values may be + specified for passing additional info to the nwfilter via the + <code>name</code> and <code>value</code> attributes. See + the <a href="formatnwfilter.html#nwfconceptsvars">nwfilter</a> + docs for info on parameters. + </p> + + <h4><a name="elementsInput">Input devices</a></h4> <p> -- 2.7.3