Add documentation for the VLAN filtering support. Describe the XML attributes
that are supported.
Signed-off-by: Stefan Berger <stefanb(a)linux.vnet.ibm.com>
---
docs/formatnwfilter.html.in | 55 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 55 insertions(+)
Index: libvirt-acl/docs/formatnwfilter.html.in
===================================================================
--- libvirt-acl.orig/docs/formatnwfilter.html.in
+++ libvirt-acl/docs/formatnwfilter.html.in
@@ -412,6 +412,61 @@
[...]
</pre>
+ <h5><a name="nwfelemsRulesProtoVLAN">VLAN (802.1Q)</a>
+ <span class="since">(Since 0.9.7)</span>
+ </h5>
+ <p>
+ Protocol ID: <code>vlan</code>
+ <br/>
+ Note: Rules of this type should go eitherinto the <code>root</code> or
+ <code>vlan</code> chain.
+ </p>
+ <table class="top_table">
+ <tr>
+ <th> Attribute </th>
+ <th> Datatype </th>
+ <th> Semantics </th>
+ </tr>
+ <tr>
+ <td>srcmacaddr</td>
+ <td>MAC_ADDR</td>
+ <td>MAC address of sender</td>
+ </tr>
+ <tr>
+ <td>srcmacmask</td>
+ <td>MAC_MASK</td>
+ <td>Mask applied to MAC address of sender</td>
+ </tr>
+ <tr>
+ <td>dstmacaddr</td>
+ <td>MAC_ADDR</td>
+ <td>MAC address of destination</td>
+ </tr>
+ <tr>
+ <td>dstmacmask</td>
+ <td>MAC_MASK</td>
+ <td>Mask applied to MAC address of destination</td>
+ </tr>
+ <tr>
+ <td>vlan-id</td>
+ <td>UINT16 (0x0-0xfff, 0 - 4095)</td>
+ <td>VLAN ID</td>
+ </tr>
+ <tr>
+ <td>encap-protocol</td>
+ <td>UINT16 (0x03c-0xfff), String</td>
+ <td>Encapsulated layer 3 protocol ID</td>
+ </tr>
+ <tr>
+ <td>comment </td>
+ <td>STRING</td>
+ <td>text with max. 256 characters</td>
+ </tr>
+ </table>
+ <p>
+ Valid Strings for <code>encap-protocol</code> are: arp, ipv4, ipv6
+ </p>
+
<h5><a
name="nwfelemsRulesProtoARP">ARP/RARP</a></h5>
<p>
Protocol ID: <code>arp</code> or <code>rarp</code>