Opened 3 weeks ago

Last modified 11 days ago

#32859 new enhancement

Tor man docs missing DoS log example

Reported by: JoeBeeez Owned by: atagar
Priority: Low Milestone: Tor: 0.4.3.x-final
Component: Core Tor/Tor Version: Tor: 0.4.2.5
Severity: Trivial Keywords: 042-backport documentation doc 043-can
Cc: asn, dgoulet Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description

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.

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

Child Tickets

Change History (4)

comment:1 Changed 3 weeks ago by atagar

Component: Core Tor/DocTorCore Tor/Tor

comment:2 Changed 3 weeks ago by nickm

Cc: asn dgoulet added
Keywords: 042-backport documentation added
Milestone: Tor: 0.4.3.x-final

comment:3 Changed 11 days ago by ahf

Keywords: doc added

comment:4 Changed 11 days ago by ahf

Keywords: 043-can added
Note: See TracTickets for help on using tickets.