[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