tor/contrib
teor bd0e38dcfe
systemd: allow tor some time to shut down after ShutdownWaitLength expires
This commit upstreams the Debian package setting of 60 seconds for
TimeoutStopSec, but applies it to startup and shutdown.

Part of 28113.
2018-11-05 11:49:19 +10:00
..
clang mark sanitize_blacklist.txt as obsolete 2016-06-20 13:42:14 -04: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 systemd: allow tor some time to shut down after ShutdownWaitLength expires 2018-11-05 11:49:19 +10: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 to 0.2.9.17-dev 2018-09-10 09:41:22 -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.