-* tor-hacking-utils *-

Incredibly crude (i.e., lame) tools that wrap some other basic system
utilities to work over Tor.  Basically, I got tired of constantly
recreating these with socat so I collected them into some scripts.

These tools currently require tor-resolve, socat and Perl.  These were
developed and used on Ubuntu Linux.

NOTE: All scripts run extremely slowly.

-* contents *-

mktorfw.sh: create a very restrictive iptables firewall.  Only those
            IP/port combinations in /var/lib/tor/cached-descriptors*
            are allowed (or /var/lib/tor/cached-routers* for
            pre-0.2.0.7). This is mainly useful for leak testing.

	    For example, to create initial firewall:

	      ./mktorfw.sh -i eth0

	    To keep the firewall up-to-date:

	      install -m0755 mktorfw.sh libutiltor.sh /sbin

	    and, create a crontab entry to run update frequently:
              
	      */5 * *   *   *   root  /sbin/mktorfw.sh -u -i eth0

tor-whois: run whois commands over Tor by connecting to SOCKS port.
           Not all commands maybe supported.

tor-dig: run dig commands over Tor by connecting to SOCKS port; target
         name servers must support connections via TCP for this to
         work.  Many do, so it should not be a major issue.

dbut: a domain brute force tool that uses Tor.  The target name
      servers should support TCP, but if all of these fail,
      'tor-resolve' is used instead.  The included 'common-names'
      contains a small list of common host names.  Search the Internet
      for other lists of host names.

libutiltor.sh: common functionality for shell scripts

socks-http.pl: implements basic HTTP functionality that talks directly
      to the Tor SOCKS port.  Doesn't currently support SSL.

  usage: ./socks-http.pl [options] URI
  
     make HTTP request via Tor
  
  options:
   -O, --output=<file>             Output (defaults to STDOUT)
   -OO, --output-overwrite=<file>  Output and overwrite
   --referer=<referer>
   -U, --user-agent=<UA>           User-agent
   --host=<host>
   --method=<method>               GET,HEAD,TRACE,etc.
   --debug                         print request
   --socksdebug                    enable SOCKS debugging
   --request=<file>                read request from file
   -S, --server-response           print server response
   --post-data=<data>              send post data
   --post-file=<file>              send post data from file
   --header=<header>               Added HTTP header (can be repeated)
   --url-encode                    URL encode the request PATH
   --help                          Display this help
  

IO_Socket_Socks.pm: included IO::Socket::Socks package is GPLv2
     Copyright (C) 2003 Ryan Eatmon.  See file for details.