[tor-commits] [torsocks/master] Update README

dgoulet at torproject.org dgoulet at torproject.org
Fri Apr 4 22:40:26 UTC 2014

commit 9191e2dfbec68aa38d2a32a310b9edb3797c1033
Author: David Goulet <dgoulet at ev0ke.net>
Date:   Sat Aug 24 16:16:49 2013 -0400

    Update README
    Signed-off-by: David Goulet <dgoulet at ev0ke.net>
 README |   84 ++++------------------------------------------------------------
 1 file changed, 5 insertions(+), 79 deletions(-)

diff --git a/README b/README
index e30ea63..475ff2c 100644
--- a/README
+++ b/README
@@ -1,94 +1,20 @@
 What is torsocks?
-This is a fork of the tsocks project (http://sourceforge.net/project/
-showfiles.php?group_id=17338). The purpose of this fork is to maintain a
-working implementation of tsocks that is primarily useful for Tor.
-The project homepage is:
+Torsocks allows you to use most socks-friendly applications in a safe way with
+Tor. It ensures that DNS requests are handled safely and explicitly rejects any
+traffic other then TCP from the application you're using. 
 Using torsocks
 Torsocks allows you to use most socks-friendly applications in a safe way with Tor.
 Once you have installed torsocks, just launch it like so:
-  usewithtor [application]
+  torsocks [application]
 So, for example you can use ssh to a some.ssh.com by doing:
-  usewithtor ssh username at some.ssh.com 
-or launch pidgin by doing:
-  usewithtor pidgin 
-The following applications are known to be compatible with usewithtor:
-Type  Application   Comments
-COMM  ssh
-COMM  telnet        (plaintext passwords are not recommended with Tor)
-IM    pidgin
-IM    kopete
-IRC   konversation
-MAIL  claws-mail
-DEV   svn
-IRC   xchat
-IRC   irssi
-IRC   silc
-Differences between torsocks and tsocks
-A complete history of changes is maintained in the Changelog. The initial
-working copy of torsocks was obtained through the following steps in June
-  - Tsocks was downloaded from the project's sourceforge repository.
-    (http://sourceforge.net/project/showfiles.php?group_id=17338)
-  - All patches listed at http://wiki.noreply.org/noreply/TheOnionRouter/
-    TSocksPatches in March 2008 were applied. In particular, the patch
-    from Total Information Security that hooks DNS requests and passes
-    them to Tor. The original link for this patch is now dead and the
-    authors are no longer available at the email addresses supplied in
-    the patch's source.
-  - Weasel's getpeername() patch and some build-related patches from
-    https://giig.ugr.es/~rgarcia/tsocks/ were applied.
-  - All references to tsocks in the project source files were renamed
-    to torsocks.
-  - The project was then migrated to an automake/autoconf build system.
-To help with reconstructing the above steps a list of applied patches is
-available in the patches/ subdirectory of the torsocks source tree.
-Enhancements unique to torsocks
-The first release of torsocks contained the following enhancements:
-  - Torifying reverse dns requests through gethostbyaddr()
-  - Blocking of UDP traffic from sendto() and its variants.
-  - Use of Tor-friendly defaults if no configuration file available.
-  - The addition of all RFC defined private address ranges to the
-    default configuration.
-Maintainers of Torsocks
-Torsocks is maintained by: Robert Hogan (robert at roberthogan.net)
-                           Ruben Garcia (ruben at ugr.es)
-Original tsocks project (apparently abandoned):
-Ruben's fork of tsocks on which this is based:
-The Tor project's list of tsocks patches:
+  torsocks ssh username at some.ssh.com 
 The Tor project:

More information about the tor-commits mailing list