[ovs-dev,ovn,v2,4/7] ovn-architecture: Correct documentation of localnet ports.
diff mbox series

Message ID 20200318184548.3000357-5-blp@ovn.org
State New
Headers show
Series
  • gateway documentation improvements
Related show

Commit Message

Ben Pfaff March 18, 2020, 6:45 p.m. UTC
Their LSes can have multiple additional LSPs, not just one.

Suggested-by: Han Zhou <hzhou@ovn.org>
Signed-off-by: Ben Pfaff <blp@ovn.org>
---
 ovn-architecture.7.xml | 29 ++++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

Patch
diff mbox series

diff --git a/ovn-architecture.7.xml b/ovn-architecture.7.xml
index 94a897fa693e..a69f4af7d1c5 100644
--- a/ovn-architecture.7.xml
+++ b/ovn-architecture.7.xml
@@ -441,17 +441,28 @@ 
 
   <p>
     A <code>localnet</code> logical switch port bridges a logical switch to a
-    physical VLAN.  A logical switch with a <code>localnet</code> LSP should
-    have only one other LSP.  Some kinds of gateways (see <code>Gateways</code>
-    below) use a logical switch with a router port as the second LSP.  On the
-    other hand, when the second LSP is a VIF, the logical switch is not really
-    a logical network, since it is bridged to the physical network rather than
-    insulated from it, and therefore cannot have independent but overlapping IP
-    address namespaces, etc.  (A deployment might nevertheless choose such a
-    configuration to take advantage of the OVN control plane and features such
-    as port security and ACLs.)
+    physical VLAN.  Any given logical switch should have no more than one
+    <code>localnet</code> port.  Such a logical switch is used in two
+    scenarios:
   </p>
 
+  <ul>
+    <li>
+      With one or more <code>router</code> logical switch ports, to attach L3
+      gateway routers and distributed gateways to a physical network.
+    </li>
+
+    <li>
+      With one or more VIF logical switch ports, to attach VMs or containers
+      directly to a physical network.  In this case, the logical switch is not
+      really logical, since it is bridged to the physical network rather than
+      insulated from it, and therefore cannot have independent but overlapping
+      IP address namespaces, etc.  A deployment might nevertheless choose such
+      a configuration to take advantage of the OVN control plane and features
+      such as port security and ACLs.
+    </li>
+  </ul>
+
   <p>
     A <code>localport</code> logical switch port is a special kind of VIF
     logical switch port.  These ports are present in every chassis, not bound