aboutsummaryrefslogtreecommitdiff
path: root/path-spec.txt
AgeCommit message (Collapse)Author
2021-02-18Update path-spec.txt for CBT estimator fixes for #40168.Mike Perry
Also clarify and improve wording of the timeout calculation section.
2020-11-16fix typos; more robust links between specsRoger Dingledine
2019-12-10convert text blocks into widely compatible "blockquote" syntaxHans-Christoph Steiner
This only adds newline characters to make the existing text blocks act like "blockquote" or "code block" syntax in Markdown, asciidoc, and others. This was accomplished by manually reviewing the output of this script: ```bash for f in *.txt; do cat $f | python -c "import sys,re;print(re.sub(r'(\n {0,3}[^ \n][^\n]*\n)( {4,}[^\n]*)', r'\1\n\2', sys.stdin.read()))" > ${f}.tmp mv ${f}.tmp $f done ```
2019-11-26remove trailing whitespace `sed -i 's, *$,,' *.txt`Hans-Christoph Steiner
2019-11-26fix erroneous header numbering punctuationHans-Christoph Steiner
The clear standard is trailing "." after each numeric section. This fixes the small handful of outliers. This makes it easy to convert these headers to common markup formats, for example: http://hyperpolyglot.org/lightweight-markup
2018-05-08Mention how HSLayer2Nodes and HSLayer3Nodes alter path restrictions.Mike Perry
2018-02-14Adjust cbtlearntimeout default to match the codeNick Mathewson
2018-02-14Document new consensus params for bug24769.Mike Perry
2017-02-01Explain more about primary guards and about building circuitsNick Mathewson
In path-spec: explain our rules (post-21242) for waiting to build circuits. In guard-spec: - explain what to do about missing descriptors - explain parallel use of multiple primary guards, based on parameters.
2017-01-31Start a new guard-spec.txt as a copy of prop271.Nick Mathewson
Remove the old guard section of path-spec, now that guard-spec is separate.
2015-10-23Document our current guard selection algorithm in path-spec.txt.Isis Lovecruft
* ADDS new section, "ยง5.1. Guard selection algorithm", to path-spec.txt. * FIXES #17261: https://bugs.torproject.org/17261
2015-02-24Standardizing on the name 'server descriptor'Damian Johnson
We use a few names for the main self-published descriptor documents... https://trac.torproject.org/projects/tor/ticket/14987 Standardizing on the name 'server descriptor'. This change was made with a few quick runs of sed... % find ./* -type f -exec sed -i 's/router descriptor/server descriptor/' "{}" +; % find ./* -type f -exec sed -i 's/Router descriptor/Server descriptor/' "{}" +; % find ./* -type f -exec sed -i 's/Router Descriptor/Server Descriptor/' "{}" +; ... then reverting the attic changes, and scanning the rest to be sure it doesn't include any functional impact.
2014-12-30Actually, this patch is going into 0.2.6.2-alpha, not 0.2.6.1-alphaNick Mathewson
2014-12-20If the consensus doesn't contain exits, don't build exit pathsteor
If the consensus doesn't contain exits, we only build internal paths. This is enough to allow reachability tests (which can enable exits to bootstrap), and hidden services. If we subsequently receive a consensus with exits, start building exit paths. Update dir-spec and path-spec to document this. Update control-spec to document changes in controller bootstrap messages. Based on changes made in tor to resolve bug #13814.
2014-11-26Set default value for bw weights if absent from consensus.George Kadianakis
2013-04-18Define 'family' better in path-specNick Mathewson
Inspired by tor-talk thread "Family path selection"
2013-04-11Merge remote-tracking branch 'mikeperry/bug5178'Nick Mathewson
2013-03-27Describe path bias consensus parameters and clarify some wording.Mike Perry
2013-03-26Improve CBT network liveness section to match code.Mike Perry
We simplified this code a while back and forgot to update the spec.
2013-03-25Initial draft of path bias spec updates.Mike Perry
Still needs parameter description.
2011-11-26Trivial whitespace cleanupSebastian Hahn
2011-05-09Fix minor issuesRobert Ransom
2011-05-09In specs, do not say "server" when we mean "relay" or "node"Nick Mathewson
Fixes bug 2936.
2011-01-15Fix a typo spotted by RogerSebastian Hahn
2011-01-15Sanity-check consensus param valuesSebastian Hahn
We need to make sure that the worst thing that a weird consensus param can do to us is to break our Tor (and only if the other Tors are reliably broken in the same way) so that the majority of directory authorities can't pull any attacks that are worse than the DoS that they can trigger by simply shutting down. One of these worse things was the cbtnummodes parameter, which could lead to heap corruption on some systems if the value was sufficiently large. This commit fixes this particular issue and also introduces sanity checking for all consensus parameters.
2010-06-29Merge remote branch 'mikeperry/cbt-bugfixes3'Nick Mathewson
2010-06-25Make spec docs reference RFC2119Nick Mathewson
Now people will have no excuse for not knowing what "MUST" and "MAY" mean. Fixes bug 1310.
2010-06-09Update spec with new right-censored pareto estimators.Mike Perry
2010-05-10Bug 1296: Add option+logic to disable CBT learning.Mike Perry
There are now four ways that CBT can be disabled: 1. Network-wide, with the cbtdisabled consensus param. 2. Via config, with "LearnCircuitBuildTimeout 0" 3. Via config, with "AuthoritativeDirectory 1" 4. Via a state file write failure.
2010-05-10Update path-spec.txt with contents of proposal 151.Mike Perry
2010-02-22Update specs for weight computation and use.Mike Perry
2009-06-22path-spec: Clarify what we mean by "a server's bandwidth."Nick Mathewson
This just got a little complicated, since old clients use "clipped advertised bandwith" and new clients now use "consensus bandwidth" but fall back to "clipped advertised bandwidth".
2009-05-05Remove all svn metadata minus what I missed.Sebastian Hahn
Tor doesn't use SVN anymore, making $Revision$, $Id$ and $Date$ meaningless. Remove them without replacement.
2008-11-08some minor changes i found in my sandboxRoger Dingledine
svn:r17215
2008-04-16fix typo in path-spec, spotted by kebRoger Dingledine
svn:r14384
2008-01-17explain a bit about router descriptor purposesRoger Dingledine
svn:r13154
2007-08-24patch from mike perry to a) stop overloading guards as much, andRoger Dingledine
b) raise the max-believable-bandwidth to 10MB/s. svn:r11258
2007-07-28 r13959@catbus: nickm | 2007-07-28 18:09:56 -0400Nick Mathewson
Use the correct formula to calculate exit weights. svn:r10956
2007-05-31clean up a few confusions brian levine pointed outRoger Dingledine
svn:r10415
2007-02-28 r11994@catbus: nickm | 2007-02-28 13:08:52 -0500Nick Mathewson
Re-number misnumbered spec sections. No more having to refer to "the first of two section 6.1s." svn:r9683
2007-02-12start to rewrite path spec. still needs more work.Roger Dingledine
svn:r9566
2007-02-08 r11700@catbus: nickm | 2007-02-08 02:03:50 -0500Nick Mathewson
Fix several bugs in computing recommended versions. 1) refactor is-this-version-good handling and which-vesions-are-good handling to be in the same place. 2) a version is recommended if more than half of the versioning authorities like it, not >= half. 3) "NEW_IN_SERIES" should mean, "I don't know of an 0.1.1.x this recent, and there are some 0.1.2.x versions out", not "I don't know of an 0.1.1.x this recent, but I know some older ones." This should resolve bug 383. svn:r9523
2007-02-06cleanups based on looking through svn commitsRoger Dingledine
svn:r9491
2007-01-30 r11606@catbus: nickm | 2007-01-30 16:52:23 -0500Nick Mathewson
Write the entry guards section of path-spec; note a possible bug in cirbuitbuild.c; add a const; defer work on torrc.complete to be part of a bigger config documentation reorg. svn:r9465
2007-01-22minor cleanupsRoger Dingledine
svn:r9387
2006-10-19 r9091@totoro: nickm | 2006-10-19 11:45:28 -0400Nick Mathewson
Change to BadExit logic: Let authorities set an "I list bad exits" flag. Consider an exit bad if it is listed as bad by more than half of *those* authorities. This gives us a better migration path. svn:r8756
2006-10-11 r9004@totoro: nickm | 2006-10-11 18:05:24 -0400Nick Mathewson
Add client support for a 'BadExit' flag, so authorities can say "Server X is a poor choise for your nytimes.com connections, as it seems to direct them to HoorayForMao.com or (more likely) WouldYouLikeToBuyTheseFineEncyclopedias.com" svn:r8690
2006-10-07more minor cleanupsRoger Dingledine
svn:r8630
2006-10-01 r8826@totoro: nickm | 2006-10-01 17:58:45 -0400Nick Mathewson
Disprefer exit nodes for entry, middle positions (fixes bug 200). Also, switch to using a uint64_t to hold "total bandwidth for all nodes" under consideration; crypt_rand_int would have died at 2GB/s network capacity. svn:r8571
2006-10-01 r8824@totoro: nickm | 2006-10-01 17:35:55 -0400Nick Mathewson
note valid flag in path spec. svn:r8569