Dante Manual Page: SOCKSIFY(1)

SOCKSIFY(1)					      SOCKSIFY(1)

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 pre-
       fixing 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/socks.conf, unless it was changed when compil-
	      ing 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 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  recom-
	      mended  as  other users on the system might be able
	      to see your password.

			   August, 2009				1

SOCKSIFY(1)					      SOCKSIFY(1)

       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  :.	  If  the
	      SOCKS_SERVER  value is set, it indicates the speci-
	      fied server supports all socks  versions	supported
	      by  Dante.  If if either of the other two variables
	      are used, they indicate the given socks server sup-
	      ports  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 specify a HTTP proxy  is  :.

       UPNP_IGD
	      This  variable  can be used to specify the location
	      of a UPNP enabled IGD router.  There are three pos-
	      sible  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  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 per-
	      form threadlocking.  The default is for the  client
	      to  attempt  to  figure  out for itself whether the
	      application to socksify needs threadlocking or not.

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.

			   August, 2009				2