tor/contrib/torify.1

.TH torify 1 "" Jan-2009 ""
.\" manual page by Peter Palfrader and Jacob Appelbaum
.SH NAME
.LP
torify \- wrapper for torsocks or tsocks and tor

.SH SYNOPSIS
\fBtorify\fP\ \fIapplication\fP\ [\fIapplication's\ arguments\fP]

.SH DESCRIPTION
\fBtorify\fR is a simple wrapper that attempts to find the best underlying Tor
wrapper available on a system. It calls torsocks or tsocks with a tor specific
configuration file.

torsocks is an improved wrapper that explictly rejects UDP, safely resolves DNS
lookups and properly socksifies your TCP connections.

tsocks itself is a wrapper between the tsocks library and the application
that you would like to run socksified.

Please note that since both method use LD_PRELOAD, torify cannot be applied
to suid binaries.

.SH WARNING
You should also be aware that the way tsocks currently works only TCP
connections are socksified.  Be aware that this will in most circumstances
not include hostname lookups which would still be routed through your
normal system resolver to your usual resolving nameservers.  The
\fBtor-resolve\fR(1) tool can be useful as a workaround in some cases.
The Tor FAQ at https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ might
have further information on this subject.

When used with torsocks, torify should not leak DNS requests or UDP data.

Both will leak ICMP data.

.SH SEE ALSO
.BR tor (1),
.BR tor-resolve (1),
.BR torsocks (1),
.BR tsocks (1),
.BR tsocks.conf (5).
mention that tsocks only socksifies TCP In the torify(1) manpage explain that tsocks will only socksify TCP connections, and that therefore it will most likely leak DNS requests. svn:r18160 2009-01-18 02:05:17 +01:00			`.TH torify 1 "" Jan-2009 ""`
Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`.\" manual page by Peter Palfrader and Jacob Appelbaum`
Add torify svn:r1064 2004-02-17 01:46:59 +01:00			`.SH NAME`
			`.LP`
Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`torify \- wrapper for torsocks or tsocks and tor`
Add torify svn:r1064 2004-02-17 01:46:59 +01:00
			`.SH SYNOPSIS`
			`\fBtorify\fP\ \fIapplication\fP\ [\fIapplication's\ arguments\fP]`

			`.SH DESCRIPTION`
Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`\fBtorify\fR is a simple wrapper that attempts to find the best underlying Tor`
			`wrapper available on a system. It calls torsocks or tsocks with a tor specific`
Add torify svn:r1064 2004-02-17 01:46:59 +01:00			`configuration file.`

Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`torsocks is an improved wrapper that explictly rejects UDP, safely resolves DNS`
			`lookups and properly socksifies your TCP connections.`

favor correctness over grammar svn:r6244 2006-03-27 00:39:07 +02:00			`tsocks itself is a wrapper between the tsocks library and the application`
clean up the torify man page svn:r2377 2004-09-27 03:28:17 +02:00			`that you would like to run socksified.`
Add torify svn:r1064 2004-02-17 01:46:59 +01:00
Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`Please note that since both method use LD_PRELOAD, torify cannot be applied`
clean up the torify man page svn:r2377 2004-09-27 03:28:17 +02:00			`to suid binaries.`
Add torify svn:r1064 2004-02-17 01:46:59 +01:00
Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`.SH WARNING`
mention that tsocks only socksifies TCP In the torify(1) manpage explain that tsocks will only socksify TCP connections, and that therefore it will most likely leak DNS requests. svn:r18160 2009-01-18 02:05:17 +01:00			`You should also be aware that the way tsocks currently works only TCP`
			`connections are socksified. Be aware that this will in most circumstances`
			`not include hostname lookups which would still be routed through your`
Mention tor-resolve also svn:r18162 2009-01-18 02:08:48 +01:00			`normal system resolver to your usual resolving nameservers. The`
			`\fBtor-resolve\fR(1) tool can be useful as a workaround in some cases.`
			`The Tor FAQ at https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ might`
mention that tsocks only socksifies TCP In the torify(1) manpage explain that tsocks will only socksify TCP connections, and that therefore it will most likely leak DNS requests. svn:r18160 2009-01-18 02:05:17 +01:00			`have further information on this subject.`

Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`When used with torsocks, torify should not leak DNS requests or UDP data.`

			`Both will leak ICMP data.`

Add torify svn:r1064 2004-02-17 01:46:59 +01:00			`.SH SEE ALSO`
			`.BR tor (1),`
Mention tor-resolve also svn:r18162 2009-01-18 02:08:48 +01:00			`.BR tor-resolve (1),`
Make the torify script use torify when available. Update Torify to use torsocks by default and to warn when the user is using the older tsocks program. Update torify and the torify man page to refelect changes to torify. Add warnings in both. 2009-04-29 23:35:06 +02:00			`.BR torsocks (1),`
Add torify svn:r1064 2004-02-17 01:46:59 +01:00			`.BR tsocks (1),`
			`.BR tsocks.conf (5).`