rewrite the documentation page. fold in faq, support, and developers too.
Roger Dingledine

Roger Dingledine commited on 2006-01-28 08:10:42
Zeige 1 geänderte Dateien mit 115 Einfügungen und 71 Löschungen.

... ...
@@ -5,103 +5,147 @@
5 5
 
6 6
 <div class="main-column">
7 7
 
8
-<h1>Table of Contents</h1>
9
-<hr />
8
+<a id="RunningTor"></a>
9
+<h2><a class="anchor" href="#RunningTor">Running Tor</a></h2>
10
+<ul>
11
+<li><a href="<cvssandbox>tor/doc/tor-doc-win32.html">Installing Tor
12
+on Win32</a></li>
13
+<li><a href="<cvssandbox>tor/doc/tor-doc-osx.html">Installing Tor on
14
+Mac OS X</a></li>
15
+<li><a href="<cvssandbox>tor/doc/tor-doc-unix.html">Installing Tor on
16
+Linux/BSD/Unix</a></li>
17
+<li><a href="<cvssandbox>tor/doc/tor-switchproxy.html">Installing
18
+SwitchProxy for Tor</a></li>
19
+<li><a href="<cvssandbox>tor/doc/tor-doc-server.html">Configuring a
20
+Tor server</a></li>
21
+<li><a href="<cvssandbox>tor/doc/tor-hidden-service.html">Configuring
22
+a Tor hidden service</a></li>
23
+</ul>
10 24
 
25
+<a id="Support"></a>
26
+<h2><a class="anchor" href="#Support">Support Avenues</a></h2>
11 27
 <ul>
12
-<li><a href="#RunningTor">Running Tor</a></li>
13
-<li><a href="#DesignDoc">Design Documents</a></li>
14
-<li><a href="#HOWTO">Various HOWTO Docs</a></li>
15
-<li><a href="#MailingLists">Mailing List Information</a></li>
28
+<li>The <a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">Tor
29
+Technical FAQ Wiki</a> should be the first place you look. (While we
30
+monitor the Wiki page to help ensure accuracy, the Tor developers are
31
+not responsible for the content.)</li>
32
+<li>The <a href="<page faq-abuse>">Abuse FAQ</a> is a collection of
33
+common questions and issues discussed when running a Tor server.</li>
34
+<li>The <a href="<page eff/tor-legal-faq>">Tor Legal FAQ</a> is written by
35
+EFF lawyers. It aims to give you an overview of some of the legal issues
36
+that arise from the Tor project in the US.</li>
37
+<li>The <a href="<page tor-manual>">manual</a>
38
+lists all the possible entries you can put in your <a
39
+href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#torrc">torrc
40
+file</a>. We also provide a <a href="<page tor-manual-cvs>">manual for
41
+the development version of Tor</a>.</li>
42
+<li>The <a href="http://wiki.noreply.org/noreply/TheOnionRouter">Tor
43
+wiki</a> provides a plethora of helpful contributions from Tor
44
+users. Check it out!</li>
45
+<li>The Tor IRC channel (for users, server operators, and developers)
46
+is <a href="irc://irc.oftc.net/tor">#tor on irc.oftc.net</a>.</li>
47
+<li>We have a <a
48
+href="http://bugs.noreply.org/tor">bugtracker</a>.
49
+If you have a bug, especially a crash bug, read <a
50
+href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ#ServerCrashing">how
51
+to report a Tor bug</a> first and then tell us as much information
52
+about it as you can in the bugtracker. (If your bug is
53
+with Privoxy, your browser, or some other application, please don't put
54
+it in our bugtracker.)</li>
55
+<li>Try the or-talk mailing list <a href="#MailingLists">below</a>.
56
+<li>As a last resort, look through <a href="<page contact>">the Tor
57
+contact page</a>.</li>
16 58
 </ul>
17
-<hr />
18 59
 
19
-<a id="RunningTor"></a>
20
-<h2><a class="anchor" href="#RunningTor">Running Tor</a></h2>
60
+<a id="MailingLists"></a>
61
+<h2><a class="anchor" href="#MailingLists">Mailing List Information</a></h2>
21 62
 <ul>
