torproject/torspec
1
0
Fork 0
mirror of https://github.com/torproject/torspec.git synced 2024-11-27 11:50:32 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
3,283 Commits 2 Branches 0 Tags 5.6 MiB
017674275d
Commit Graph

535 Commits

Author SHA1 Message Date
Nick Mathewson
4749bf55c4 Merge remote-tracking branch 'special/feature15588' 2016-05-09 14:45:46 -04:00
Nick Mathewson
4e6f2abdcf Merge remote-tracking branch 'teor/bug18851' 2016-05-04 16:24:04 -04:00
teor (Tim Wilson-Brown)
56b3ef3d71 Clarify GETINFO status/reachability-succeeded/dir with no DirPort 
It returns 1 when there's no need for a reachability check.
 2016-04-20 14:26:08 +10:00
Yawning Angel
1632d6e310 Document the HIBERNATION_STATUS SERVER_STATUS sub-event. 2016-03-30 20:32:20 +00:00
Georg Koppen
03aaace9bd Bug 16081: Document status code consistency in single reply 2015-12-16 08:59:47 -05:00
teor (Tim Wilson-Brown)
d92f97b146 Update control-spec for exit-policy/reject-private/* 2015-11-16 23:40:16 +11:00
Georg Koppen
7f10e7a9d6 Bug 17578: Fix typos in control-spec.txt 2015-11-10 09:12:44 -05:00
Donncha O'Cearbhaill
8401f6bc69 Clarify Replica field in HS_DESC event 
Clarify the format of the HS_DESC Replica field and indicate that it is
is defined in rend-spec.txt. Resolves #17226.
 2015-10-06 15:15:41 +02:00
Damian Johnson
291b77f572 Trivial revision for HS_DESC 
Just fixing some line wrap and case (keywords like 'SHOULD' are uppercase by
convention).
 2015-10-03 11:08:57 -07:00
Donncha O'Cearbhaill
69de9ec98c Fix line wrapping 2015-09-08 14:33:48 +02:00
Donncha O'Cearbhaill
4989e73722 Add REPLICA field to HS_DESC CREATED event 2015-09-08 12:24:59 +02:00
Donncha O'Cearbhaill
5be4713efe Documents HS_DESC CREATED event. 2015-09-08 12:23:50 +02:00
Donncha O'Cearbhaill
99fe437487 Add control spec entry for GETINFO hs/service/desc/id/ command 2015-09-08 12:23:32 +02:00
John Brooks
c2865d9111 Add ClientAuth for the ADD_ONION control command 
Part of #15588
 2015-07-14 00:15:44 -04:00
Damian Johnson
acd48dd75e Document 'GETINFO status/fresh-relay-descs' 
Oops. Feature Sebastian kindly added a few months back. Looks like it didn't
make it into the spec.

  https://trac.torproject.org/projects/tor/ticket/14784
 2015-07-06 08:32:16 -07:00
Roger Dingledine
3878865046 a stem user got confused by md/* 
now try to phrase it in a less confusing way.
 2015-06-10 22:40:37 -04:00
Roger Dingledine
236767d172 fix some spelling errors / etc in control spec 2015-06-10 22:37:42 -04:00
Damian Johnson
e0e81d078a Revise NETWORK_LIVENESS spec 
Minor revisions for the new NETWORK_LIVENESS event...

  * Include a note about the version when this is being added.

  * No need to say new fields are allowed. This is said near the start of
    section 4.1...

    "Clients MUST tolerate events with arguments and keywords they do not
    recognize"

  * Rejigger the spec's style a tad to be more like other events.
 2015-05-19 08:03:13 -07:00
Nick Mathewson
7ec5d394de Clarify that we can expand NETWORK_LIVENESS in the future 2015-05-18 14:47:54 -04:00
Andrea Shepard
44aac630f6 Add NETWORK_LIVENESS event type and network-liveness GETINFO key 2015-05-18 14:45:56 -04:00
Damian Johnson
17f3fe0817 HS_DESC's HSAddress can be 'UNKNOWN' 
Commit ba30c1d accidently reverted dgoulet's change from aaf2434 to note that
HSFETCH can result in the address being 'UNKNOWN'.
 2015-05-09 11:56:56 -07:00
Donncha O'Cearbhaill
ba30c1df4a Add control spec entry for HSPOST, and update HS_DESC events. (#3523) 2015-05-07 14:15:38 +00:00
Yawning Angel
f5ff369120 Add #6411 changes to the spec. 2015-04-25 08:03:35 +00:00
Nick Mathewson
40dc315c80 Merge remote-tracking branch 'dgoulet/ticket14847_11' 2015-04-23 12:25:43 -04:00
Nick Mathewson
8f4e5fb66d Merge branch 'ticket14845_03' 2015-04-23 09:29:53 -04:00
David Goulet
f5da006c42 Add hs/client/desc/id key to GETINFO command 
Ref: #14845

Signed-off-by: David Goulet <dgoulet@ev0ke.net>
 2015-04-23 09:29:40 -04:00
David Goulet
aaf2434acf Add HSFETCH command and HS_DESC_CONTENT to control-spec 
This adds the HSFETCH command as well as the HS_DESC_CONTENT event to the
control specification.

The HS_DESC event is also changed a bit to fit the HSFETCH command case.

Ref.: #14847

Signed-off-by: David Goulet <dgoulet@ev0ke.net>
 2015-04-02 09:25:27 -04:00
Nick Mathewson
b941a70418 Add an atagar-suggested clarification 2015-03-09 13:07:55 -04:00
Nick Mathewson
b0ebde6878 describe host and hostaddr for bootstrap problems 2015-03-04 14:25:34 +01:00
Nick Mathewson
21be1dbeeb Fix issues noted by atagar 2015-02-27 11:42:48 -05:00
Nick Mathewson
e414a520ea Describe the HOST field of bootstrap messages, for 15006. 2015-02-27 11:29:54 -05:00
Damian Johnson
ed1a0dbfbb Standardizing on the name 'server descriptor' 
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.
 2015-02-24 20:12:39 -08:00
Nick Mathewson
f079eb102a Clarify that CString bug is output-only 2015-02-23 10:43:07 -05:00
Nick Mathewson
b9302fb0aa Document stupidity of our broken QuotedStrings. 2015-02-23 10:18:51 -05:00
Nick Mathewson
a7290cc82d Merge remote-tracking branch 'arthuredelstein/14555+' 2015-02-23 10:03:14 -05:00
cypherpunks
77e3a43149 Resolve FIXME. 
The AUTHCHALLENGE command was added in commit
e111e371b4f44456182e7f237837a0f9466487cd.
 2015-02-20 09:14:05 -05:00
Arthur Edelstein
01e7cb79bf Bug #14555: Clarify new CIRC attributes (SOCKS_USERNAME/PASSWORD) 2015-02-19 17:19:24 -08:00
Nick Mathewson
2c4c45d793 Add GETINFO consensus/* to spec 2015-02-12 14:47:19 -05:00
Sebastian Hahn
f7b696948e Fix logic error in controlspec 2015-02-07 10:47:58 +01:00
Sebastian Hahn
15b39fb4a7 Clarify a note about desc/id/* availability 2015-02-07 10:35:19 +01:00
David Goulet
a7b9120ac6 Update control spec with entry-guards down state 
Signed-off-by: David Goulet <dgoulet@ev0ke.net>
 2015-02-06 15:56:20 -05:00
Nick Mathewson
29759745fe Add #8405 changes to control-spec 2015-01-28 12:06:49 -05:00
Nick Mathewson
3c44820f38 specify GETINFO bw-event-cache for 14128 2015-01-07 13:22:24 -05:00
Nick Mathewson
9098fab087 Actually, this patch is going into 0.2.6.2-alpha, not 0.2.6.1-alpha 2014-12-30 09:56:14 -05:00
teor
96f068af44 If the consensus doesn't contain exits, don't build exit paths 
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-12-20 11:29:47 +11:00
Nick Mathewson
a35a97123e Merge remote-tracking branch 'rl1987/feature9503' 2014-11-25 12:47:49 -05:00
rl1987
7908c8dc96 Writing down possible values of reason string for 13212. 2014-11-16 16:27:35 +02:00
rl1987
1d1c11f12a Documenting HEARTBEAT controller signal. 2014-11-02 19:37:06 +02:00
Nick Mathewson
2ecd06fcfd Fix bogus negation in control-spec; spotted by Frithjof. 2014-06-11 09:53:19 -04:00
Nick Mathewson
42b373af2e document new exit-policy/* GETINFOs 2014-04-08 13:57:29 -04:00
Nick Mathewson
358e8ac978 Document new PT_MISSING reason for ending an OR_CONN 
(See #9665 for more background.)
 2014-04-07 22:23:30 -04:00
Nick Mathewson
398c01be40 mention ipv6 addresses in net/listeners/* doc 2014-03-12 12:27:59 -04:00
Damian Johnson
38de503d8f Clarifying the output of tor's "GETINFO net/listeners/*" options 
The control spec didn't fully describe the output of these GETINFO options.
This addresses...

  https://trac.torproject.org/11049
 2014-03-12 09:01:11 -07:00
Nick Mathewson
707ee6b0f6 Merge remote-tracking branch 'public/bug10449' 2014-02-25 16:11:46 -05:00
Roger Dingledine
10cfb4c63a ticket 9934 says DROPGUARDS is going into 0.2.5.2-alpha 2014-02-11 17:18:59 -05:00
Nick Mathewson
faac8a4129 Describe revised TAKEOWNERSHIP shutdown behavior 2014-02-03 12:56:50 -05:00
Qingping Hou
a67ac4db6b add hidden service descriptor asynchronous events 2014-01-29 23:13:09 -05:00
Nick Mathewson
df4bee06a9 Merge remote-tracking branches 'atagar/10086' and 'atagar/10085' 2013-11-04 13:33:32 -05:00
Damian Johnson
c77a39e565 Describing CONN_BW's ConnType 
Our new CONN_BW events' ConnType enumeration is poorly defined...

  https://trac.torproject.org/10086

This is just a guess on my part for what it's supposed to be. I have *not*
trudged through the tor code to puzzle out how it actually allocates this
enumeration.
 2013-11-03 10:44:33 -08:00
Damian Johnson
4b674a721d Don't enumerate event types in section 3.4 
When adding an event type we expect spec authors to edit both section 3.4 and
4.1.x. This is error prone...

  https://trac.torproject.org/10085

Dropping the redundant listing of event types and simply citing 4.1.x.
 2013-11-03 10:06:53 -08:00
Karsten Loesing
6f2919a2ed Merge implemented proposal 218 into control-spec.txt. 2013-10-31 09:15:17 +01:00
Nick Mathewson
7c6c7fc632 Rename DUMP->DROP, add a warning 2013-10-25 12:45:02 -04:00
r.a@posteo.net
59048c3120 add DUMPGUARDS command 2013-10-25 12:15:58 -04:00
George Kadianakis
c33d300eba Small clarification on the TRANSPORT_LAUNCHED control event. 
Spec confusion pointed out by atagar in #9588.
 2013-08-26 16:35:09 +03:00
Nick Mathewson
7936065770 Merge remote-tracking branch 'asn/bug7317' 2013-08-25 11:34:14 -04:00
Damian Johnson
d2b7ebb098 Noting that GETINFO ns/* options provide v3 directory information 
Tor moved from v2 to v3 directory information in commit 3ad6dc0e. Prior to that
Tor's 'GETINFO ns/*' options provided v2 information, but since then it's been
v3. For more information see...

https://trac.torproject.org/7953

Technically this is a tor bug, but it happens to be a convenient one so simply
updating our spec. In practice controller authors haven't noticed this
discrepancy because v3 router status entries are a superset of the fields in
v2.
 2013-06-20 07:52:00 -07:00
Nick Mathewson
fc9eef8d89 Merge remote-tracking branch 'desoxy/bug-8596' 2013-04-18 11:22:23 -04:00
Roger Dingledine
7286576de0 Document 555 return code from ATTACHSTREAM 
Fix for bug 8701.

(Commit message by nickm)
 2013-04-16 13:24:44 -04:00
Desoxy
ed7730dc1a control-spec: CACHED keyword for ADDRMAP events is quoted (#8596) 
The CACHED keyword is always quoted, I simply forgot to add it to the
specification. Caught and patched by atagar, thanks!
 2013-04-13 07:06:39 +02:00
Desoxy
25b0d43a9e contol-spec: Add "CACHED" keyword to ADDRMAP events (#8596) 2013-04-03 19:22:51 +02:00
Nick Mathewson
4528b69b89 Clarify GUARD event format: fix bug 7619. 2013-03-14 16:12:31 -04:00
Nick Mathewson
459b3c93b2 Clarify GETINFO response formatting for #6172 2013-03-11 14:15:01 -04:00
Nick Mathewson
b00456b35d Document MEASURE_TIMEOUT; bug 7626. 2013-03-11 14:07:14 -04:00
Damian Johnson
74b96e9dc1 Replacing CircID with CircuitID 
CircuitID is defined in section 2.4, but 'CircID' isn't. Using that general
definition in proposal 218 and also fixing a couple spots in the control-spec.
 2013-02-11 08:13:36 -08:00
Nick Mathewson
3ad9d19e03 Document a corner-case of the STREAM event format 
Fix for 7598
 2013-02-07 16:46:03 -05:00
Nick Mathewson
17c62eafac Clarify when router descriptors are still downloaded 2013-01-31 11:14:30 -05:00
Karsten Loesing
39fd75952d Further clarify GETINFO dir/server/* for recent Tors. 
Resolves #8116.
 2013-01-31 17:08:51 +01:00
Nick Mathewson
102418a56b Say when config-defaults-file was added in control-spec.txt 
Fixes bug 7684.
 2012-12-10 00:59:22 -05:00
Nick Mathewson
36d7d05041 Remove UPLOAD_DESC stream purpose entirely; add ref to DIR_UPLOAD 
Looking through a complete log of control.c, I see no sign that
UPLOAD_DESC ever actually existed.
 2012-11-23 15:03:33 -05:00
Nick Mathewson
b9b3c6f225 Add a couple more missing GETINFO items 2012-11-23 12:08:55 -05:00
Nick Mathewson
9716716527 Clarify QuotedString and what needs to get escaped in it 2012-11-23 11:56:09 -05:00
Nick Mathewson
a1331ca69d Document AUTHDIR_NEWDESCS better 2012-11-23 11:45:11 -05:00
Nick Mathewson
93574d1bca Oops; add another thing that triggers ADDRMAP 2012-11-23 11:40:04 -05:00
Nick Mathewson
12ce6bf77d Improve documentation for ADDRMAP controller events 
based on a patch from atagar and comments by rransom.

Fixes 7515.
 2012-11-23 11:38:44 -05:00
Nick Mathewson
4745fc3dba Make the forward-compatibility sec of control-spec more bulletproof 2012-11-23 11:27:46 -05:00
Nick Mathewson
901659e213 Note that UTCExpiry is omitted when Expiry is Never 
This corrects the format of addrmap events.

Fix for 6829
 2012-11-23 11:24:09 -05:00
Nick Mathewson
036e256491 Try to document Reason and Status for ORCONN events 
Should fix ticket 7513
 2012-11-23 11:18:48 -05:00
Nick Mathewson
e23a24a5c4 Document stream purposes. Fixes 7508. 2012-11-23 11:04:25 -05:00
Nick Mathewson
f811e9eb07 Add a reminder to control-spec that server descs aren't default now 
Clients now download microdescriptors, not full server descriptors, by
default. desc/* was tripping people up.
 2012-11-23 10:39:07 -05:00
Nick Mathewson
de62160552 Document MEASUREMENT_EXPIRED 2012-11-23 10:36:24 -05:00
Nick Mathewson
a14d7f33d4 Add some missing GETINFO info/names options 
Fixes the items listed in 3844.
 2012-11-23 10:28:13 -05:00
Nick Mathewson
d581e631e7 We mean UTC, not GMT. Fix bug 6113. 2012-11-23 09:57:09 -05:00
Karsten Loesing
c795510852 Fix two typos in control-spec.txt. 2012-11-08 19:18:26 -05:00
George Kadianakis
48f6dd0d9e Add TRANSPORT_LAUNCHED control port event. 2012-11-04 16:33:35 +02:00
Linus Nordberg
43fb11f580 Add "IPVersions" to CLIENTS_SEEN. 2012-10-21 00:13:15 +02:00
Nick Mathewson
9b1ca30bc5 control-spec: refer to a correct nonterminal in the "grammar" 
Reported by Richard Clayton via Steven Murdoch.
 2012-10-01 11:24:18 -04:00
Ravi Chandra Padmala
777ddbfce7 Fix misleading SETCIRCUITPURPOSE format 2012-08-23 14:02:48 -04:00
Nick Mathewson
de32af6f31 Say when config/defaults first appears 2012-06-28 15:17:45 -04:00
Nick Mathewson
d716b885bb Merge remote-tracking branch 'meejah/4971' 2012-06-28 15:17:22 -04:00
Roger Dingledine
8ad517f238 ORBindAddress is so 2005 (aka Tor 0.1.1.9-alpha) 2012-06-23 15:30:33 -04:00
Roger Dingledine
22959c4230 neena got (reasonably) confused by context-sensitive config options 2012-06-23 03:46:32 -04:00
Nick Mathewson
d7fe6a2f6e Document "GETINFO dormant". 2012-05-30 16:47:35 -04:00
meejah
a9bddcfc61 description for new GETINFO config/defaults 2012-04-06 21:35:47 -06:00
Nick Mathewson
714b0d391e We will remove COOKIE, but can't promise 0.2.4.1-alpha 
Once COOKIE authentication is gone, we should edit again to say
"Tor 0.2.4.xyz" rather than "a future version of Tor."
 2012-03-26 14:15:10 -04:00
Robert Ransom
4f92a35242 Document cookie-based authentication protocols in the right place 2012-02-20 09:09:48 -08:00
Robert Ransom
6b6c7aa656 Document CookieAuthFile 2012-02-20 09:09:48 -08:00
Robert Ransom
c402bdfeb0 Deprecate COOKIE authentication 2012-02-20 09:09:48 -08:00
Robert Ransom
c264c80df1 Add SAFECOOKIE control-port authentication method 2012-02-20 09:09:48 -08:00
Nick Mathewson
c4402e05e4 Cleanup: changes introduced on 0.2.3.11-alpha were listed as 0.2.3.2-alpha 2012-01-16 16:52:51 -05:00
Nick Mathewson
912742bffe Add CONF_CHANGED to eventcode list 2012-01-11 12:20:29 -05:00
Nick Mathewson
61511c1d93 Revise control-spec additions for CIRC_MINOR 2012-01-11 12:20:01 -05:00
Nick Mathewson
e398656414 Merge remote-tracking branch 'rransom-tor/feature3457-v2' 
Conflicts:
	control-spec.txt
 2012-01-11 12:13:15 -05:00
Nick Mathewson
50c33cb359 Merge remote-tracking branch 'rransom/bug2411a-v2' 2011-12-22 10:59:26 -05:00
Sebastian Hahn
57efa12578 Trivial whitespace cleanup 2011-11-26 04:09:21 +01:00
Robert Ransom
681c99ed25 Fix bogosity presumably left over from the v0 control protocol 2011-11-08 10:58:45 -08:00
Robert Ransom
dc73a42c5a Document GETINFO items added for #3832 2011-11-08 10:58:12 -08:00
Roger Dingledine
d4b656274e fix two bugs in the signal section of control-spec 
first, a hup signal doesn't make us refetch directory information

second, the 30-second controlled shutdown is actually a config option.
 2011-09-20 11:01:10 -04:00
Roger Dingledine
6011816082 renumber CONF_CHANGED section 2011-08-28 19:38:31 -04:00
Nick Mathewson
f30a4da9ab Fix ambiguity in splitting keyword from arguments 2011-08-28 19:37:58 -04:00
Nick Mathewson
361171e631 Clarify multi-line commands in control spec 2011-08-28 19:37:58 -04:00
Nick Mathewson
9fdd1107f8 Merge remote-tracking branch 'krkahn/bug1692' 2011-08-10 15:07:30 -04:00
Mike Perry
7b8a7fbf9b DIAF RFC2234. 
You suck at life and nobody will ever understand you.
 2011-08-10 10:07:25 -07:00
Mike Perry
043051b79f Clarify control port authentication. 
Encoded hex strings are useful, but the previous revision conflated them
with how the tor implementations stores them on disk.
 2011-08-10 09:58:42 -07:00
Kamran Riaz Khan
74f21a8ef8 Fixed EndLine for CONF_CHANGED event. 2011-08-09 18:54:10 +05:00
Kamran Riaz Khan
223656cdb1 Added definition of CONF_CHANGED event. 2011-08-09 07:38:02 +05:00
Nick Mathewson
882d000484 Clarify control-spec.txt on "tolerating" extra k=vs 
This brings control-spec.txt into compliance with what I meant when
I wrote the relevant portions; I note in the text that not all
controllers are currently compliant.
 2011-06-29 18:06:07 -04:00
Robert Ransom
ca3f983039 Document TIME_CREATED field of CIRC/CIRC2 events 2011-06-27 15:44:32 -07:00
Robert Ransom
c2627218b1 Explicitly allow future new types of CIRC2 events 2011-06-27 12:09:40 -07:00
Robert Ransom
e195a4c8d2 Document CIRC2 event 2011-06-27 12:09:40 -07:00
Robert Ransom
2f040bc03e Document new fields added for #2411 2011-06-27 10:53:52 -07:00
Robert Ransom
4651a4cf7f Fix spec typos 2011-06-23 16:53:03 -07:00
Robert Ransom
08ee50971e Fix trivial formatting issue 2011-06-16 00:30:18 -07:00
Robert Ransom
fb26214fbe Document (previously implemented) PURPOSE field of CIRC events 2011-06-16 00:29:31 -07:00
Nick Mathewson
21b54d39e5 Correct description of HiddenServiceOptions in control-spec. 
Two of the options it mentioned no longer exist; two more have been
added.  Fixes bug 3268.
 2011-05-24 11:11:32 -04:00
Robert Ransom
b91918eead Document the intended use of the ‘owning controller’ features 2011-05-23 01:24:53 -04:00
Robert Ransom
37d7a9e4c2 Document TAKEOWNERSHIP command 2011-05-23 01:24:52 -04:00
Robert Ransom
c4bba8b626 Document __OwningControllerProcess option 2011-05-23 01:24:52 -04:00
Robert Ransom
757f6dc617 Document LOADCONF 
Fixes bug 3222.
 2011-05-21 23:30:46 -07:00
Robert Ransom
c8ab383e47 Fix minor issue 2011-05-21 23:30:25 -07:00
Nick Mathewson
731705f03a It's 0.2.2.26-beta, not -alpha. 2011-05-17 18:10:34 -04:00
Nick Mathewson
e8b9f331bc Document feature3076-related GETINFO keys 2011-05-13 10:44:42 -04:00
Robert Ransom
051ed9a172 Fix minor issues 2011-05-09 19:32:55 -07:00
Nick Mathewson
56a66372d4 In specs, do not say "server" when we mean "relay" or "node" 
Fixes bug 2936.
 2011-05-09 10:37:02 -04:00
Robert Ransom
49b179585a Move a misplaced parenthesis 2011-04-19 17:16:29 -07:00
Robert Ransom
0f11e4f2ed Correct name of the __AllDirActionsPrivate option 2011-04-14 18:20:11 -07:00
Nick Mathewson
bb16925b43 Merge remote branch 'origin/maint-0.2.2' 2011-02-07 12:47:04 -05:00
Nick Mathewson
7ceb099c79 Add client code to detect attempts to connect to 127.0.0.1 etc 
We detect and reject said attempts if there is no chosen exit node or
circuit: connecting to a private addr via a randomly chosen exit node
will usually fail (if all exits reject private addresses), is always
ill-defined (you're not asking for any particular host or service),
and usually an error (you've configured all requests to go over Tor
when you really wanted to configure all _remote_ requests to go over
Tor).

This can also help detect forwarding loop requests.

Found as part of bug2279.
 2011-01-25 20:39:44 -05:00
Damian Johnson
6ca25c8c25 GETINFO options for querying traffic usage 
This was originally a patch provided by pipe
(http://www.mail-archive.com/or-talk@freehaven.net/msg13085.html) to
provide a method for controllers to query the total amount of traffic
tor has handled (this is a frequently requested piece of information
by relay operators).
 2011-01-07 12:15:14 -05:00
Damian Johnson
7e287f44ae Implementing getinfo options for the pid, uid, user, and descriptor limit as per proposal 173. 2011-01-03 12:04:56 -05:00
Nick Mathewson
cbdd7b4e5e Merge remote branch 'origin/maint-0.2.2' 2010-12-01 12:45:38 -05:00
Poet (Tim Sally)
130ff4614d Specified grammars for orconn-status and entry-guards for Tor versions 0.1.2.2-alpha through 0.2.2.1-alpha with feature VERBOSE_NAMES turned off. 2010-12-01 12:44:48 -05:00
Poet (Tim Sally)
847b60e973 Correct information about support for guards being called helper nodes. 
The spec stated that support for the helper-nodes command would be removed
in 0.1.3.x, however support for this command is still in Tor. Updated the spec
to reflect this and added a node that the command is deprecated.
 2010-12-01 12:44:48 -05:00
Poet (Tim Sally)
454206b954 Correct grammars to reflect that VERBOSE_NAMES is part of the protocol. 
Several updates to grammars for events and GETINFO results.  All relate
to the fact that LongName has replaced ServerID since 0.2.2.1-alpha. See
documentation of VERBOSE_NAMES for more information. The following
grammars were changed:
  * orconn-status GETINFO result
  * entry-guards GETINFO result
  * Path general token
  * OR Connection status changed event
  * New descriptors available event
In all cases a note was added about when the old grammar applies.
 2010-12-01 12:44:48 -05:00
Poet (Tim Sally)
5e84d3d3ee Several changes to the way tokens describing servers are documented. 
(1) Made the wording of the comments consistant with token names.
Digest/Fingerprint and Name/Nickname were being used interchangeably.
Better to just use Fingerprint and Nickname becuase they are the names
of the tokens.

(2) Places the tokens currently in use before the tokens used in older
versions.  ServerSpec should be documented before ServerID.

(3) Added a note to the comments about ServerID that cross reference
the VERBOSE_FEATURE, allowing users to see when and why ServerID was
replaced with LongName.
 2010-12-01 12:44:48 -05:00
Poet (Tim Sally)
1cc673a4b4 Clarify description of FEATURES in control-spec. 
(1) On by default is a bad way to describe features. Rather, they
are always on and should be viewed as a part of the control
protocol. Updated the wording in USEFEATURE to reflect this.

(2) Made descriptions of Tor versions consistant across all
features. There is the version in which a feature was introduced and
the version in which it became part of the protocol.

(3) Reworded the description of the VERBOSE_NAMES feature. The
previous wording describes the way things used to be first. Better to
lead with the current state of things and then describe how it differs
from old versions.
 2010-12-01 12:44:48 -05:00
Nick Mathewson
97d8076f5b Add some caveats to the signal event 2010-11-19 15:52:10 -05:00
John Brooks
b8a9d52884 Add a SIGNAL event for control connections 
Implements ticket #1955
 2010-11-19 15:49:54 -05:00
Karsten Loesing
bf8ef6d157 Make logging resolution configurable. 
Implements enhancement 1668.
 2010-10-04 08:15:18 +02:00
Mike Perry
73f533432e Send control port events for timeouts. 
We now differentiate between timeouts and cutoffs by the REASON string and
the PURPOSE string.
 2010-09-29 11:46:36 -07:00
Nick Mathewson
127336f8f5 Merge commit 'sebastian/misc-reason' 2010-08-15 21:27:32 -04:00
Sebastian Hahn
112518d41f Fix a typo in control-spec 2010-08-12 02:38:58 +02:00
Sebastian Hahn
b05e57b6fb Retry streams that ended with NOROUTE error 
Also add the NOROUTE reason to control-spec.
 2010-08-04 00:51:39 +02:00
Nick Mathewson
c87cb3f6d8 Merge remote branch 'mikeperry/cbt-bugfixes3' 2010-06-29 18:57:50 -04:00
Nick Mathewson
7dee71ff31 Make spec docs reference RFC2119 
Now people will have no excuse for not knowing what "MUST" and "MAY"
mean.  Fixes bug 1310.
 2010-06-25 14:58:25 -04:00
Mike Perry
44289c1bcc Add CLOSE_MS and CLOSE_RATE keywords to buildtimeout event. 2010-06-15 20:04:49 -07:00
Mike Perry
46a567c025 Add a TIMEOUT_RATE keyword to buildtimeout event. 2010-05-10 12:59:05 -07:00
Nick Mathewson
025645d95d Document possibility of "unknown" version state. 
reported by atagar; fixes bug 1289.
 2010-03-09 00:08:38 -05:00
Nick Mathewson
a6ea2a1fe7 Clarify that CRLF means "A CR then an LF". Explain what those are. 
Apparently this is not as obvious as I thought.
 2010-03-05 17:00:42 -05:00
Mike Perry
29f1a36c96 Allow "EXTENDCIRCUIT 0" to omit a path. 2010-02-18 09:08:31 -08:00
Mike Perry
8c222ff26d Add BUILDTIMEOUT_SET event for CBT stress testing. 2010-02-18 09:08:31 -08:00
Karsten Loesing
d54fd26f3a Fix bridge statistics. 
Fix statistics on client numbers by country as seen by bridges that were
broken in 0.2.2.1-alpha. Also switch to reporting full 24-hour intervals
instead of variable 12-to-48-hour intervals.
 2009-12-17 09:22:55 +01:00
Roger Dingledine
e23af39b5b New controller command "getinfo config-text" 
It returns the contents that Tor would write if you send it a SAVECONF
command, so the controller can write the file to disk itself.
 2009-12-13 19:21:06 -05:00
Roger Dingledine
67590745a2 correct the spec for the stream_bw event. 
"neonomad" pointed out on or-talk that the order is opposite from the
intuitive order. explain why. we chose to fix the spec rather than the
code because there are controllers like torflow that already expect
the current behavior.
 2009-10-10 15:07:37 -04:00
Roger Dingledine
c57ebf68ac a mish-mash of stuff in my sandbox 2009-09-17 01:58:39 -04:00
Nick Mathewson
64dce12ac8 Merge commit 'origin/maint-0.2.1' 2009-09-01 15:59:40 -04:00
Roger Dingledine
4f2f7672dc Add getinfo accepted-server-descriptor. Clean spec. 
Add a "getinfo status/accepted-server-descriptor" controller
command, which is the recommended way for controllers to learn
whether our server descriptor has been successfully received by at
least on directory authority. Un-recommend good-server-descriptor
getinfo and status events until we have a better design for them.
 2009-08-31 18:37:25 -04:00
Roger Dingledine
bffe671c5d Merge branch 'maint-0.2.1' 2009-08-28 03:47:18 -04:00
Roger Dingledine
ba73c90b36 Only send netinfo clock_skew to controller if an authority told us so 
We were triggering a CLOCK_SKEW controller status event whenever
we connect via the v2 connection protocol to any relay that has
a wrong clock. Instead, we should only inform the controller when
it's a trusted authority that claims our clock is wrong. Bugfix
on 0.2.0.20-rc; starts to fix bug 1074. Reported by SwissTorExit.
 2009-08-28 03:42:09 -04:00
Roger Dingledine
fd290e6650 fix typo in control-spec 2009-08-07 17:55:17 -04:00
Roger Dingledine
df46eec04b Patch from atagar to fix control-spec 
Specifically, admit that the "newconsensus" event exists, and
status/reachability has secretly been status/reachability-succeeded
all along, but nobody used it so we didn't notice.
 2009-07-30 03:41:02 -04:00
Roger Dingledine
c591c6ad0f resolve atagar's confusion with getinfo accounting 2009-07-13 17:34:47 -04:00
Nick Mathewson
dcc540eff7 Remove support for events without the extended format or long names. 
Supporting the old formats made our code complex; running without them
has been discouraged since 0.2.1.x.
 2009-05-25 12:52:25 -04:00
Sebastian Hahn
6bd09d5076 Remove all svn metadata minus what I missed. 
Tor doesn't use SVN anymore, making $Revision$, $Id$ and $Date$
meaningless. Remove them without replacement.
 2009-05-05 17:05:46 +02:00
Nick Mathewson
841b1e4369 Clarify that the nickname part of a LongName is indeed optional. 
svn:r19076
 2009-03-18 19:30:22 +00:00
Roger Dingledine
8d2a689e51 new controller event NEWCONSENSUS that lists the networkstatus 
lines for every recommended relay.

still needs docdoc and changelog entry.


svn:r18556
 2009-02-16 06:18:03 +00:00
Roger Dingledine
ea37df68d6 patch from matt to implement 'getinfo status/clients-seen' 
svn:r18287
 2009-01-28 06:50:36 +00:00
Roger Dingledine
a3295018a9 more minor bugs in the control spec 
svn:r18286
 2009-01-28 06:46:14 +00:00
Roger Dingledine
20bf59975e typo found by 'nil' 
svn:r18283
 2009-01-28 00:03:47 +00:00
Roger Dingledine
0b10e0f40a Let controllers actually ask for the "clients_seen" event. Bugfix 
on 0.2.1.10-alpha; reported by Matt Edman.


svn:r18201
 2009-01-21 03:24:27 +00:00
Nick Mathewson
607334a2cc AUTHENTICATE is really mandatory. No authentication is not quite the default. 
svn:r18024
 2009-01-08 14:07:05 +00:00
Roger Dingledine
f713a3b179 New controller event "clients_seen" to report a geoip-based summary 
of which countries we've seen clients from recently. Now controllers
like Vidalia can show bridge operators that they're actually making
a difference.


svn:r17796
 2008-12-27 06:50:07 +00:00
Nick Mathewson
784ee9e24b Add new internal-use-only option for controllers to use to prevent SIGHUP from reloading the configuration. Fixes bug 856. 
svn:r17567
 2008-12-10 22:17:02 +00:00
Nick Mathewson
0e8c949cc2 Specify the CONSENSUS_ARRIVED event. 
svn:r17536
 2008-12-09 18:17:07 +00:00
Roger Dingledine
4f7ee3046c Serve the latest v3 networkstatus consensus via the control 
port. Use "getinfo dir/status-vote/current/consensus" to fetch it.


svn:r16907
 2008-09-14 04:07:29 +00:00
Roger Dingledine
b7f5a34928 update and integrate proposals 125 (bridges) and 137 (bootstrap status) 
svn:r16374
 2008-08-03 15:34:28 +00:00
Roger Dingledine
628b9b7c95 start sending "bootstrap problem" status events when we're having troubles 
reaching relays.


svn:r15116
 2008-06-11 01:14:23 +00:00
Nick Mathewson
00d4ca0dc7 Fix the first part of bug 681, as suggested by Robert Hogan on or-talk. 
svn:r14754
 2008-05-27 21:02:36 +00:00
Nick Mathewson
43b4008fb3 r15704@host206: nickm | 2008-05-21 16:21:47 -0400 
Clarification/explanation patch for specs, from Killerchicken


svn:r14687
 2008-05-21 20:22:43 +00:00
Peter Palfrader
2250652ab1 Slightly clarify the control spec 
svn:r14362
 2008-04-12 16:58:20 +00:00
Nick Mathewson
5c022c7b94 r15024@tombo: nickm | 2008-03-29 01:37:09 -0400 
Close proposal 126 ("Getting GeoIP data and publishing usage summaries.")  It was never completely built, so note which parts wer and which were not.  Not-built parts would be good topics for future proposals.


svn:r14232
 2008-03-29 05:43:02 +00:00