From 7dea6ace339f1a7433040f590feb3b2d19089af5 Mon Sep 17 00:00:00 2001
From: Ben Pfaff <blp@nicira.com>
Date: Thu, 10 May 2012 10:11:08 -0700
Subject: [PATCH 1/1] 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>
---
 AUTHORS              | 1 +
 vswitchd/vswitch.xml | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/AUTHORS b/AUTHORS
index dea511b2e..f488aedef 100644
--- 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 b9b7b97ae..308af51fb 100644
--- 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>
-- 
2.43.0