[tor-commits] [torsocks/master] doc: Clarify the libc limitation in README

dgoulet at torproject.org dgoulet at torproject.org
Fri Apr 20 13:18:39 UTC 2018


commit fd7b0d71a0e9f511d2e32fde51fc4f63c5fb7000
Author: David Goulet <dgoulet at ev0ke.net>
Date:   Fri Apr 20 09:11:05 2018 -0400

    doc: Clarify the libc limitation in README
    
    Fixes #22068
    
    Signed-off-by: David Goulet <dgoulet at ev0ke.net>
---
 README.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 8ad574f..dde1676 100644
--- a/README.md
+++ b/README.md
@@ -7,9 +7,13 @@ Torsocks allows you to use most applications in a safe way with Tor. It ensures
 that DNS requests are handled safely and explicitly rejects any traffic other
 than TCP from the application you're using.
 
-Torsocks is an ELF shared library that is loaded before all others. The library
-overrides every needed Internet communication libc function calls such as
-connect(2) or gethostbyname(3).
+Torsocks is an ELF shared library that is loaded before all others. The
+library overrides every needed Internet communication libc function calls such
+as connect(2) or gethostbyname(3).
+
+BE ADVISE: It uses the LD\_PRELOAD mechanism (man ld.so.8) which means that if
+the application is not using the libc or for instance uses raw syscalls,
+torsocks will be useless and the traffic will not go through Tor.
 
 This process is transparent to the user and if torsocks detects any
 communication that can't go through the Tor network such as UDP traffic, for
@@ -20,7 +24,7 @@ will force the application to quit and stop everything.
 Requirements
 -----------------
 
-    - autoconf
+	- autoconf
 	- automake
 	- libtool
 	- gcc





More information about the tor-commits mailing list