]> xenbits.xensource.com Git - libvirt.git/commitdiff
Add documentation for VLAN filtering support
authorStefan Berger <stefanb@linux.vnet.ibm.com>
Sat, 19 Nov 2011 12:26:56 +0000 (07:26 -0500)
committerStefan Berger <stefanb@us.ibm.com>
Sat, 19 Nov 2011 12:26:56 +0000 (07:26 -0500)
Add documentation for the VLAN filtering support. Describe the XML attributes
that are supported.

Signed-off-by: Stefan Berger <stefanb@linux.vnet.ibm.com>
docs/formatnwfilter.html.in

index ad754c1bd9bd208221cebd7fe5ec0dffe4fff0df..d21fac579fa1157e6e1afcb33ddf8554244febbe 100644 (file)
 [...]
 </pre>
 
+    <h5><a name="nwfelemsRulesProtoVLAN">VLAN (802.1Q)</a>
+      <span class="since">(Since 0.9.8)</span>
+    </h5>
+    <p>
+      Protocol ID: <code>vlan</code>
+      <br/>
+      Note: Rules of this type should go either into 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>