Browse Source

Note contactinfo and myfamily as required in more places

Includes a sentence from cypherpunks; for ticket 24526.
Nick Mathewson 6 years ago
parent
commit
ac0f819ce5
4 changed files with 27 additions and 2 deletions
  1. 4 0
      changes/bug24526
  2. 11 2
      doc/tor.1.txt
  3. 6 0
      src/config/torrc.minimal.in-staging
  4. 6 0
      src/config/torrc.sample.in

+ 4 - 0
changes/bug24526

@@ -0,0 +1,4 @@
+  o Documentation:
+    - Document that operators who run more than one relay or bridge are
+      expected to set MyFamily and ContactInfo correctly. Closes ticket
+      24526.

+ 11 - 2
doc/tor.1.txt

@@ -1720,7 +1720,12 @@ is non-zero):
     descriptors containing these lines and that Google indexes them, so
     descriptors containing these lines and that Google indexes them, so
     spammers might also collect them. You may want to obscure the fact
     spammers might also collect them. You may want to obscure the fact
     that it's an email address and/or generate a new address for this
     that it's an email address and/or generate a new address for this
-    purpose.
+    purpose. +
+ +
+    ContactInfo **must** be set to a working address if you run more than one
+    relay or bridge.  (Really, everybody running a relay or bridge should set
+    it.)
+
 
 
 [[ExitRelay]] **ExitRelay** **0**|**1**|**auto**::
 [[ExitRelay]] **ExitRelay** **0**|**1**|**auto**::
     Tells Tor whether to run as an exit relay.  If Tor is running as a
     Tells Tor whether to run as an exit relay.  If Tor is running as a
@@ -1948,7 +1953,11 @@ is non-zero):
     compromise its concealment. +
     compromise its concealment. +
  +
  +
     When listing a node, it's better to list it by fingerprint than by
     When listing a node, it's better to list it by fingerprint than by
-    nickname: fingerprints are more reliable.
+    nickname: fingerprints are more reliable. +
+ +
+    MyFamily **must** be set correctly if you run more than one relay or
+    bridge. (That is, every relay should list all the others as described
+    above.)
 
 
 [[Nickname]] **Nickname** __name__::
 [[Nickname]] **Nickname** __name__::
     Set the server's nickname to \'name'. Nicknames must be between 1 and 19
     Set the server's nickname to \'name'. Nicknames must be between 1 and 19

+ 6 - 0
src/config/torrc.minimal.in-staging

@@ -132,6 +132,9 @@
 ## spammers might also collect them. You may want to obscure the fact that
 ## spammers might also collect them. You may want to obscure the fact that
 ## it's an email address and/or generate a new address for this purpose.
 ## it's an email address and/or generate a new address for this purpose.
 ## Notice that "<" and ">" are recommended.
 ## Notice that "<" and ">" are recommended.
+##
+## If you are running multiple relays, you MUST set this option.
+##
 #ContactInfo Random Person <nobody AT example dot com>
 #ContactInfo Random Person <nobody AT example dot com>
 ## You might also include your PGP or GPG fingerprint if you have one.
 ## You might also include your PGP or GPG fingerprint if you have one.
 ## Use the full fingerprint, not just a (short) KeyID: KeyIDs are easy
 ## Use the full fingerprint, not just a (short) KeyID: KeyIDs are easy
@@ -161,6 +164,9 @@
 ## See https://www.torproject.org/docs/faq#MultipleRelays
 ## See https://www.torproject.org/docs/faq#MultipleRelays
 ## However, you should never include a bridge's fingerprint here, as it would
 ## However, you should never include a bridge's fingerprint here, as it would
 ## break its concealability and potentially reveal its IP/TCP address.
 ## break its concealability and potentially reveal its IP/TCP address.
+##
+## If you are running multiple relays, you MUST set this option.
+##
 #MyFamily $keyid,$keyid,...
 #MyFamily $keyid,$keyid,...
 
 
 ## A comma-separated list of exit policies. They're considered first
 ## A comma-separated list of exit policies. They're considered first

+ 6 - 0
src/config/torrc.sample.in

@@ -135,6 +135,9 @@
 ## descriptors containing these lines and that Google indexes them, so
 ## descriptors containing these lines and that Google indexes them, so
 ## spammers might also collect them. You may want to obscure the fact that
 ## spammers might also collect them. You may want to obscure the fact that
 ## it's an email address and/or generate a new address for this purpose.
 ## it's an email address and/or generate a new address for this purpose.
+##
+## If you are running multiple relays, you MUST set this option.
+##
 #ContactInfo Random Person <nobody AT example dot com>
 #ContactInfo Random Person <nobody AT example dot com>
 ## You might also include your PGP or GPG fingerprint if you have one:
 ## You might also include your PGP or GPG fingerprint if you have one:
 #ContactInfo 0xFFFFFFFF Random Person <nobody AT example dot com>
 #ContactInfo 0xFFFFFFFF Random Person <nobody AT example dot com>
@@ -161,6 +164,9 @@
 ## https://www.torproject.org/docs/faq#MultipleRelays
 ## https://www.torproject.org/docs/faq#MultipleRelays
 ## However, you should never include a bridge's fingerprint here, as it would
 ## However, you should never include a bridge's fingerprint here, as it would
 ## break its concealability and potentially reveal its IP/TCP address.
 ## break its concealability and potentially reveal its IP/TCP address.
+##
+## If you are running multiple relays, you MUST set this option.
+##
 #MyFamily $keyid,$keyid,...
 #MyFamily $keyid,$keyid,...
 
 
 ## A comma-separated list of exit policies. They're considered first
 ## A comma-separated list of exit policies. They're considered first