← Back to branch summary

~ubuntu-branches/ubuntu/warty/kdebase/warty

« back to all changes in this revision

Viewing changes to doc/kcontrol/proxy/index.docbook

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2004-09-16 04:51:45 UTC
  • Revision ID: james.westby@ubuntu.com-20040916045145-9vr63kith3k1cpza
Tags: upstream-3.2.2
Import upstream version 3.2.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/kcontrol/proxy/index.docbook
 
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
]>
 
8
 
 
9
<article lang="&language;">
 
10
<articleinfo>
 
11
 
 
12
 
 
13
<authorgroup>
 
14
<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
 
15
<!-- TRANS:ROLES_OF_TRANSLATORS -->
 
16
</authorgroup>
 
17
 
 
18
<date>2002-02-11</date>
 
19
<releaseinfo>3.00.00</releaseinfo>
 
20
 
 
21
<keywordset>
 
22
<keyword>KDE</keyword>
 
23
<keyword>KControl</keyword>
 
24
<keyword>proxy</keyword>
 
25
<keyword>proxies</keyword>
 
26
</keywordset>
 
27
 
 
28
</articleinfo>
 
29
<sect1 id="proxies">
 
30
<title>Proxies</title>
 
31
 
 
32
<sect2 id="proxies-intro">
 
33
 
 
34
<title>Introduction</title>
 
35
 
 
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>
 
41
 
 
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>
 
48
 
 
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>
 
55
 
 
56
</sect2>
 
57
 
 
58
<sect2 id="proxies-use">
 
59
 
 
60
<title>Use</title>
 
61
 
 
62
<para>The first option on the page is a checkbox labeled <guilabel>Use
 
63
proxy</guilabel>.</para>
 
64
 
 
65
<para>Check this box to enable the use of proxy servers for your
 
66
internet connection.</para>
 
67
 
 
68
<para>Please note that using proxy servers is optional, but has the
 
69
benefit or advantage of giving you faster access to data on the
 
70
internet.</para>
 
71
 
 
72
<para>If you are uncertain whether or not you need to use a proxy
 
73
server to connect to the internet, please consult with your internet
 
74
service provider's setup guide or your system administrator.</para>
 
75
 
 
76
<para>If you have selected to use a proxy, you have several methods to
 
77
configure the settings for it.</para>
 
78
 
 
79
<variablelist>
 
80
<varlistentry>
 
81
<term><guilabel>Automatically detected script file</guilabel></term>
 
82
<listitem>
 
83
 
 
84
<para>Select this option if you want the proxy setup configuration
 
85
script file to be automatically detected and downloaded.</para>
 
86
<para>This option only differs from the next choice in that it
 
87
<emphasis>does not</emphasis> require you to supply the location of
 
88
the configuration script file. Instead, it will be automatically
 
89
downloaded using <quote>Web Access Protocol Discovery</quote>
 
90
(<acronym>WAPD</acronym>).</para>
 
91
 
 
92
<note><para>If you have a problem using this setup, please consult the
 
93
<acronym>FAQ</acronym> section at <ulink
 
94
url="http://www.konqueror.org">http://www.konqueror.org</ulink> for
 
95
more information.</para></note>
 
96
</listitem>
 
97
</varlistentry>
 
98
 
 
99
<varlistentry>
 
100
<term><guilabel>Specified script file</guilabel></term>
 
101
<listitem>
 
102
<para>Select this option if your proxy support is provided through a
 
103
script file located at a specific address.  You can then enter the
 
104
address in the location text box, or use the <guiicon>folder</guiicon>
 
105
icon to browse to it.</para>
 
106
</listitem>
 
107
</varlistentry>
 
108
 
 
109
<varlistentry>
 
110
<term><guilabel>Preset environment variables</guilabel></term>
 
111
<listitem>
 
112
<para>Some systems are setup with $<envar>HTTP_PROXY</envar> to allow
 
113
graphical as well as non-graphical applications to share the same
 
114
proxy configuration information.</para>
 
115
<para>If you know this applies to you, select this option and click on
 
116
the <guibutton>Setup...</guibutton> button to provide the environment
 
117
variable names used to set the address of the proxy server(s).</para>
 
118
</listitem>
 
119
</varlistentry>
 
120
 
 
121
<varlistentry>
 
122
<term><guilabel>Manually specified settings</guilabel></term>
 
123
<listitem>
 
124
<para>Select this option, and click on the
 
125
<guibutton>Setup...</guibutton> to manually setup the location of the
 
126
proxy servers to be used.</para>
 
127
 
 
128
<para>If you choose this option, another dialog will pop up.</para>
 
129
 
 
130
<para>The complete addressing information for the proxy includes both
 
131
the internet address and a port number. You should enter these into
 
132
the relevant text boxes. The <guiicon>arrow</guiicon> button copies
 
133
the information from the <guilabel>HTTP</guilabel> line to the
 
134
<guilabel>FTP</guilabel> line, in order to help save some
 
135
typing.</para>
 
136
 
 
137
<para>If there are hosts which you can connect to without going
 
138
through the proxy server, you can press <guibutton>Add</guibutton> to
 
139
add the names of these hosts, separated by in the text box labeled
 
140
<guilabel>No Proxy For:</guilabel>. For example, hosts that are on
 
141
your local network can probably be contacted directly.</para>
 
142
 
 
143
<para>You can also choose <guilabel>Only use proxy for entries in this
 
144
list</guilabel>.</para>
 
145
 
 
146
<para>Check this box to reverse the use of the exception list, &ie;
 
147
the proxy servers will only be used when the requested &URL; matches
 
148
one of the addresses listed here.</para>
 
149
 
 
150
<para>This features is useful if all you need is a proxy to access a
 
151
few specific sites, for example, an internal intranet.  If you have
 
152
more complex requirements you might want to use a configuration
 
153
script.</para>
 
154
</listitem>
 
155
</varlistentry>
 
156
</variablelist>
 
157
 
 
158
</sect2>
 
159
 
 
160
<sect2 id="authorization">
 
161
<title><guilabel>Authorization</guilabel></title>
 
162
 
 
163
<para>Here you can choose between two types of authentication, if your
 
164
proxy requires it.  You can have <guilabel>Prompt as
 
165
needed</guilabel>, the default, in which case &konqueror; will only
 
166
ask for a username or password if it needs to.</para>
 
167
 
 
168
<para>The other option is <guilabel>Use automatic login</guilabel>.
 
169
Select this option if you have already set up a login entry for your
 
170
proxy server in the
 
171
<filename>$<envar>KDEDIR</envar>/share/config/kionetrc</filename>
 
172
file.</para>
 
173
 
 
174
</sect2>
 
175
 
 
176
&socks-kcontrol;
 
177
 
 
178
</sect1>
 
179
 
 
180
</article>
 
 
b'\\ No newline at end of file'