Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
SOCKSIFY(1)		     General Commands Manual		     SOCKSIFY(1)

NAME
     socksify - runtime socksification of selected programs

DESCRIPTION
     The  shell script socksify is meant to aid in using socks with already com-
     piled 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 it's arguments with the the socksify script, like in the  exam-
     ple 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  vari-
	    ables  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 inter-
	    faces.

     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 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=socksify&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help