<!entity history SYSTEM "history.sgml">
<!entity copyright SYSTEM "copyright.sgml">
<!entity license SYSTEM "license.sgml">
-<!entity p-version "2.9.15">
-<!entity p-status "beta">
-<!entity % p-not-stable "INCLUDE">
+<!entity p-version SYSTEM "doc_version.tmp">
+<!entity p-status SYSTEM "doc_status.tmp">
+<!entity % p-not-stable "IGNORE">
<!entity % p-stable "IGNORE">
<!entity % p-text "IGNORE"> <!-- define we are not a text only doc -->
<!entity % p-doc "INCLUDE"> <!-- and we are a formal doc -->
This file belongs into
ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
- $Id: faq.sgml,v 1.59 2002/05/15 04:03:30 hal9 Exp $
+ $Id: faq.sgml,v 1.65 2002/07/25 21:51:24 hal9 Exp $
Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
See LICENSE.
========================================================================
NOTE: Please read developer-manual/documentation.html before touching
- anything in this, or other Privoxy documentation. You have been warned!
- Failure to abide by this rule will result in the revocation of your license
- to live a peaceful existence!
+ anything in this, or other Privoxy documentation.
========================================================================
</subscript>
</pubdate>
-<pubdate>$Id: faq.sgml,v 1.59 2002/05/15 04:03:30 hal9 Exp $</pubdate>
+<pubdate>$Id: faq.sgml,v 1.65 2002/07/25 21:51:24 hal9 Exp $</pubdate>
<!--
This FAQ gives quick answers to frequently asked questions about
<ulink url="http://www.privoxy.org/">Privoxy</ulink>
<![%p-stable;[ v.&p-version]]>. It can't and doesn't replace the
- <ulink url="../user-manual/index.html">user manual</ulink>.
+ <ulink url="../user-manual/index.html"><citetitle>User Manual</citetitle></ulink>.
</para>
<!-- Include privoxy.sgml boilerplate: -->
<para>
You can find the latest version of the document at <ulink
url="http://www.privoxy.org/faq/">http://www.privoxy.org/faq/</ulink>.
- Please see the Contact section if you want to contact the developers.
+ Please see the <link linkend="contact">Contact section</link> if you want to
+ contact the developers.
</para>
<!-- <para> -->
This does not sound very scientific.</title>
<para>
Actually, it's a black art ;-) And yes, it is always possible to have a broad
- rule accidentally block of change something by mistake. There is a good chance
+ rule accidentally block or change something by mistake. There is a good chance
you may run into such a situation at some point. It is tricky writing rules to
cover every conceivable possibility, and not occasionally get false positives.
</para>
<para>
If you set up the <application>Privoxy</application> to run on
the computer you browse from (rather than your ISP's server or some
- networked computer on a LAN), the proxy will be on <quote>localhost</quote>
- (which is the special name used by every computer on the Internet to refer
+ networked computer on a LAN), the proxy will be on <literal>127.0.0.1</literal>
+ (sometimes referred to as <quote>localhost</quote>,
+ which is the special name used by every computer on the Internet to refer
to itself) and the port will be 8118 (unless you have <application>Privoxy</application>
to run on a different port with the <ulink
url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink> config option).
the browser's caches to force a full re-reading of pages. You can verify
that <application>Privoxy</application> is running, and your browser
is correctly configured by entering the special URL:
- <ulink url="http:/config.privoxy.org/">http://config.privoxy.org/</ulink>.
+ <ulink url="http://config.privoxy.org/">http://config.privoxy.org/</ulink>.
This should take you to a page titled <quote>This is Privoxy..</quote> with
access to <application>Privoxy's</application> internal configuration.
If you see this, then you are good to go. If you receive a page saying
</sect2>
<sect2 renderas="sect3" id="configfiles"> <title>What's the difference between the
-<quote>Cautious</quote>, <quote>Medium</quote> and <quote>Advenced</quote> defaults?</title>
+<quote>Cautious</quote>, <quote>Medium</quote> and <quote>Advanced</quote> defaults?</title>
<para>
Configuring <application>Privoxy</application> is not entirely trivial. To help you get
started, we provide you with three different default action <quote>packages</quote> in
<para>
The <ulink url="../user-manual/filter-file.html"><filename>default.filter</filename></ulink>
file is where <emphasis>filters</emphasis> are defined, which can be used to modify or
- remove, web page content on the fly. This applies to <emphasis>anything</emphasis>
+ remove, web page content on the fly. Filters apply to <emphasis>anything</emphasis>
in the page source, including HTML tags, and JavaScript. Regular expressions are used
to accomplish this. There are a number of pre-defined filters to deal with common
annoyances. The filters are only defined here, to invoke them, you need to use the
- <ulink url="../user-manual/actions-file.html#FILTER"><literal>filter</literal> action</ulink>.
+ <ulink
+ url="../user-manual/actions-file.html#FILTER"><literal>filter</literal>
+ action</ulink> in one of the actions files. Filtering is automatically
+ disabled for inappropriate MIME types.
</para>
<para>
If you are familiar with regular expressions, and HTML, you can look at
the provided <filename>default.filter</filename> with a text editor and define
your own filters. This is potentially a very powerful feature, but
- requires some expertise.
+ requires some expertise in both regular expressions and HTML/HTTP.
</para>
+
<para>
Presently, there is no GUI editor option for this part of the configuration,
but you can disable/enable the various pre-defined filters of the included
LAN?</title>
<para>
By default, <application>Privoxy</application> only responds to requests
- from localhost. To have it act as a server for a network, this needs to be
- changed in the<ulink url="../user-manual/config.html">main configuration
- file</ulink>. Look for the <literal><ulink
- url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink></literal>
- option, which may be commented out with a <quote>#</quote> symbol. Make sure
- it is uncommented, and assign it the address of the LAN gateway interface,
- and port number to use. Assuming your LAN address is 192.168.1.1 and you wish
- to run <application>Privoxy</application> on port 8118, this line schould look
- like:
+ from <literal>127.0.0.1</literal> (localhost). To have it act as a server for
+ a network, this needs to be changed in the <ulink
+ url="../user-manual/config.html">main configuration file</ulink>. Look for
+ the <literal><ulink
+ url="../user-manual/config.html#LISTEN-ADDRESS">listen-address</ulink></literal>
+ option, which may be commented out with a <quote>#</quote> symbol. Make sure
+ it is uncommented, and assign it the address of the LAN gateway interface,
+ and port number to use. Assuming your LAN address is 192.168.1.1 and you
+ wish to run <application>Privoxy</application> on port 8118, this line
+ schould look like:
</para>
<para>
content, giving the user a feeling of "it works". This effect is especially
noticeable on slow dialup connections.
</para>
+<para>
+ Filtering is automatically disabled for inappropriate MIME types.
+</para>
</sect2>
</sect2>
+
<sect2 renderas="sect3" id="turnoff">
<title>How can I temporarily disable <application>Privoxy</application>?</title>
<para>
The easiest way is to access <application>Privoxy</application> with your
browser by using the remote toggle URL: <ulink
url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>.
+ See the <ulink url="../user-manual/appendix.html#BOOKMARKLETS">Bookmarklets section</ulink>
+ of the <citetitle>User Manual</citetitle> for an easy way to access this
+ feature.
+</para>
+</sect2>
+
+<sect2 renderas="sect3" id="reallyoff">
+<title>When <quote>disabled</quote> is <application>Privoxy</application> totally
+out of the picture?</title>
+<para>
+ No, this just means all filtering and actions are disabled.
+ <application>Privoxy</application> is still acting as a proxy, but just not
+ doing any of the things that <application>Privoxy</application> would
+ normally be expected to do. It is still a <quote>middle-man</quote> in
+ the interaction between your browser and web sites.
</para>
</sect2>
+
<sect2 renderas="sect3" id="seealso">
<title>Where can I find more information about <application>Privoxy</application>
and related issues?</title>
by toggling off <application>Privoxy</application> through <ulink
url="http://config.privoxy.org/toggle">http://config.privoxy.org/toggle</ulink>,
and then shift-reloading the problem page (i.e. holding down the shift key
- while clicking reload. Alternatively, flush your browsers' disk any memory
+ while clicking reload. Alternatively, flush your browser's disk and memory
caches).
</para>
</para>
<para>
Alternately, if you are comfortable with a text editor, you can accomplish
- the same thing by editing the appropriate actions file. The probably easiest
+ the same thing by editing the appropriate actions file. Probably the easiest
way to deal with such problems when editing by hand is to add your
site to a <literal>{ fragile }</literal> section in <filename>user.action</filename>,
which is an alias that turns off most <quote>dangerous</quote>
</sect2>
+
+<!-- ~~~~~ New section ~~~~~ -->
+<sect2 id="dun">
+<title>After installing <application>Privoxy</application>, I have to log in
+every time I start IE. What gives?</title>
+
+<para>
+ This is a quirk that effects the installation of
+ <application>Privoxy</application>, in conjunction with Internet Explorer and
+ Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
+ appear to be corrupted or invalid DUN settings, or passwords.
+</para>
+
+<para>
+ When setting up an NT based Windows system with
+ <application>Privoxy</application> you may find that things do not seem to be
+ doing what you expect. When you set your system up you will probably have set
+ up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
+ logged in with administrator privileges. You will probably have made this DUN
+ connection available to other accounts that you may have set-up on your
+ system. E.g. Mum or Dad sets up the system and makes accounts suitably
+ configured for the kids.
+</para>
+
+<para>
+ When setting up <application>Privoxy</application> in this environment you
+ will have to alter the proxy set-up of Internet Explorer (IE) for the
+ specific DUN connection on which you wish to use
+ <application>Privoxy</application>. When you do this the ICS DUN set-up
+ becomes user specific. In this instance you will see no difference if you
+ change the DUN connection under the account used to set-up the connection.
+ However when you do this from another user you will notice that the DUN
+ connection changes to make available to "Me only". You will also find that
+ you have to store the password under each different user!
+</para>
+
+<para>
+ The reason for this is that each user's set-up for IE is user specific. Each
+ set-up DUN connection and each LAN connection in IE store the settings for
+ each user individually. As such this enforces individual configurations
+ rather than common ones. Hence the first time you use a DUN connection after
+ re-booting your system it may not perform as you expect, and prompt you for
+ the password. Just set and save the password again and all should be OK.
+</para>
+
+<para>
+[Thanks to Ray Griffith for this submission.]
+</para>
+</sect2>
+
+
+<!-- ~~~~~ New section ~~~~~ -->
+<sect2 id="ftp">
+<title>I cannot connect to any FTP sites. <application>Privoxy</application>
+ seems to be blocking me.</title>
+ <para>
+ <application>Privoxy</application> cannot act as a proxy for FTP traffic,
+ so do not configure your browser to use <application>Privoxy</application>
+ as an FTP proxy. The same is true for any protocol other than HTTP or HTTPS.
+ </para>
+</sect2>
+
</sect1>
<!--
</sect1>
Temple Place - Suite 330, Boston, MA 02111-1307, USA.
$Log: faq.sgml,v $
+Revision 1.65 2002/07/25 21:51:24 hal9
+Warnings on non-HTTP traffic.
+
+Revision 1.64 2002/06/09 16:37:31 hal9
+Sync with filtering clarifications in 3.0 branch.
+
+Revision 1.63 2002/06/05 00:31:55 hal9
+Mass commit for new entities, most significantly so docs can read version
+and code status info from tmp files, so perl is no longer used. Also, docs can
+differentiate on alpha -> beta -> stable now.
+
+Revision 1.62 2002/06/03 00:28:16 hal9
+Sync with various changes from 3.0 branch. Add two new files for config stuff.
+
+Revision 1.61 2002/05/25 12:37:25 hal9
+Various minor changes and edits.
+
+Revision 1.60 2002/05/22 17:17:48 oes
+Proofread & added more links into u-m
+
Revision 1.59 2002/05/15 04:03:30 hal9
Fix ulink -> link markup.
projects / privoxy.git / blobdiff