22
-<li><a href="<cvssandbox>tor/doc/tor-doc-win32.html">Installing Tor on Win32</a></li>
23
-<li><a href="<cvssandbox>tor/doc/tor-doc-osx.html">Installing Tor on Mac OS X</a></li>
24
-<li><a href="<cvssandbox>tor/doc/tor-doc-unix.html">Installing Tor on Linux/BSD/Unix</a></li>
25
-<li><a href="<cvssandbox>tor/doc/tor-switchproxy.html">Installing SwitchProxy for Tor</a></li>
26
-<li><a href="<cvssandbox>tor/doc/tor-doc-server.html">Configuring a Tor server</a></li>
27
-<li><a href="<cvssandbox>tor/doc/tor-hidden-service.html">Configuring a Tor hidden service</a></li>
63
+<li>The <a href="http://archives.seul.org/or/announce/">or-announce
64
+mailing list</a> is a low volume list for announcements of new releases
65
+and critical security updates. Everybody should be on this list.</li>
66
+<li>The <a href="http://archives.seul.org/or/talk/">or-talk list</a>
67
+is where a lot of discussion happens, and is where we send notifications
68
+of prerelease versions and release candidates.</li>
69
+<li>The <a href="http://archives.seul.org/or/dev/">or-dev list</a>
70
+is for posting by developers only, and is very low traffic.</li>
71
+<li>A list for <a href="http://archives.seul.org/or/cvs/">cvs commits</a>
72
+may be interesting for developers.</li>
28 73
 </ul>
29 74
 
30 75
 <a id="DesignDoc"></a>
31 76
 <h2><a class="anchor" href="#DesignDoc">Design Documents</a></h2>
32
-<p>The <b>design document</b> (published at Usenix
33
-Security 2004) gives our justifications and security analysis for the
34
-Tor design:</p>
35 77
 <ul>
36
-<li><a href="<cvssandbox>tor/doc/design-paper/tor-design.pdf">PDF version</a></li>
37
-<li><a href="<cvssandbox>tor/doc/design-paper/tor-design.html">HTML version</a></li>
38
-</ul>
39
-
40
-<p>Our follow-up paper on <b>challenges in low-latency anonymity</b>
78
+<li>The <b>design document</b> (published at Usenix Security 2004)
79
+gives our justifications and security analysis for the Tor design:
80
+<a href="<cvssandbox>tor/doc/design-paper/tor-design.pdf">PDF</a> and
81
+<a href="<cvssandbox>tor/doc/design-paper/tor-design.html">HTML</a>
82
+versions available.</li>
83
+<li>Our follow-up paper on <b>challenges in low-latency anonymity</b>
41 84
 (still in draft form) details more recent experiences and directions:
42
-<a href="<cvssandbox>tor/doc/design-paper/challenges.pdf">PDF version</a>.</p>
43
-
44
-<p>The <b>specification</b> aims to give
45
-developers enough information to build a compatible version of Tor:</p>
85
+<a href="<cvssandbox>tor/doc/design-paper/challenges.pdf">PDF
86
+version</a>.</li>
87
+<li>The <b>specifications</b> aim to give
88
+developers enough information to build a compatible version of Tor:
46 89
 <ul>
47 90
 <li><a href="<cvssandbox>tor/doc/tor-spec.txt">Main Tor specification</a></li>
48 91
 <li><a href="<cvssandbox>tor/doc/rend-spec.txt">Tor rendezvous specification</a></li>
49 92
 <li><a href="<cvssandbox>tor/doc/dir-spec.txt">Tor directory server specification</a></li>
50 93
 <li><a href="<cvssandbox>tor/doc/control-spec.txt">Tor UI control specification</a></li>
51
-</ul>
52
-
53
-<p>The <a href="<page tor-manual>"><b>manual</b></a> for the latest stable version
54
-provides detailed instructions for how to install and use Tor, including configuration
55
-of client and server options.<br />
56
-If you are running the CVS version the manual is available
57
-<a href="<page tor-manual-cvs>"><b>here</b></a>.
58
-</p>
59
-
60
-<p>The <a href="http://wiki.noreply.org/noreply/TheOnionRouter">wiki</a>
61
-provides a plethora of useful contributions from Tor users.</p>
62
-
63
-<p>Look at the <a href="http://freehaven.net/~arma/wth1.pdf">slides</a>
64
-from <a href="http://whatthehack.org/">What the Hack (WTH)</a>, and <a
65
-href="http://rehash.waag.org/WTH/wth-anonymous-communication-58.mp4.torrent">
66
-watch the video of the talk</a>. We also have <a
94
+</ul></li>
95
+<li>Look at the <a href="http://freehaven.net/~arma/wth1.pdf">slides
96
+(PDF)</a> and <a
97
+href="http://rehash.waag.org/WTH/wth-anonymous-communication-58.mp4.torrent">video
98
+(torrent)</a> from the Tor talk Roger gave at <a
99
+href="http://whatthehack.org/">What the Hack (WTH)</a>. We also have <a
67 100
 href="http://freehaven.net/~arma/wth3.pdf">slides</a> and <a
