en/documentation.wml (c2b6c141f) - tor-webwml.git

documentation.wml

## translation metadata
# Revision: $Revision$

#include "head.wmi" TITLE="Documentation"

<a id="RunningTor"></a>
<h2><a class="anchor" href="#RunningTor">Running Tor</a></h2>
<ul>
<li><a href="<page docs/tor-doc-win32>">Installing Tor
on Win32</a></li>
<li><a href="<page docs/tor-doc-osx>">Installing Tor on
Mac OS X</a></li>
<li><a href="<page docs/tor-doc-unix>">Installing Tor on
Linux/BSD/Unix</a></li>
<li><a href="<page docs/tor-switchproxy>">Installing
SwitchProxy for Tor</a></li>
<li><a href="<page docs/tor-doc-server>">Configuring a
Tor server</a></li>
<li><a href="<page docs/tor-hidden-service>">Configuring
a Tor hidden service</a></li>
</ul>

<a id="Support"></a>
<h2><a class="anchor" href="#Support">Getting Support</a></h2>
<ul>
<li>The <a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">Tor
Technical FAQ Wiki</a> should be the first place you look. The
<a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Guide
to Torifying various applications</a> is also popular. (While we
monitor the Wiki page to help ensure accuracy, the Tor developers are
not responsible for the content.)</li>
<li>The <a href="<page faq-abuse>">Abuse FAQ</a> is a collection of
common questions and issues discussed when running a Tor server.</li>
<li>The <a href="<page eff/tor-legal-faq>">Tor Legal FAQ</a> is written by
EFF lawyers. It aims to give you an overview of some of the legal issues
that arise from the Tor project in the US.</li>
<li>The <a href="<page tor-manual>">manual</a>
lists all the possible entries you can put in your <a
href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#torrc">torrc
file</a>. We also provide a <a href="<page tor-manual-dev>">manual for
the development version of Tor</a>.</li>
<li>The <a href="http://wiki.noreply.org/noreply/TheOnionRouter">Tor
wiki</a> provides a plethora of helpful contributions from Tor
users. Check it out!</li>
<li>The Tor IRC channel (for users, server operators, and developers)
is <a href="irc://irc.oftc.net/tor">#tor on irc.oftc.net</a>.</li>
<li>We have a <a
href="http://bugs.noreply.org/tor">bugtracker</a>.
If you have a bug, especially a crash bug, read <a
href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ#ServerCrashing">how
to report a Tor bug</a> first and then tell us as much information
about it as you can in the bugtracker. (If your bug is
with Privoxy, your browser, or some other application, please don't put
it in our bugtracker.)</li>
<li>Try the or-talk mailing list <a href="#MailingLists">below</a>.
<li>As a last resort, look through <a href="<page contact>">the Tor
contact page</a>.</li>
</ul>

<a id="MailingLists"></a>
<h2><a class="anchor" href="#MailingLists">Mailing List Information</a></h2>
<ul>
<li>The <a href="http://archives.seul.org/or/announce/">or-announce
mailing list</a> is a low volume list for announcements of new releases
and critical security updates. Everybody should be on this list.
There is also an
<a href="http://rss.gmane.org/gmane.network.onion-routing.announce">RSS
feed</a> of or-announce at <a href="http://gmane.org">gmane.org</a>.</li>
<li>The <a href="http://archives.seul.org/or/talk/">or-talk list</a>
is where a lot of discussion happens, and is where we send notifications
of prerelease versions and release candidates.</li>
<li>The <a href="http://archives.seul.org/or/dev/">or-dev list</a>
is for posting by developers only, and is very low traffic.</li>
<li>A list for <a href="http://archives.seul.org/or/cvs/">cvs commits</a>
may be interesting for developers.</li>
</ul>

