[tor-bugs] #32859 [Core Tor/DocTor]: Tor man docs missing DoS log example

Tor Bug Tracker & Wiki blackhole at torproject.org
Mon Dec 30 16:46:53 UTC 2019


#32859: Tor man docs missing DoS log example
--------------------------+---------------------------------
 Reporter:  JoeBeeez      |          Owner:  atagar
     Type:  enhancement   |         Status:  new
 Priority:  Low           |      Component:  Core Tor/DocTor
  Version:  Tor: 0.4.2.5  |       Severity:  Trivial
 Keywords:                |  Actual Points:
Parent ID:                |         Points:
 Reviewer:                |        Sponsor:
--------------------------+---------------------------------
 In "DENIAL OF SERVICE MITIGATION OPTIONS" man section, there is:

 "If any of the DoS mitigations are enabled, a heartbeat message will
 appear in your log at NOTICE level which looks like:

 DoS mitigation since startup: 429042 circuits rejected, 17 marked
 addresses.
 2238 connections closed. 8052 single hop clients refused.
 The following options are useful only for a public relay. They control the
 Denial of Service mitigation subsystem described above."

 However, Tor daemon actually logs:

 "DoS mitigation since startup: '''__x circuits killed with too many
 cells__'''. y circuits rejected, z marked addresses. m connections closed.
 n single hop clients refused."

 I propose:

 1. adding log examples for each of the 3 log mitigation options, in their
 sections.

   This perhaps will make more clear what "too many cells" means, as there
 seem to be no other documentation sources regarding this.

 2. adding the '''"x circuits killed with too many cells" '''in the final
 log example.

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


More information about the tor-bugs mailing list