vswitch.xml: Suggest secure fail-mode to avoid loops with multiple uplinks.

EXT-186.
Reported-by: Rob Sherwood <rob.sherwood@bigswitch.com>
Signed-off-by: Ben Pfaff <blp@nicira.com>

diff --git a/AUTHORS b/AUTHORS
index dea511b2e0c058173c4641e04d0d729a465cb461..f488aedef63ba7e99ddbae0920085c76d2bce8f5 100644 (file)
--- a/AUTHORS
+++ b/AUTHORS
@@ -135,6 +135,7 @@ Peter Balland           peter@nicira.com
 Peter Phaal             peter.phaal@inmon.com
 Ram Jothikumar          rjothikumar@nicira.com
 Ramana Reddy            gtvrreddy@gmail.com
+Rob Sherwood            rob.sherwood@bigswitch.com
 Roger Leigh             rleigh@codelibre.net
 Rogério Vinhal Nunes
 Sean Brady              sbrady@gtfservices.com

diff --git a/vswitchd/vswitch.xml b/vswitchd/vswitch.xml
index b9b7b97aee646ef1bc3c110d604daac79c6b5c41..308af51fbc6bd1853b3f066248af8ac2b3ef5c8c 100644 (file)
--- a/vswitchd/vswitch.xml
+++ b/vswitchd/vswitch.xml
@@ -410,6 +410,12 @@
         </dl>
         </p>
         <p>If this value is unset, the default is implementation-specific.</p>
+        <p>
+          The <code>standalone</code> mode can create forwarding loops on a
+          bridge that has more than one uplink port unless STP is enabled.  To
+          avoid loops on such a bridge, configure <code>secure</code> mode or
+          enable STP (see <ref column="stp_enable"/>).
+        </p>
         <p>When more than one controller is configured,
         <ref column="fail_mode"/> is considered only when none of the
         configured controllers can be contacted.</p>