tor/contrib
teor 3879c10162 Tweak clang sanitizer blacklist for out-of-tree builds, make, ccache
Avoid using file names and file paths for compatibility with
out-of-tree builds.

Note make and ccache don't track blacklist dependencies,
add workarounds.
2015-06-11 00:59:04 +10:00
..
clang Tweak clang sanitizer blacklist for out-of-tree builds, make, ccache 2015-06-11 00:59:04 +10:00
client-tools Clean the contrib directory with torch and machete. 2014-04-28 11:34:53 -04:00
dirauth-tools Clean the contrib directory with torch and machete. 2014-04-28 11:34:53 -04:00
dist Revert the broken part of 548b4be 2015-05-21 13:18:51 -04:00
operator-tools Clean the contrib directory with torch and machete. 2014-04-28 11:34:53 -04:00
or-tools Clean the contrib directory with torch and machete. 2014-04-28 11:34:53 -04:00
win32build Bump version to 0.2.7.1-alpha-dev 2015-05-12 11:54:06 -04:00
include.am Add a README file for the contrib directory 2014-05-07 01:03:35 -04:00
README Edit contrib/README to document the contrib/clang directory 2015-06-06 07:56:41 +10:00

The contrib/ directory contains small tools that might be useful for using
with Tor.  A few of them are included in the Tor source distribution; you can
find the others in the main Tor repository.  We don't guarantee that they're
particularly useful.

dirauth-tools/ -- Tools useful for directory authority administrators
---------------------------------------------------------------------

add-tor is an old script to manipulate the approved-routers file.

nagios-check-tor-authority-cert is a nagios script to check when Tor
authority certificates are expired or nearly expired.

clang/ -- Files for use with the clang compiler
-----------------------------------------------

sanitize_blacklist.txt is used to build Tor with clang's dynamic
AddressSanitizer and UndefinedBehaviorSanitizer. It contains detailed
instructions on configuration, build, and testing with clang's sanitizers.

client-tools/ -- Tools for use with Tor clients
-----------------------------------------------

torify is a small wrapper script around torsocks.

tor-resolve.py uses Tor's SOCKS port extensions to perform DNS lookups.  You
should probably use src/tools/tor-resolve instead.

dist/ -- Scripts and files for use when packaging Tor
-----------------------------------------------------

torctl, rc.subr, and tor.sh are init scripts for use with SysV-style init
tools.  Everybody likes to write init scripts differently, it seems.

tor.service is a sample service file for use with systemd.

The suse/ subdirectory contains files used by the suse distribution.

operator-tools/ -- Tools for Tor relay operators
------------------------------------------------

tor-exit-notice.html is an HTML file for use with the DirPortFrontPage
option.  It tells visitors that your relay is a Tor exit node, and that they
shouldn't assume you're the origin for the traffic that you're delivering.

tor.logrotate is a configuration file for use with the logrotate tool.  You
may need to edit it to work for you.

linux-tor-prio.sh uses Linux iptables tools to traffic-shape your Tor relay's
traffic. If it breaks, you get to keep both pieces.

or-tools/ -- Tools for interacting with relays
----------------------------------------------

checksocks.pl is a tool to scan relays to see if any of them have advertised
public SOCKS ports, so we can tell them not to.

check-tor is a quick shell script to try doing a TLS handshake with a router
or to try fetching a directory from it.

exitlist is a precursor of check.torproject.org: it parses a bunch of cached
server descriptors to determine which can connect to a given address:port.

win32build -- Old files for windows packaging
---------------------------------------------

You shouldn't need these unless you're building some of the older Windows
packages.