[tor-bugs] #32888 [Core Tor/Tor]: Log address config info when tor starts up

["Tor Bug Tracker & Wiki" <blackhole@xxxxxxxxxxxxxx>]

#32888: Log address config info when tor starts up
------------------------------+------------------------------------------
     Reporter:  teor          |      Owner:  teor
         Type:  enhancement   |     Status:  assigned
     Priority:  Medium        |  Milestone:  Tor: 0.4.3.x-final
    Component:  Core Tor/Tor  |    Version:
     Severity:  Normal        |   Keywords:  ipv6, network-team-roadmap-?
Actual Points:                |  Parent ID:
       Points:  1             |   Reviewer:
      Sponsor:                |
------------------------------+------------------------------------------
 We're going to be modifying tor's address detection and reachability code
 for an upcoming sponsor. To help us debug, we should log the following
 info when tor starts up:

 IPv4:
 * the `Address` torrc option
   * and whether it is an IP address, or a DNS name
 * the local hostname
   * and whether it is an IP address, or a DNS name
 * the local network interface addresses

 IPv6:
 * the IPv6 address of the first IPv6 `ORPort` torrc option

 When (or if) we use them as part of address detection, we should also log
 the following info:

 IPv4 and IPv6:
 * the `Address` torrc option
   * and whether it is an IP address, or a DNS name
 * the IPv4 and IPv6 addresses of the first `ORPort` torrc option of each
 address family
 * the local hostname
   * and whether it is an IP address, or a DNS name
 * the local network interface addresses

 Notes:
 * We'll need a proposal to decide if `ORPort` or hostname should come
 first
 * We'll probably want a summary at notice level, and then detailed logs at
 info level
 * If all these methods fail, relays use `X-Your-Address-Is:` headers from
 directory authorities. They are out of scope, because they are not
 available at startup.
 * Similarly, we won't print address reachability self-testing info,
 because it's not available at startup.
 * We may want to print similar log messages (including `X-Your-Address-
 Is:` and reachability info) as part of tor's regular heartbeat messages.
 But that deserves a separate ticket.

 I don't think we'll use (or log):
 * the addresses of any `DirPort` torrc options
 * the addresses of multiple `ORPort` torrc options

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/32888>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online

_______________________________________________
tor-bugs mailing list
tor-bugs@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs