tor

commit b0e10f23ba2b03f275ef4acf2183a02042e6cded
parent 613b18f0afd865b0fc5daf8d17da241396100dcd
Author: Isis Lovecruft <isis@torproject.org>
Date:   Mon, 23 Oct 2017 19:37:52 +0000

doc: Improve documentation for check_bridge_distribution_setting().

Diffstat:
M
src/or/config.c
 | 
22
++++++++++++++++++++--

1 file changed, 20 insertions(+), 2 deletions(-)
diff --git a/src/or/config.c b/src/or/config.c
@@ -6350,8 +6350,26 @@ warn_client_dns_cache(const char *option, int disabling)
       "to your destination.");
 }
 
-/** Warn if <b>bd</b> is an unrecognized bridge distribution setting;
- * return -1 if it is invalid. */
+/**
+ * Validate the configured bridge distribution method from a BridgeDistribution
+ * config line.
+ *
+ * The input <b>bd</b>, is a string taken from the BridgeDistribution config
+ * line (if present).  If the option wasn't set, return 0 immediately.  The
+ * BridgeDistribution option is then validated.  Currently valid, recognised
+ * options are:
+ *
+ * - "none"
+ * - "any"
+ * - "https"
+ * - "email"
+ * - "moat"
+ * - "hyphae"
+ *
+ * If the option string is unrecognised, a warning will be logged and 0 is
+ * returned.  If the option string contains an invalid character, -1 is
+ * returned.
+ **/
 static int
 check_bridge_distribution_setting(const char *bd)
 {