runtime/doc/kcontrol/proxy/socks.docbook

   1 <sect2 id="socks">
   2 <sect2info>
   3 <authorgroup>
   4 <author>&Lauri.Watts;</author>
   5 <!-- TRANS:ROLES_OF_TRANSLATORS -->
   6 </authorgroup>
   7 </sect2info>
   8
   9 <title>SOCKS</title>
  10
  11 <para>SOCKS is a protocol to execute proxy requests for a client.  SOCKS
  12 is capable of authentication and encryption of traffic, and is often
  13 found in corporate settings, as opposed to home users.  For more
  14 information about SOCKS, see the <ulink
  15 url="http://www.socks.nec.com">NEC</ulink> website</para>
  16
  17 <para>With this module you can enable most of the network aware &kde;
  18 applications to transparently use SOCKS.</para>
  19
  20 <para>Setting up of a SOCKS client is outside the scope of this
  21 document, and the differences between the commonly used ones are very
  22 large.  If you already have a working SOCKS implementation, allowing you
  23 to use commandline clients (for example, if <command>lynx</command> or
  24 <command>ftp</command> are already working) then you can simply check
  25 the <guilabel>Enable SOCKS support</guilabel> checkbox.</para>
  26
  27 <para>When this box is checked, several further options become available
  28 to you.</para>
  29
  30 <para>First, you should select which of the various SOCKS clients you
  31 have installed on your computer.  &kde; will attempt to find this out by
  32 itself, if you choose <guilabel>Auto detect</guilabel>.  If you know the
  33 client you have, you could choose either <guilabel>NEC
  34 Socks</guilabel> or <guilabel>Dante</guilabel>.  If you have a
  35 custom built SOCKS library to use, you can select <guilabel>Use custom
  36 library</guilabel> and then enter the path to it in the
  37 <guilabel>Path</guilabel> field.</para>
  38
  39 <para>If you want &kde; to auto detect the SOCKS library in use, but you
  40 suspect it isn't looking in the right places or you have installed it in
  41 a non-standard location, then you can add further paths to be searched in
  42 the bottom of this panel.  Use the <guibutton>Add</guibutton> and
  43 <guibutton>Remove</guibutton> to add or remove paths.</para>
  44
  45 <para>At any time while filling in this module, you can press the
  46 <guibutton>Test</guibutton> button, and &kde; will report immediately
  47 with a message box to tell you if it could find and initialize SOCKS or
  48 not.</para>
  49
  50 <para>Changes made here will not affect any applications that are
  51 already open.  You will need to close and restart them before they are
  52 able to connect via SOCKS.</para>
  53
  54 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
  55
  56 </sect2>