.\" $Id: socks.conf.5,v 1.14 1999/07/10 13:52:23 karls Exp $.\".\" Copyright (c) 1997, 1998, 1999.\"      Inferno Nettverk A/S, Norway.  All rights reserved..\".\" Redistribution and use in source and binary forms, with or without.\" modification, are permitted provided that the following conditions.\" are met:.\" 1. The above copyright notice, this list of conditions and the following.\"    disclaimer must appear in all copies of the software, derivative works.\"    or modified versions, and any portions thereof, aswell as in all.\"    supporting documentation..\" 2. All advertising materials mentioning features or use of this software.\"    must display the following acknowledgement:.\"      This product includes software developed by.\"      Inferno Nettverk A/S, Norway..\" 3. The name of the author may not be used to endorse or promote products.\"    derived from this software without specific prior written permission..\".\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED..\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE..\".\" Inferno Nettverk A/S requests users of this software to return to.\".\"  Software Distribution Coordinator  or  sdc@inet.no.\"  Inferno Nettverk A/S.\"  Oslo Research Park.\"  Gaustadal閑n 21.\"  N-0349 Oslo.\"  Norway.\".\" any improvements or extensions that they make and grant Inferno Nettverk A/S.\" the rights to redistribute these changes..\".TH SOCKS.CONF 5 "December 7, 1998".SH NAMEsocks.conf \- socks client configuration file syntax.SH DESCRIPTIONThe configuration file for the socks client library allow control overlogging and server selection.  It is divided into two parts,miscellaneous settings and routes.  A line can be commented using thestandard comment character \fB#\fP..SH FORMATThe miscellaneous settings have a keyword followed by a colon and thevalue..TP\fBlogouput\fPThis value controls where the sends logoutput.  It canbe either \fBsyslog\fP, \fBstdout\fP, \fBstderr\fP, a filename, ora combination..TP\fBdebug\fPSetting this field to 1 turns on debugging..TP.SH ROUTESThe routes are specified with a \fBroute\fP keyword.  Inside a pair ofparens ({}) a set of keywords control the behavior of the route.  Aroute is selected for a connection based on the values within the\fBroute\fP block.  The \fBroute\fP block can contain the following:.TP.SH ADDRESSESEach address specification consists of a ipaddress/netmask or a hostnameand a optional \fBport\fP specifier.  Each \fBroute\fP can containthree address specifications; \fBfrom\fP, \fBto\fP and \fBvia\fP..IP \fBfrom\fPThe route is used only by requests coming from the address given as value..IP \fBto\fPThe route is used only by requests going to the address given as value..IP \fBvia\fPAddress of socks server to be used for the connection..IP \fBport\fPParameter to \fBfrom\fP, \fBto\fP and \fBvia\fP.  Accepts the keywords\fBeq/=, neq/!=, ge/>=, le/<=, gt/>, lt/<\fP followed by a number.A portrange can also be given as "port <start #> - <end #>", whichwill match all port numbers within the range <start #> and <end #>..IP \fBprotocol\fPThe protocols the server supports.Currently supported values are \fBtcp\fP and \fBudp\fP..IP \fBresolveprotocol\fPThe protocol used to resolve hostnames.Valid values are \fBudp\fP (default), \fBtcp\fP and \fBfake\fP..IP \fBproxyprotocol\fPThe proxy protocols the server supports.Currently supported values are \fBsocks_v4\fP, \fBsocks_v5\fPand \fBmsproxy_v2\fP..IP \fBmethod\fPList of authentication methods the \fBclient\fP supports and which tooffer the server.  Currently supported values are \fBnone\fP and\fBusername\fP..SH EXAMPLESSee the example directory in the distribution..SH FILES.I /etc/socks.conf.SH AUTHORSFor Inferno Nettverk A/S, Norway: Michael Shuldman <michaels@inet.no>: Design and implementation. Karl-Andre' Skevik <karls@inet.no>: Autoconf and porting..SH SEE ALSOsockd(8)