Nick Mathewson f470b863a0 Bump version to 4 years ago
clang 400b425078 mark sanitize_blacklist.txt as obsolete 8 years ago
client-tools 2529b29a75 Fix shellcheck warning SC2145 in torify script 5 years ago
dirauth-tools 7e415ec05a Fix SC2181 5 years ago
dist fb91e1c6ef Remove from contrib/dist 5 years ago
operator-tools fcb4d273fb Merge branch 'doc31089_040' into doc31089_041 4 years ago
or-tools 6fdd34acd6 Remove check-tor script 5 years ago
win32build f470b863a0 Bump version to 4 years ago
README 6d347fe329 Remove obsolete OpenSUSE initscript 5 years ago fb91e1c6ef Remove from contrib/dist 5 years ago


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. 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 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.

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. 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
---------------------------------------------- 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 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