aboutsummaryrefslogtreecommitdiff
path: root/dir-spec.txt
diff options
context:
space:
mode:
authorDavid Goulet <dgoulet@torproject.org>2021-11-01 16:09:03 -0400
committerDavid Goulet <dgoulet@torproject.org>2021-11-01 16:09:03 -0400
commit9ef4716930d33f0ac3cc20d12ce352c6c5f69a54 (patch)
treed00cbeda02d2f20b7bbffe6b6631fa1c9a6b3e85 /dir-spec.txt
parent514cb9d45a0fbd6d0d9a198567eb18e1cf8f02e4 (diff)
downloadtorspec-9ef4716930d33f0ac3cc20d12ce352c6c5f69a54.tar.gz
torspec-9ef4716930d33f0ac3cc20d12ce352c6c5f69a54.zip
dir-spec: Mishap, the overload lines are already in the spec
Signed-off-by: David Goulet <dgoulet@torproject.org>
Diffstat (limited to 'dir-spec.txt')
-rw-r--r--dir-spec.txt69
1 files changed, 0 insertions, 69 deletions
diff --git a/dir-spec.txt b/dir-spec.txt
index 5076366..543e341 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -955,75 +955,6 @@ Table of Contents
[Before Tor 0.4.5.1-alpha, this field was optional.]
- "overload-general" SP version SP YYYY-MM-DD HH:MM:SS NL
-
- [At most once.]
-
- Indicate that the relay is overloaded due to one or many conditions
- listed in proposal 328 section 1.1.
-
- The timestamp is always rounded to the hour indicating when was the last
- time the relay detected an overloaded state.
-
- The 'version' field is a versioning field and is set to '1'. See prop328
- for what consists of an overload state.
-
- This field remains in place for 72 hours since last triggered. If the
- limits are reached again in this period, the timestamp is updated, and
- this 72 hour period restarts.
-
- This indicator is not persistent on disk meaning that if the relay
- restarts, the overload state is reset and disappear from the descriptor.
-
- [Introduced in version 0.4.6.1-alpha]
-
- "overload-ratelimits" SP version SP YYYY-MM-DD SP HH:MM:SS
- SP rate-limit SP burst-limit
- SP read-overload-count SP write-overload-count NL
-
- [At most once.]
-
- Indiate that the relay read or write rate limits were reached which is
- a specific overload signal.
-
- The 'version' field is a versioning field and is set to '1'.
-
- The '{rate|burst}-limit' are respectively the torrc options
- 'BandwidthBurst' and 'BandwidthRate' limits set by the relay. In other
- words, they are the bandwidth limitations of the relay.
-
- The "{read|write}-overload-count" are the counts of how many times the
- reported limits of burst/rate were exhausted and thus the maximum
- between the read and write count occurrences. To make the counter more
- meaningful and to avoid multiple connections saturating the counter when
- a relay is overloaded, we only increment it once a minute.
-
- They span from the past 24 hours starting at the provided timestamp
- rounded down to the hour.
-
- These counters are not persistent on disk meaning that if the relay
- restarts, the overload state is reset and disappear from the descriptor.
-
- [Introduced in version 0.4.6.1-alpha]
-
- "overload-fd-exhausted" SP version YYYY-MM-DD HH:MM:SS NL
-
- [At most once.]
-
- As the overloaded line, the timestamp indicates that the maximum of file
- descriptors was reached between this timestamp and the "published"
- timestamp of the document.
-
- This overload field remains in place for 72 hours since last triggered.
- If the limits are reached again in this period, the timestamp is
- updated, and this 72 hour period restarts.
-
- The 'version' field is a versioning field and is set to '1'.
-
- This indicator is not persistent on disk meaning that if the relay
- restarts, the overload state is reset and disappear from the descriptor.
-
- [Introduced in version 0.4.6.1-alpha]
2.1.2. Extra-info document format