<a id="DesignDoc"></a>
<h2><a class="anchor" href="#DesignDoc">Design Documents</a></h2>
<ul>
<li>The <b>design document</b> (published at Usenix Security 2004)
gives our justifications and security analysis for the Tor design:
<a href="<svnsandbox>doc/design-paper/tor-design.pdf">PDF</a> and
<a href="<svnsandbox>doc/design-paper/tor-design.html">HTML</a>
versions available.</li>
<li>Our follow-up paper on <b>challenges in low-latency anonymity</b>
(still in draft form) details more recent experiences and directions:
<a href="<svnsandbox>doc/design-paper/challenges.pdf">PDF
draft</a>.</li>
<li>Our preliminary design to make it harder for large firewalls to
prevent access to the Tor network is described in
<b>design of a blocking-resistant anonymity system</b>:
<a href="<svnsandbox>doc/design-paper/blocking.pdf">PDF draft</a>. You
can also see <a
href="http://freehaven.net/~arma/slides-23c3.pdf">slides</a> and <a
href="http://freehaven.net/~arma/23C3-1444-en-tor_and_china.m4v">video</a>
from Roger's <a href="http://events.ccc.de/congress/2006/Home">23C3
talk</a>. Want to <a href="<page volunteer>#Coding">help us build
it</a>?</li>
<li>The <b>specifications</b> aim to give
developers enough information to build a compatible version of Tor:
<ul>
<li><a href="<svnsandbox>doc/spec/tor-spec.txt">Main Tor specification</a>
<li><a href="<svnsandbox>doc/spec/dir-spec.txt">Tor
version 3 directory server specification</a> (and older <a
href="<svnsandbox>doc/spec/dir-spec-v1.txt">version 1</a> and <a
href="<svnsandbox>doc/spec/dir-spec-v2.txt">version 2</a> directory
specifications)</li>
<li><a href="<svnsandbox>doc/spec/control-spec.txt">Tor control protocol
specification</a></li>
<li><a href="<svnsandbox>doc/spec/rend-spec.txt">Tor rendezvous
specification</a></li>
<li><a href="<svnsandbox>doc/spec/path-spec.txt">Tor path selection
specification</a></li>
<li><a href="<svnsandbox>doc/spec/address-spec.txt">Special hostnames in
Tor</a></li>
<li><a href="<svnsandbox>doc/spec/socks-extensions.txt">Tor's SOCKS support
and extensions</a></li>
<li><a href="<svnsandbox>doc/spec/version-spec.txt">How Tor version numbers
work</a></li>
<li><a href="<svnsandbox>doc/spec/proposals/">In-progress drafts of
new specifications and proposed changes.</li>
</ul></li>
<li>Look at the <a href="http://freehaven.net/~arma/wth1.pdf">slides
(PDF)</a> and <a
href="http://rehash.waag.org/WTH/wth-anonymous-communication-58.mp4.torrent">video
(torrent)</a> from the Tor talk Roger gave at <a
href="http://whatthehack.org/">What the Hack (WTH)</a>. We also have <a
href="http://freehaven.net/~arma/wth3.pdf">slides</a> and <a
href="http://rehash.waag.org/WTH/wth_tor_hidden_services.mp4.torrent">video</a>
of the WTH talk on hidden services.</li>
</ul>

<a id="NeatLinks"></a>
<h2><a class="anchor" href="#NeatLinks">Neat Links</a></h2>
<ul>
<li>The <a href="http://wiki.noreply.org/noreply/TheOnionRouter">Tor
wiki</a> provides a plethora of helpful contributions from Tor
users. Check it out!</li>
<li>The <a href="http://6sxoyfb3h2nvok2d.onion/">hidden wiki</a> is a
portal for all things about hidden services.</li>
<li><a
href="http://wiki.noreply.org/noreply/TheOnionRouter/SupportPrograms">A
list of supporting programs you might want to use in association with
Tor</a>.</li>
<li><a href="http://www.noreply.org/tor-running-routers/">Weasel's graph
of the number of Tor servers over time</a>.</li>
<li><a href="http://lefkada.eecs.harvard.edu/cgi-bin/ipaddr.pl?tor=1">The
Tor detector</a> tries to guess if you're using Tor or not.</li>
<li>Check out Geoff Goodell's
<a href="http://lefkada.eecs.harvard.edu/cgi-bin/exit.py">Tor Network
Status</a> page, or Xenobite's <a
href="https://torstat.xenobite.eu/">Tor node status page</a>, or
NightEffect's <a href="https://nighteffect.us/tns">Tor Network Status</a>
page. Remember that these lists may not be as accurate as what your Tor
client uses, because your client fetches all the authoritative directories
and combines them locally.</li>
<li>Read <a
href="http://freehaven.net/anonbib/topic.html#Anonymous_20communication">these
papers</a> (especially the ones in boxes) to get up to speed on the field
of anonymous communication systems.</li>
</ul>

<a id="Developers"></a>
<h2><a class="anchor" href="#Developers">For Developers</a></h2>
  Browse the Tor <b>source repository</b>: (which may not necessarily work or even compile)
  <ul>
    <li><a href="<svnsandbox>">Regularly updated SVN sandbox</a></li>
    <li><a href="https://tor-svn.freehaven.net/svn/tor/trunk">Browse the repository's source tree directly</a></li>
    <li><a href="http://cvs.seul.org/viewcvs/viewcvs.cgi/tor/?root=Tor">ViewCVS</a></li>
    <li>anonymous <a href="http://subversion.tigris.org/">subversion</a> access:
      <ul>
        <li>Make a new empty directory and cd into it.</li>
        <li><kbd>svn checkout https://tor-svn.freehaven.net/svn/tor/trunk tor</kbd></li>
        <li><kbd>svn checkout https://tor-svn.freehaven.net/svn/website/trunk website</kbd></li>
        <li>To check out the maintenance branch, use<br /><kbd>svn checkout https://tor-svn.freehaven.net/svn/tor/branches/tor-0_1_2-patches</kbd></li>
      </ul><br>
      <b>HTTPS certificate fingerprint:</b> 11:34:5c:b1:c4:12:76:10:86:ce:df:69:3d:06:a9:57:fa:dc:c9:29
    </li>
  </ul>

</div>

#include <foot.wmi>

tor-webwml.git

mention the older dir specs too, plus the socks-extensions doc.