release/src/router/tor/contrib/README

   1 The contrib/ directory contains small tools that might be useful for using
   2 with Tor.  A few of them are included in the Tor source distribution; you can
   3 find the others in the main Tor repository.  We don't guarantee that they're
   4 particularly useful.
   5
   6 dirauth-tools/ -- Tools useful for directory authority administrators
   7 ---------------------------------------------------------------------
   8
   9 add-tor is an old script to manipulate the approved-routers file.
  10
  11 nagios-check-tor-authority-cert is a nagios script to check when Tor
  12 authority certificates are expired or nearly expired.
  13
  14 client-tools/ -- Tools for use with Tor clients
  15 -----------------------------------------------
  16
  17 torify is a small wrapper script around torsocks.
  18
  19 tor-resolve.py uses Tor's SOCKS port extensions to perform DNS lookups.  You
  20 should probably use src/tools/tor-resolve instead.
  21
  22 dist/ -- Scripts and files for use when packaging Tor
  23 -----------------------------------------------------
  24
  25 torctl, rc.subr, and tor.sh are init scripts for use with SysV-style init
  26 tools.  Everybody likes to write init scripts differently, it seems.
  27
  28 tor.service is a sample service file for use with systemd.
  29
  30 The suse/ subdirectory contains files used by the suse distribution.
  31
  32 operator-tools/ -- Tools for Tor relay operators
  33 ------------------------------------------------
  34
  35 tor-exit-notice.html is an HTML file for use with the DirPortFrontPage
  36 option.  It tells visitors that your relay is a Tor exit node, and that they
  37 shouldn't assume you're the origin for the traffic that you're delivering.
  38
  39 tor.logrotate is a configuration file for use with the logrotate tool.  You
  40 may need to edit it to work for you.
  41
  42 linux-tor-prio.sh uses Linux iptables tools to traffic-shape your Tor relay's
  43 traffic. If it breaks, you get to keep both pieces.
  44
  45 or-tools/ -- Tools for interacting with relays
  46 ----------------------------------------------
  47
  48 checksocks.pl is a tool to scan relays to see if any of them have advertised
  49 public SOCKS ports, so we can tell them not to.
  50
  51 check-tor is a quick shell script to try doing a TLS handshake with a router
  52 or to try fetching a directory from it.
  53
  54 exitlist is a precursor of check.torproject.org: it parses a bunch of cached
  55 server descriptors to determine which can connect to a given address:port.
  56
  57 win32build -- Old files for windows packaging
  58 ---------------------------------------------
  59
  60 You shouldn't need these unless you're building some of the older Windows
  61 packages.