NAME
torsocks - Shell wrapper to simplify the use of the torsocks(8) library
to transparently allow an application to use a SOCKS proxy. Basically a
renamed, patched tsocks.
SYNOPSIS
torsocks [application [application’s arguments]]
or torsocks [on|off]
or torsocks
DESCRIPTION
torsocks is a wrapper between the torsocks library and the application
what you would like to run socksified.
SUMMARY
By default, torsocks will assume that it should connect to the SOCKS
proxy running at 127.0.0.1 on port 9050. This is the default address
and port for Tor’s socks server on most installations.
In order to use a configuration file, you must set the environment
variable TORSOCKS_CONF_FILE with the location of the file.
If TORSOCKS_CONF_FILE is not set, torsocks will attempt to read the
configuration file at /etc/torsocks.conf. If that file cannot be read,
torsocks will use sensible defaults for most Tor installations, i.e. it
will assume that you want to use a SOCKS proxy running at 127.0.0.1
(localhost) on port 9050.
For further information on configuration, see torsocks.conf(5).
OPTIONS
[application [application’s arguments]]
run the application as specified with the environment
(LD_PRELOAD) set such that torsocks(8) will transparently proxy
SOCKS connections in that program
[on|off]
this option adds or removes torsocks(8) from the LD_PRELOAD
environment variable. When torsocks(8) is in this variable all
executed applications are automatically socksified. If you want
to use this function, you HAVE to source the shell script from
yours, like this: "source /usr/bin/torsocks" or ".
/usr/bin/torsocks"
Example:
". torsocks on" -- add the torsocks lib to LD_PRELOAD
". torsocks off" -- remove the torsocks lib from LD_PRELOAD
[show|sh]
show the current value of the LD_PRELOAD variable
<without any argument>
create a new shell with LD_PRELOAD including torsocks(8).
AUTHOR
This script was created by Tamas SZERB <toma@rulez.org> for the debian
package of tsocks. It (along with this manual page) have since been
adapted into the torsocks project and modified.