68 101
 href="http://rehash.waag.org/WTH/wth_tor_hidden_services.mp4.torrent">video</a>
69
-of the WTH talk on hidden services.
70
-</p>
102
+of the WTH talk on hidden services.</li>
103
+</ul>
71 104
 
72
-<a id="HOWTO"></a>
73
-<h2><a class="anchor" href="#HOWTO">Various HOWTO Docs</a></h2>
105
+<a id="NeatLinks"></a>
106
+<h2><a class="anchor" href="#NeatLinks">Neat Links</a></h2>
74 107
 <ul>
75
-<li><a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Guide
76
-to Tor-ifying various applications</a></li>
77
-<li><a
78
-href="http://wiki.noreply.org/noreply/TheOnionRouter/OperationalSecurity">How
79
-to Run a Secure Tor Server</a></li>
108
+<li>The <a href="http://wiki.noreply.org/noreply/TheOnionRouter">Tor
109
+wiki</a> provides a plethora of helpful contributions from Tor
110
+users. Check it out!</li>
111
+<li>The <a href="http://6sxoyfb3h2nvok2d.onion/">hidden wiki</a> is a
112
+portal for all things about hidden services.</li>
113
+<li>The <a
114
+href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Guide
115
+to Tor-ifying various applications.</a></li>
80 116
 <li><a
81
-href="http://wiki.noreply.org/wiki/TheOnionRouter/TorInChroot">Running
82
-Tor in a Linux chroot</a></li>
83
-<li><a
84
-href="http://wiki.noreply.org/noreply/TheOnionRouter/OpenbsdChrootedTor">chroot
85
-guide for OpenBSD</a></li>
86
-<li><a
87
-href="http://wiki.noreply.org/wiki/TheOnionRouter/SquidProxy">Squid and
88
-Tor</a></li>
117
+href="http://wiki.noreply.org/noreply/TheOnionRouter/SupportPrograms">A
118
+list of supporting programs you might want to use in association with
119
+Tor</a>.</li>
120
+<li><a href="http://www.noreply.org/tor-running-routers/">Weasel's graph
121
+of the number of Tor servers over time</a>.</li>
122
+<li>To learn more details of the current Tor nodes, look at Geoff
123
+Goodell's <a href="http://serifos.eecs.harvard.edu/cgi-bin/exit.pl">list
124
+of Tor exit nodes by country</a>.</li>
89 125
 </ul>
90 126
 
91
-<a id="MailingLists"></a>
92
-<h2><a class="anchor" href="#MailingLists">Mailing List Information</a></h2>
127
+<a id="Developers"></a>
128
+<h2><a class="anchor" href="#Developers">Developers</a></h2>
129
+Browse the Tor <b>CVS repository</b>: (which may not
130
+necessarily work or even compile)</p>
93 131
 <ul>
94
-<li> The <a href="http://archives.seul.org/or/announce/">or-announce
95
-mailing list</a> is a low volume list for announcements of new releases.
132
+<li><a href="<cvssandbox>">Regularly updated CVS sandbox</a></li>
133
+<li><a
134
+href="http://cvs.seul.org/viewcvs/viewcvs.cgi/?root=tor">ViewCVS</a></li>
135
+<li><a href="http://archives.seul.org/or/cvs/">Mailing list for cvs
136
+commits</a></li>
137
+<li>anonymous pserver access (password is guest):
138
+<ul>
139
+<li>Make a new empty directory and cd into it.</li>
140
+<li>cvs -d :pserver:guest@cvs.seul.org:/home/or/cvsroot login</li>
141
+<li>cvs -d :pserver:guest@cvs.seul.org:/home/or/cvsroot co tor</li>
142
+<li>cd tor; ./autogen.sh; make; make install if you like.</li>
143
+<li>(use "co -r tor-0_1_1_4_alpha tor" to fetch a particular version.)</li>
144
+<li>(To check out the maintenance branch, use -r tor-0_1_0-patches)</li>
145
+</ul>
96 146
 </li>
97
-<li> The <a href="http://archives.seul.org/or/talk/">or-talk mailing
98
-list</a> is where a lot of the discussion happens, and is where we
99
-send notifications of prereleases and release candidates. </li>
100
-<li> The <a href="http://archives.seul.org/or/dev/">or-dev mailing
101
-list</a> is for posting by developers only, and is very low traffic. </li>
102
-<li> There's also a list for <a
103
-href="http://archives.seul.org/or/cvs/">cvs commits</a>.</li>
104 147
 </ul>
148
+
105 149
   </div><!-- #main -->
106 150
 
107 151
 #include <foot.wmi>
108 152