commit fd7b0d71a0e9f511d2e32fde51fc4f63c5fb7000 Author: David Goulet dgoulet@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@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