add more spacing
[personal-kdebase.git] / runtime / doc / kcontrol / proxy / index.docbook
blob0a47cec36ebbe5bd93dda82703a1da6d6bade24a
1 <?xml version="1.0" ?>
2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
3 "dtd/kdex.dtd" [
4 <!ENTITY socks-kcontrol SYSTEM "socks.docbook">
5 <!ENTITY % addindex "IGNORE">
6 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
7 ]>
9 <article lang="&language;">
10 <articleinfo>
13 <authorgroup>
14 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
15 <!-- TRANS:ROLES_OF_TRANSLATORS -->
16 </authorgroup>
18 <date>2002-02-11</date>
19 <releaseinfo>3.00.00</releaseinfo>
21 <keywordset>
22 <keyword>KDE</keyword>
23 <keyword>KControl</keyword>
24 <keyword>proxy</keyword>
25 <keyword>proxies</keyword>
26 </keywordset>
28 </articleinfo>
29 <sect1 id="proxies">
30 <title>Proxies</title>
32 <sect2 id="proxies-intro">
34 <title>Introduction</title>
36 <para>Proxies are programs running on a computer that acts a server on
37 the network you are connected to (whether by modem or other
38 means). These programs receive &HTTP; and &FTP; requests, retrieve the
39 relevant files from the internet, and pass them on to the client
40 computer that made the requests.</para>
42 <para>When you have configured a proxy, &HTTP; and/or &FTP; requests
43 are re-routed through the computer that is acting as a proxy server.
44 However, you can also select specific hosts which should be contacted
45 directly, rather than through the proxy server. If you are on a local
46 network, for example, access to local hosts probably doesn't need to
47 go through a proxy server.</para>
49 <para>You should only need to configure a proxy server if your network
50 administrator requires it (if you are a dial-up user, that would be
51 your internet service provider or <acronym>ISP</acronym>). Otherwise,
52 especially if you are feeling a bit confused about this proxy
53 business, but everything seems to be fine with your internet
54 connection, you don't need to change anything.</para>
56 <para>Please note that using proxy servers is optional, but has the
57 benefit or advantage of giving you faster access to data on the
58 internet.</para>
60 <para>If you are uncertain whether or not you need to use a proxy
61 server to connect to the internet, please consult with your internet
62 service provider's setup guide or your system administrator.</para>
64 </sect2>
66 <sect2 id="proxies-use">
68 <title>Use</title>
70 <variablelist>
71 <varlistentry>
72 <term><guilabel>Connect to the Internet directly</guilabel></term>
73 <listitem>
75 <para>Select this option if you do <emphasis>not</emphasis> want to use a proxy server.</para>
76 </listitem>
77 </varlistentry>
78 </variablelist>
80 <para>If you have decided to use a proxy, you have several methods to
81 configure the settings for it.</para>
83 <variablelist>
84 <varlistentry>
85 <term><guilabel>Automatically detected script file</guilabel></term>
86 <listitem>
88 <para>Select this option if you want the proxy setup configuration
89 script file to be automatically detected and downloaded.</para>
90 <para>This option only differs from the next choice in that it
91 <emphasis>does not</emphasis> require you to supply the location of
92 the configuration script file. Instead, it will be automatically
93 downloaded using <quote>Web Access Protocol Discovery</quote>
94 (<acronym>WAPD</acronym>).</para>
96 <note><para>If you have a problem using this setup, please consult the
97 <acronym>FAQ</acronym> section at <ulink
98 url="http://www.konqueror.org">http://www.konqueror.org</ulink> for
99 more information.</para></note>
100 </listitem>
101 </varlistentry>
103 <varlistentry>
104 <term><guilabel>Specified script file</guilabel></term>
105 <listitem>
106 <para>Select this option if your proxy support is provided through a
107 script file located at a specific address. You can then enter the
108 address in the location text box, or use the <guiicon>folder</guiicon>
109 icon to browse to it.</para>
110 </listitem>
111 </varlistentry>
113 <varlistentry>
114 <term><guilabel>Preset environment variables</guilabel></term>
115 <listitem>
116 <para>Some systems are setup with $<envar>HTTP_PROXY</envar> to allow
117 graphical as well as non-graphical applications to share the same
118 proxy configuration information.</para>
119 <para>If you know this applies to you, select this option and click on
120 the <guibutton>Setup...</guibutton> button to provide the environment
121 variable names used to set the address of the proxy server(s).</para>
122 </listitem>
123 </varlistentry>
125 <varlistentry>
126 <term><guilabel>Manually specified settings</guilabel></term>
127 <listitem>
128 <para>Select this option, and click on the
129 <guibutton>Setup...</guibutton> to manually setup the location of the
130 proxy servers to be used.</para>
132 <para>If you choose this option, another dialog will pop up.</para>
134 <para>The complete addressing information for the proxy includes both
135 the internet address and a port number. You should enter these into
136 the relevant text boxes. The <guiicon>arrow</guiicon> button copies
137 the information from the <guilabel>HTTP</guilabel> line to the
138 <guilabel>FTP</guilabel> line, in order to help save some
139 typing.</para>
141 <para>If there are hosts which you can connect to without going
142 through the proxy server, you can press <guibutton>Add</guibutton> to
143 add the names of these hosts, separated by in the text box labeled
144 <guilabel>No Proxy For:</guilabel>. For example, hosts that are on
145 your local network can probably be contacted directly.</para>
147 <para>You can also choose <guilabel>Only use proxy for entries in this
148 list</guilabel>.</para>
150 <para>Check this box to reverse the use of the exception list, &ie;
151 the proxy servers will only be used when the requested &URL; matches
152 one of the addresses listed here.</para>
154 <para>This features is useful if all you need is a proxy to access a
155 few specific sites, for example, an internal intranet. If you have
156 more complex requirements you might want to use a configuration
157 script.</para>
158 </listitem>
159 </varlistentry>
160 </variablelist>
162 </sect2>
164 <sect2 id="authorization">
165 <title><guilabel>Authorization</guilabel></title>
167 <para>Here you can choose between two types of authentication, if your
168 proxy requires it. You can have <guilabel>Prompt as
169 needed</guilabel>, the default, in which case &konqueror; will only
170 ask for a username or password if it needs to.</para>
172 <para>The other option is <guilabel>Use automatic login</guilabel>.
173 Select this option if you have already set up a login entry for your
174 proxy server in the
175 <filename>$<envar>KDEDIR</envar>/share/config/kionetrc</filename>
176 file.</para>
178 </sect2>
180 <sect2 id="options">
181 <title><guilabel>Options</guilabel></title>
182 <variablelist>
183 <varlistentry>
184 <term><guilabel>Use persistent connections to proxy</guilabel></term>
185 <listitem>
186 <para>Use persistent connection to your proxy server. Keeps connection to proxy open, helps lower bandwidth/speed up connection. Enabling this option will require the proxy server's cooperation, if the proxy server does not support this, it will bring your internet to a stop. </para>
187 </listitem>
188 </varlistentry>
189 </variablelist>
191 </sect2>
193 &socks-kcontrol;
195 </sect1>
197 </article>