Provided by: dante-client_1.4.2+dfsg-2build1_all bug

NAME

       socksify - 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 environment  variable  to  libdsocks.   It
       will then attempt to wrap all networking-related system calls.

       When  used the script can socksify a program by simply prefixing the given program and its
       arguments with 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/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 logging.  The value given should be a number, one or  up,  indicating
              the level of debugging provided.

       SOCKS_LOGOUTPUT
              This  value  controls  where  the client library sends logoutput.  It can be either
              syslog, stdout, stderr, a filename, or a combination.  The default is nowhere.

       SOCKS_USERNAME
              Use the value of SOCKS_USERNAME as the username when doing username authentication.

       SOCKS_PASSWORD
              Use the value of SOCKS_PASSWORD as the password when doing username authentication.
              Not recommended as other users on the system 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 using a
              socks.conf file.  If a socks.conf-file is present, it is ignored if  any  of  these
              variables are set.

              The  accepted  format  is <ipaddress>:<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.  Note that  if  the  socks
              server  requires  any  form of authentication, you need to use SOCKS5_SERVER, as v4
              does not support authentication.

       HTTP_CONNECT_PROXY
              This variable can be used to specify the location of a HTTP  proxy  supporting  the
              connect    request.     The    format   used   to   specify   a   HTTP   proxy   is
              http://<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.

       Note that if any of the above environment variables, indicating the
              proxy server to use are set, the Dante client will not parse the socks.conf file.

       SOCKS_AUTOADD_LANROUTES
              If  this variable 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 threadlocking.  The default is
              for  the  client  to  attempt  to  figure out for itself whether the application to
              socksify needs threadlocking or not.

       SOCKS_DIRECTROUTE_FALLBACK
              If this is set to "yes", the client will fallback to attempting a direct connection
              if the proxy route fails.  The default is "no".

FILES

       /etc/socks.conf

AUTHORS

       For inferno Nettverk A/S:
          Michael Shuldman
          Karl-Andre' Skevik

SEE ALSO

       socks.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.

                                           July 6 2013                                SOCKSIFY(1)