SOCKSIFY(1)SOCKSIFY(1)NAMEsocksify - runtime socksification of selected programs
DESCRIPTION
The shell script socksify is meant to aid in using socks with already
compiled dynamic binaries. This works by setting the LD_PRELOAD envi‐
ronment variable to libdsocks. It will then attempt to wrap all net‐
working-related system calls.
When used the script can socksify a program by simply prefixing the
given program and it's arguments with the the socksify script, like in
the example below.
$ socksify ftp ftp.example.org
ENVIRONMENT
The socksify script, and the Dante socks library used by the socksify
script, can interpret several environment variables.
SOCKS_CONF
Gives the name of the socks.conf file. Default is
/etc/opt/csw/socks.conf, unless it was changed when compiling
the Dante libsocks libraries.
Creating a socks.conf is the recommended way to use socksify,
but socksify can also be used for most simple configurations
without any socks.conf file, as long as the proxy server to use
is set in one of the supported environment variables.
SOCKS_DEBUG
Enables debug loging. The value given should be a number, one
or up, indicating the level of debuging provided.
SOCKS_LOGOUTPUT
This value controls where the client library sends logoutput.
It can be either syslog, stdout, stderr, a filename, or a combi‐
nation. The default is nowhere.
SOCKS_USERNAME
Use the value of SOCKS_USERNAME as the username when doing user‐
name authentication.
SOCKS_PASSWORD
Use the value of SOCKS_PASSWORD as the password when doing user‐
name authentication. Not recommended as other users on the sys‐
tem might be able to see your password.
SOCKS_SERVER, SOCKS4_SERVER, SOCKS5_SERVER,
These variables allow the address of the server to be specified
without having a socks.conf file. The accepted format is <ipad‐
dress>:<port>. If the SOCKS_SERVER value is set, it indicates
the specified server supports all socks versions supported by
Dante. If if either of the other two variables are used, they
indicate the given socks server supports only the corresponding
socks version, v4 or v5.
HTTP_PROXY
This variable can be used to specify the location of a HTTP
proxy supporting the connect command. The format used to spec‐
ify a HTTP proxy is <ipaddress>:<port>.
UPNP_IGD
This variable can be used to specify the location of a UPNP
enabled IGD router. There are three possible value for this
variable: a full URL, the interface name the router is reachable
via, or the value "broadcast" to search for the IGD on all
appropriate interfaces. SOCKS_AUTOADD_LANROUTES If this vari‐
able is set to "no", the client will not try to auto-add direct
routes for all addresses on the lan. The default is to add
them.
SOCKS_DISABLE_THREADLOCK
If this variable is set, the client will not perform threadlock‐
ing. The default is for the client to attempt to figure out for
itself whether the application to socksify needs threadlocking
or not.
FILES
/etc/opt/csw/socks.conf
AUTHORS
For inferno Nettverk A/S:
Michael Shuldman
Karl-Andre' Skevik
SEE ALSOsocks.conf(5)sockd(8)sockd.conf(5) Information about new releases and
other related issues can be found on the Dante WWW home page:
http://www.inet.no/dante/
BUGS
See the accompanying BUGS file. New ones should be reported to
dante-bugs@inet.no.
August, 2009 SOCKSIFY(1)