From: Fabian Keil <fk@fabiankeil.de> Date: Sun, 6 Mar 2016 11:32:26 +0000 (+0000) Subject: Add a FAQ entry for tainted sockets X-Git-Tag: v_3_0_25~126 X-Git-Url: http://www.privoxy.org/gitweb/%22https:/user-manual/developer-manual/static/gitweb.js?a=commitdiff_plain;h=7a99a61ab1a3ce0401821aedcd06eba19a698b2a;p=privoxy.git Add a FAQ entry for tainted sockets --- diff --git a/INSTALL b/INSTALL index 55d5a985..a7725a68 100644 --- a/INSTALL +++ b/INSTALL @@ -40,8 +40,8 @@ compiler like gcc are required. When building from a source tarball, first unpack the source: - tar xzvf privoxy-3.0.24-stable-src.tar.gz - cd privoxy-3.0.24-stable + tar xzvf privoxy-3.0.25-beta-src.tar.gz + cd privoxy-3.0.25-beta For retrieving the current CVS sources, you'll need a CVS client installed. Note that sources from CVS are typically development quality, and may not be @@ -97,8 +97,8 @@ configurations, configure like this: ./configure --disable-toggle --disable-editor --disable-force -Then build as above. In Privoxy 3.0.7 and later, all of these options can also -be disabled through the configuration file. +Note that all of these options can also be disabled through the configuration +file. WARNING: If installing as root, the install will fail unless a non-root user or group is specified, or a privoxy user and group already exist on the system. If diff --git a/README b/README index 2fc500bb..39169915 100644 --- a/README +++ b/README @@ -32,8 +32,9 @@ * *********************************************************************/ -This README is included with Privoxy 3.0.24. See http://www.privoxy.org/ for -more information. The current code maturity level is "stable". +This README is included with the development version of Privoxy 3.0.25. See +http://www.privoxy.org/ for more information. The current code maturity level +is "UNRELEASED", but seems stable to us :). ------------------------------------------------------------------------------- @@ -104,16 +105,22 @@ try it with FTP or other protocols for the simple reason it does not work. The actions list can be configured via the web interface accessed via http:// p.p/, as well other options. +All configuration files are subject to unannounced changes during the +development process. + ------------------------------------------------------------------------------- 5. DOCUMENTATION -There should be documentation in the 'doc' subdirectory. In particular, see the -User Manual there, the FAQ, and those interested in Privoxy development, should -look at developer-manual. +There should be documentation in the 'doc' subdirectory, but it may not be +completed at this point. In particular, see the User Manual there, the FAQ, and +those interested in Privoxy development, should look at developer-manual. -The source and configuration files are all well commented. The main -configuration files are: 'config', 'default.action', and 'default.filter'. +The most up to date source of information on the current development version, +may still be either comments in the source code, or the included configuration +files. The source and configuration files are all well commented. The main +configuration files are: 'config', 'default.action', and 'default.filter' in +the top-level source directory. Included documentation may vary according to platform and packager. All documentation is posted on http://www.privoxy.org, in case you don't have it, @@ -135,7 +142,7 @@ A lot of support requests don't contain enough information and can't be solved without a lot of back and forth which causes unnecessary delays. Reading this section should help to prevent that. -Before contacting us to report a problem, please try to verify that it is a +Before contacting us to report a problem, please try to verify that it is a Privoxy problem, and not a browser or site problem or documented behaviour that just happens to be different than what you expected. If unsure, try toggling off Privoxy, and see if the problem persists. @@ -156,7 +163,7 @@ requesting support: * The operating system and versions you run Privoxy on, e.g. Windows XP SP2. - * The name, platform, and version of the browser you were using (e.g. + * The name, platform, and version of the browser you were using (e.g. Internet Explorer v5.5 for Mac). * The URL where the problem occurred, or some way for us to duplicate the diff --git a/doc/source/faq.sgml b/doc/source/faq.sgml index 38163038..127d9ce9 100644 --- a/doc/source/faq.sgml +++ b/doc/source/faq.sgml @@ -27,7 +27,7 @@ This file belongs into ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/ - $Id: faq.sgml,v 2.116 2016/02/26 12:33:18 fabiankeil Exp $ + $Id: faq.sgml,v 2.117 2016/03/04 13:21:33 fabiankeil Exp $ Copyright (C) 2001-2014 Privoxy Developers http://www.privoxy.org/ See LICENSE. @@ -78,7 +78,7 @@ </subscript> </pubdate> -<pubdate>$Id: faq.sgml,v 2.116 2016/02/26 12:33:18 fabiankeil Exp $</pubdate> +<pubdate>$Id: faq.sgml,v 2.117 2016/03/04 13:21:33 fabiankeil Exp $</pubdate> <!-- @@ -2952,6 +2952,42 @@ browsing has slowed to a crawl. What gives? </title> </para> </sect2> +<sect2 renderas="sect3" id="tainted-sockets"> +<title>What are tainted sockets and how do I prevent them?</title> +<para> + &my-app; marks sockets as tainted when it can't use them to + serve additional requests. + This does not necessarily mean that something went wrong and + information about tainted sockets is only logged if connection + debugging is enabled (debug 2). +</para> +<para> + For example server sockets that were used for CONNECT requests + (which are used to tunnel https:// requests) are considered tainted + once the client closed its connection to &my-app;. + Technically &my-app; could keep the connection to the server open, + but the server would not accept requests that do not belong to the + previous TLS/SSL session (and the client may even have terminated + the session). +</para> +<para> + Server sockets are also marked tainted when a client requests a + resource, but closes the connection before &my-app; has completely + received (and forwarded) the resource to the client. + In this case the server would (probably) accept additional requests, + but &my-app; could not get the response without completely reading + the leftovers from the previous response. +</para> +<para> + These are just two examples, there are currently a bit more than + 25 scenarios in which a socket is considered tainted. +</para> +<para> + While sockets can also be marked tainted as a result of a technical + problem that may be worth fixing, the problem will be explicitly + logged as error. +</para> +</sect2> </sect1> diff --git a/doc/webserver/developer-manual/documentation.html b/doc/webserver/developer-manual/documentation.html index 4c9dbc15..6a61ed53 100644 --- a/doc/webserver/developer-manual/documentation.html +++ b/doc/webserver/developer-manual/documentation.html @@ -384,7 +384,7 @@ <td><span class="emphasis"><i class= "EMPHASIS">p-version</i></span>: the <span class= "APPLICATION">Privoxy</span> version string, e.g. - <span class="QUOTE">"3.0.24"</span>.</td> + <span class="QUOTE">"3.0.25"</span>.</td> </tr> <tr> diff --git a/doc/webserver/developer-manual/index.html b/doc/webserver/developer-manual/index.html index 729a9596..4471267b 100644 --- a/doc/webserver/developer-manual/index.html +++ b/doc/webserver/developer-manual/index.html @@ -24,8 +24,8 @@ "http://www.privoxy.org/" target="_top">Privoxy Developers</a></sub><br></p> - <p class="PUBDATE">$Id: developer-manual.sgml,v 2.65 2016/01/23 - 11:58:58 fabiankeil Exp $<br></p> + <p class="PUBDATE">$Id: developer-manual.sgml,v 2.67 2016/02/26 + 12:27:32 fabiankeil Exp $<br></p> <div> <div class="ABSTRACT"> @@ -39,7 +39,7 @@ entirely correct. As always, patches are welcome.</p> <p>Please note that this document is constantly evolving. This copy - represents the state at the release of version 3.0.24. You can find + represents the state at the release of version 3.0.25. You can find the latest version of the this manual at <a href= "http://www.privoxy.org/developer-manual/" target= "_top">http://www.privoxy.org/developer-manual/</a>. Please have a @@ -255,9 +255,6 @@ <dl> <dt>5.1. <a href="testing.html#TESTING-PLAN">Testplan for releases</a></dt> - - <dt>5.2. <a href="testing.html#TESTING-REPORT">Test - reports</a></dt> </dl> </dd> diff --git a/doc/webserver/developer-manual/newrelease.html b/doc/webserver/developer-manual/newrelease.html index 8948c82a..91944096 100644 --- a/doc/webserver/developer-manual/newrelease.html +++ b/doc/webserver/developer-manual/newrelease.html @@ -739,7 +739,7 @@ <tr> <td> <pre class="PROGRAMLISTING"> - debchange -v 3.0.24-stable-1 "New upstream version" + debchange -v 3.0.25-UNRELEASED-1 "New upstream version" </pre> </td> </tr> @@ -758,7 +758,7 @@ </table> <p>This will create <tt class= - "FILENAME">../privoxy_3.0.24-stable-1_i386.deb</tt> which can be + "FILENAME">../privoxy_3.0.25-UNRELEASED-1_i386.deb</tt> which can be uploaded. To upload the package to Sourceforge, simply issue</p> <table border="0" bgcolor="#E0E0E0" width="100%"> @@ -953,7 +953,7 @@ column, and click <tt class="LITERAL">Add Release</tt>. You will then need to create a new release for your package, using the format of <tt class="LITERAL">$VERSION ($CODE_STATUS)</tt>, e.g. <span class= - "emphasis"><i class="EMPHASIS">3.0.24 (beta)</i></span>.</p> + "emphasis"><i class="EMPHASIS">3.0.25 (beta)</i></span>.</p> <p>Now just follow the prompts. Be sure to add any appropriate Release notes. You should see your freshly uploaded packages in <span class= diff --git a/doc/webserver/developer-manual/testing.html b/doc/webserver/developer-manual/testing.html index 7433caa0..ed44d80c 100644 --- a/doc/webserver/developer-manual/testing.html +++ b/doc/webserver/developer-manual/testing.html @@ -99,32 +99,6 @@ </li> </ol> </div> - - <div class="SECT2"> - <h2 class="SECT2"><a name="TESTING-REPORT" id="TESTING-REPORT">5.2. - Test reports</a></h2> - - <p>Please submit test reports only with the <a href= - "http://sourceforge.net/tracker/?func=add&group_id=11118&atid=395005" - target="_top">test form</a> at sourceforge. Three simple steps:</p> - - <ul> - <li> - <p>Select category: the distribution you test on.</p> - </li> - - <li> - <p>Select group: the version of <span class= - "APPLICATION">Privoxy</span> that we are about to release.</p> - </li> - - <li> - <p>Fill the Summary and Detailed Description with something - intelligent (keep it short and precise).</p> - </li> - </ul>Do not mail to the mailing list (we cannot keep track on issues - there). - </div> </div> <div class="NAVFOOTER"> diff --git a/doc/webserver/faq/configuration.html b/doc/webserver/faq/configuration.html index 8bc56e66..e99339d1 100644 --- a/doc/webserver/faq/configuration.html +++ b/doc/webserver/faq/configuration.html @@ -42,8 +42,8 @@ Configuration</a></h1> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN360" id="AEN360">3.1. What exactly is an - <span class="QUOTE">"actions"</span> file?</a></h3> + <h3 class="SECT2"><a name="ACTIONSFILE" id="ACTIONSFILE">3.1. What + exactly is an <span class="QUOTE">"actions"</span> file?</a></h3> <p><span class="APPLICATION">Privoxy</span> utilizes the concept of <span class="QUOTE">" <a href= @@ -88,8 +88,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN383" id="AEN383">3.3. How are actions - files configured? What is the easiest way to do this?</a></h3> + <h3 class="SECT2"><a name="ACTCONFIG" id="ACTCONFIG">3.3. How are + actions files configured? What is the easiest way to do this?</a></h3> <p>Actions files are just text files in a special syntax and can be edited with a text editor. But probably the easiest way is to access @@ -106,7 +106,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN392" id="AEN392">3.4. There are several + <h3 class="SECT2"><a name="AEN393" id="AEN393">3.4. There are several different <span class="QUOTE">"actions"</span> files. What are the differences?</a></h3> @@ -299,9 +299,9 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN482" id="AEN482">3.11. What is the - <tt class="FILENAME">default.filter</tt> file? What is a <span class= - "QUOTE">"filter"</span>?</a></h3> + <h3 class="SECT2"><a name="FILTERFILE" id="FILTERFILE">3.11. What is + the <tt class="FILENAME">default.filter</tt> file? What is a + <span class="QUOTE">"filter"</span>?</a></h3> <p>The <a href="../user-manual/filter-file.html" target= "_top"><tt class="FILENAME">default.filter</tt></a> file is where @@ -410,7 +410,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN533" id="AEN533">3.13. Instead of ads, + <h3 class="SECT2"><a name="NOSEEUM" id="NOSEEUM">3.13. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</a></h3> @@ -437,8 +437,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN550" id="AEN550">3.14. Why would anybody - want to see a checkerboard pattern?</a></h3> + <h3 class="SECT2"><a name="WHYSEEUM" id="WHYSEEUM">3.14. Why would + anybody want to see a checkerboard pattern?</a></h3> <p>Remember that <a href="general.html#WHATSANAD">telling which image is an ad and which isn't</a>, is an educated guess. While we hope that @@ -453,9 +453,9 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN556" id="AEN556">3.15. I see some images - being replaced with text instead of the checkerboard image. Why and how - do I get rid of this?</a></h3> + <h3 class="SECT2"><a name="BLOCKEDBYTEXT" id="BLOCKEDBYTEXT">3.15. I + see some images being replaced with text instead of the checkerboard + image. Why and how do I get rid of this?</a></h3> <p>This happens when the banners are not embedded in the HTML code of the page itself, but in separate HTML (sub)documents that are loaded diff --git a/doc/webserver/faq/copyright.html b/doc/webserver/faq/copyright.html index 0859f980..88e8582e 100644 --- a/doc/webserver/faq/copyright.html +++ b/doc/webserver/faq/copyright.html @@ -55,7 +55,7 @@ "APPLICATION">Privoxy</span>.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1470" id="AEN1470">7.1. License</a></h2> + <h2 class="SECT2"><a name="AEN1484" id="AEN1484">7.1. License</a></h2> <p><span class="APPLICATION">Privoxy</span> is free software; you can redistribute it and/or modify it under the terms of the <i class= @@ -71,7 +71,7 @@ </div> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN1479" id="AEN1479">7.2. History</a></h2> + <h2 class="SECT2"><a name="AEN1493" id="AEN1493">7.2. History</a></h2> <p>A long time ago, there was the <span class="APPLICATION">Internet Junkbuster</span>, by Anonymous Coders and Junkbusters Corporation. diff --git a/doc/webserver/faq/general.html b/doc/webserver/faq/general.html index a72f5019..80c202cd 100644 --- a/doc/webserver/faq/general.html +++ b/doc/webserver/faq/general.html @@ -166,9 +166,9 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN82" id="AEN82">1.6. Why <span class= - "QUOTE">"Privoxy"</span>? Why change the name from Junkbuster at - all?</a></h3> + <h3 class="SECT2"><a name="WHYPRIVOXY" id="WHYPRIVOXY">1.6. Why + <span class="QUOTE">"Privoxy"</span>? Why change the name from + Junkbuster at all?</a></h3> <p>Though outdated, Junkbusters Corporation continued to offer their original version of the <span class="APPLICATION">Internet @@ -329,8 +329,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN158" id="AEN158">1.9. Can Privoxy make - mistakes? This does not sound very scientific.</a></h3> + <h3 class="SECT2"><a name="MISTAKES" id="MISTAKES">1.9. Can Privoxy + make mistakes? This does not sound very scientific.</a></h3> <p>Actually, it's a black art ;-) And yes, it is always possible to have a broad rule accidentally block or change something by mistake. @@ -347,8 +347,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN164" id="AEN164">1.10. Will I have to - configure Privoxy before I can use it?</a></h3> + <h3 class="SECT2"><a name="CONFIGORNOT" id="CONFIGORNOT">1.10. Will I + have to configure Privoxy before I can use it?</a></h3> <p>That depends on your expectations. The default installation should give you a good starting point, and block <span class= @@ -559,6 +559,11 @@ and a list of TODO list items you are interested in the most. For example: Max Mustermann: #16, #1, #14.</p> + <p>Note that donations made through Zwiebelfreunde e.V. currently + can't be checked automatically so you may not get credited right + away. The credits currently reflect donations received before + 2016-01-14.</p> + <p>If you have any questions regarding donations please mail to either the public user mailing list or, if it's a private matter, to <a href="mailto:fk@fabiankeil.de" target="_top">Fabian Keil</a> diff --git a/doc/webserver/faq/index.html b/doc/webserver/faq/index.html index 462d3d04..46ff1a6a 100644 --- a/doc/webserver/faq/index.html +++ b/doc/webserver/faq/index.html @@ -22,7 +22,7 @@ 2001-2014 by <a href="http://www.privoxy.org/" target="_top">Privoxy Developers</a></sub><br></p> - <p class="PUBDATE">$Id: faq.sgml,v 2.111 2016/01/21 15:55:49 fabiankeil + <p class="PUBDATE">$Id: faq.sgml,v 2.117 2016/03/04 13:21:33 fabiankeil Exp $<br></p> <div> @@ -66,7 +66,7 @@ </ul> <p>Please note that this document is a work in progress. This copy - represents the state at the release of version 3.0.24. You can find + represents the state at the release of version 3.0.25. You can find the latest version of the document at <a href= "http://www.privoxy.org/faq/" target= "_top">http://www.privoxy.org/faq/</a>. Please see the <a href= @@ -100,7 +100,7 @@ <dt>1.5. <a href="general.html#NEWJB">What is this new version of <span class="QUOTE">"Junkbuster"</span>?</a></dt> - <dt>1.6. <a href="general.html#AEN82">Why <span class= + <dt>1.6. <a href="general.html#WHYPRIVOXY">Why <span class= "QUOTE">"Privoxy"</span>? Why change the name from Junkbuster at all?</a></dt> @@ -110,11 +110,11 @@ <dt>1.8. <a href="general.html#WHATSANAD">How does Privoxy know what is an ad, and what is not?</a></dt> - <dt>1.9. <a href="general.html#AEN158">Can Privoxy make mistakes? - This does not sound very scientific.</a></dt> + <dt>1.9. <a href="general.html#MISTAKES">Can Privoxy make + mistakes? This does not sound very scientific.</a></dt> - <dt>1.10. <a href="general.html#AEN164">Will I have to configure - Privoxy before I can use it?</a></dt> + <dt>1.10. <a href="general.html#CONFIGORNOT">Will I have to + configure Privoxy before I can use it?</a></dt> <dt>1.11. <a href="general.html#LAN">Can Privoxy run as a server on a network?</a></dt> @@ -182,17 +182,17 @@ <dd> <dl> - <dt>3.1. <a href="configuration.html#AEN360">What exactly is an - <span class="QUOTE">"actions"</span> file?</a></dt> + <dt>3.1. <a href="configuration.html#ACTIONSFILE">What exactly is + an <span class="QUOTE">"actions"</span> file?</a></dt> <dt>3.2. <a href="configuration.html#ACTIONSS">The <span class= "QUOTE">"actions"</span> concept confuses me. Please list some of these <span class="QUOTE">"actions"</span>.</a></dt> - <dt>3.3. <a href="configuration.html#AEN383">How are actions + <dt>3.3. <a href="configuration.html#ACTCONFIG">How are actions files configured? What is the easiest way to do this?</a></dt> - <dt>3.4. <a href="configuration.html#AEN392">There are several + <dt>3.4. <a href="configuration.html#AEN393">There are several different <span class="QUOTE">"actions"</span> files. What are the differences?</a></dt> @@ -217,23 +217,23 @@ change the configuration with a browser? Does that not raise security issues?</a></dt> - <dt>3.11. <a href="configuration.html#AEN482">What is the + <dt>3.11. <a href="configuration.html#FILTERFILE">What is the <tt class="FILENAME">default.filter</tt> file? What is a <span class="QUOTE">"filter"</span>?</a></dt> <dt>3.12. <a href="configuration.html#LANCONFIG">How can I set up Privoxy to act as a proxy for my LAN?</a></dt> - <dt>3.13. <a href="configuration.html#AEN533">Instead of ads, now - I get a checkerboard pattern. I don't want to see + <dt>3.13. <a href="configuration.html#NOSEEUM">Instead of ads, + now I get a checkerboard pattern. I don't want to see anything.</a></dt> - <dt>3.14. <a href="configuration.html#AEN550">Why would anybody + <dt>3.14. <a href="configuration.html#WHYSEEUM">Why would anybody want to see a checkerboard pattern?</a></dt> - <dt>3.15. <a href="configuration.html#AEN556">I see some images - being replaced with text instead of the checkerboard image. Why - and how do I get rid of this?</a></dt> + <dt>3.15. <a href="configuration.html#BLOCKEDBYTEXT">I see some + images being replaced with text instead of the checkerboard + image. Why and how do I get rid of this?</a></dt> <dt>3.16. <a href="configuration.html#SRVANY">Can Privoxy run as a service on Win2K/NT/XP?</a></dt> @@ -292,8 +292,9 @@ <dd> <dl> - <dt>4.1. <a href="misc.html#AEN731">How much does Privoxy slow my - browsing down? This has to add extra time to browsing.</a></dt> + <dt>4.1. <a href="misc.html#SLOWSME">How much does Privoxy slow + my browsing down? This has to add extra time to + browsing.</a></dt> <dt>4.2. <a href="misc.html#LOADINGTIMES">I notice considerable delays in page requests. What's wrong?</a></dt> @@ -313,32 +314,32 @@ <dt>4.7. <a href="misc.html#IP">How can I hide my IP address?</a></dt> - <dt>4.8. <a href="misc.html#AEN796">Can Privoxy guarantee I am - anonymous?</a></dt> + <dt>4.8. <a href="misc.html#ANONFORSURE">Can Privoxy guarantee I + am anonymous?</a></dt> - <dt>4.9. <a href="misc.html#AEN814">A test site says I am not + <dt>4.9. <a href="misc.html#PROXYTEST">A test site says I am not using a Proxy.</a></dt> <dt>4.10. <a href="misc.html#TOR">How do I use Privoxy together with Tor?</a></dt> - <dt>4.11. <a href="misc.html#AEN872">Might some things break + <dt>4.11. <a href="misc.html#SITEBREAK">Might some things break because header information or content is being altered?</a></dt> - <dt>4.12. <a href="misc.html#AEN886">Can Privoxy act as a + <dt>4.12. <a href="misc.html#CACHING">Can Privoxy act as a <span class="QUOTE">"caching"</span> proxy to speed up web browsing?</a></dt> - <dt>4.13. <a href="misc.html#AEN896">What about as a firewall? + <dt>4.13. <a href="misc.html#FIREWALL">What about as a firewall? Can Privoxy protect me?</a></dt> - <dt>4.14. <a href="misc.html#AEN901">I have large empty spaces / + <dt>4.14. <a href="misc.html#WASTED">I have large empty spaces / a checkerboard pattern now where ads used to be. Why?</a></dt> - <dt>4.15. <a href="misc.html#AEN909">How can Privoxy filter - Secure (HTTPS) URLs?</a></dt> + <dt>4.15. <a href="misc.html#SSL">How can Privoxy filter Secure + (HTTPS) URLs?</a></dt> - <dt>4.16. <a href="misc.html#AEN923">Privoxy runs as a + <dt>4.16. <a href="misc.html#SECURE">Privoxy runs as a <span class="QUOTE">"server"</span>. How secure is it? Do I need to take any special precautions?</a></dt> @@ -387,14 +388,14 @@ <dd> <dl> - <dt>5.1. <a href="trouble.html#AEN1090">I cannot connect to any + <dt>5.1. <a href="trouble.html#REFUSED">I cannot connect to any websites. Or, I am getting <span class="QUOTE">"connection refused"</span> message with every web page. Why?</a></dt> <dt>5.2. <a href="trouble.html#ERROR503">Why am I getting a 503 Error (WSAECONNREFUSED) on every page?</a></dt> - <dt>5.3. <a href="trouble.html#AEN1113">I just added a new rule, + <dt>5.3. <a href="trouble.html#FLUSHIT">I just added a new rule, but the steenkin ad is still getting through. How?</a></dt> <dt>5.4. <a href="trouble.html#BADSITE">One of my favorite sites @@ -477,6 +478,9 @@ <dt>5.24. <a href="trouble.html#GENTOO-RICERS">I compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage and it appears to be very slow. Why?</a></dt> + + <dt>5.25. <a href="trouble.html#TAINTED-SOCKETS">What are tainted + sockets and how do I prevent them?</a></dt> </dl> </dd> @@ -520,9 +524,9 @@ <dd> <dl> - <dt>7.1. <a href="copyright.html#AEN1470">License</a></dt> + <dt>7.1. <a href="copyright.html#AEN1484">License</a></dt> - <dt>7.2. <a href="copyright.html#AEN1479">History</a></dt> + <dt>7.2. <a href="copyright.html#AEN1493">History</a></dt> </dl> </dd> </dl> diff --git a/doc/webserver/faq/misc.html b/doc/webserver/faq/misc.html index 03a8296a..94587352 100644 --- a/doc/webserver/faq/misc.html +++ b/doc/webserver/faq/misc.html @@ -41,7 +41,7 @@ <h1 class="SECT1"><a name="MISC" id="MISC">4. Miscellaneous</a></h1> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN731" id="AEN731">4.1. How much does + <h3 class="SECT2"><a name="SLOWSME" id="SLOWSME">4.1. How much does Privoxy slow my browsing down? This has to add extra time to browsing.</a></h3> @@ -131,6 +131,12 @@ "APPLICATION">Privoxy</span> for the request, hence it could not be intercepted, and you have accessed the <span class="emphasis"><i class= "EMPHASIS">real</i></span> web site at config.privoxy.org.</p> + + <p>Note that config.privoxy.org resolves to a public IP address. If you + use config.privoxy.org as ping or traceroute target you will reach the + system on the Internet (Privoxy can't intercept ICMP requests). If you + want to ping the system Privoxy runs on, you should use its IP address + or local DNS name (if it has got one).</p> </div> <div class="SECT2"> @@ -201,8 +207,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN796" id="AEN796">4.8. Can Privoxy - guarantee I am anonymous?</a></h3> + <h3 class="SECT2"><a name="ANONFORSURE" id="ANONFORSURE">4.8. Can + Privoxy guarantee I am anonymous?</a></h3> <p>No. Your chances of remaining anonymous are improved, but unless you <a href="#TOR" target="_top">chain <span class= @@ -246,8 +252,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN814" id="AEN814">4.9. A test site says I - am not using a Proxy.</a></h3> + <h3 class="SECT2"><a name="PROXYTEST" id="PROXYTEST">4.9. A test site + says I am not using a Proxy.</a></h3> <p>Good! Actually, they are probably testing for some other kinds of proxies. Hiding yourself completely would require additional steps.</p> @@ -374,8 +380,9 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN872" id="AEN872">4.11. Might some things - break because header information or content is being altered?</a></h3> + <h3 class="SECT2"><a name="SITEBREAK" id="SITEBREAK">4.11. Might some + things break because header information or content is being + altered?</a></h3> <p>Definitely. It is common for sites to use browser type, browser version, HTTP header content, and various other techniques in order to @@ -414,8 +421,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN886" id="AEN886">4.12. Can Privoxy act as - a <span class="QUOTE">"caching"</span> proxy to speed up web + <h3 class="SECT2"><a name="CACHING" id="CACHING">4.12. Can Privoxy act + as a <span class="QUOTE">"caching"</span> proxy to speed up web browsing?</a></h3> <p>No, it does not have this ability at all. You want something like @@ -430,8 +437,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN896" id="AEN896">4.13. What about as a - firewall? Can Privoxy protect me?</a></h3> + <h3 class="SECT2"><a name="FIREWALL" id="FIREWALL">4.13. What about as + a firewall? Can Privoxy protect me?</a></h3> <p>Not in the way you mean, or in the way some firewall vendors claim they can. <span class="APPLICATION">Privoxy</span> can help protect @@ -441,7 +448,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN901" id="AEN901">4.14. I have large empty + <h3 class="SECT2"><a name="WASTED" id="WASTED">4.14. I have large empty spaces / a checkerboard pattern now where ads used to be. Why?</a></h3> <p>It is technically possible to eliminate banners and ads in a way @@ -469,8 +476,8 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN909" id="AEN909">4.15. How can Privoxy - filter Secure (HTTPS) URLs?</a></h3> + <h3 class="SECT2"><a name="SSL" id="SSL">4.15. How can Privoxy filter + Secure (HTTPS) URLs?</a></h3> <p>Since secure HTTP connections are encrypted SSL sessions between your browser and the secure site, and are meant to be reliably @@ -503,7 +510,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN923" id="AEN923">4.16. Privoxy runs as a + <h3 class="SECT2"><a name="SECURE" id="SECURE">4.16. Privoxy runs as a <span class="QUOTE">"server"</span>. How secure is it? Do I need to take any special precautions?</a></h3> diff --git a/doc/webserver/faq/trouble.html b/doc/webserver/faq/trouble.html index cab801a3..7eaed90b 100644 --- a/doc/webserver/faq/trouble.html +++ b/doc/webserver/faq/trouble.html @@ -44,7 +44,7 @@ Troubleshooting</a></h1> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN1090" id="AEN1090">5.1. I cannot connect + <h3 class="SECT2"><a name="REFUSED" id="REFUSED">5.1. I cannot connect to any websites. Or, I am getting <span class="QUOTE">"connection refused"</span> message with every web page. Why?</a></h3> @@ -94,7 +94,7 @@ </div> <div class="SECT2"> - <h3 class="SECT2"><a name="AEN1113" id="AEN1113">5.3. I just added a + <h3 class="SECT2"><a name="FLUSHIT" id="FLUSHIT">5.3. I just added a new rule, but the steenkin ad is still getting through. How?</a></h3> <p>If the ad had been displayed before you added its URL, it will @@ -721,6 +721,41 @@ Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&si=Ua "QUOTE">"FEATURE_PTHREAD"</span> as <span class= "QUOTE">"enabled"</span>.</p> </div> + + <div class="SECT2"> + <h3 class="SECT2"><a name="TAINTED-SOCKETS" id="TAINTED-SOCKETS">5.25. + What are tainted sockets and how do I prevent them?</a></h3> + + <p><span class="APPLICATION">Privoxy</span> marks sockets as tainted + when it can't use them to serve additional requests. This does not + necessarily mean that something went wrong and information about + tainted sockets is only logged if connection debugging is enabled + (debug 2).</p> + + <p>For example server sockets that were used for CONNECT requests + (which are used to tunnel https:// requests) are considered tainted + once the client closed its connection to <span class= + "APPLICATION">Privoxy</span>. Technically <span class= + "APPLICATION">Privoxy</span> could keep the connection to the server + open, but the server would not accept requests that do not belong to + the previous TLS/SSL session (and the client may even have terminated + the session).</p> + + <p>Server sockets are also marked tainted when a client requests a + resource, but closes the connection before <span class= + "APPLICATION">Privoxy</span> has completely received (and forwarded) + the resource to the client. In this case the server would (probably) + accept additional requests, but <span class= + "APPLICATION">Privoxy</span> could not get the response without + completely reading the leftovers from the previous response.</p> + + <p>These are just two examples, there are currently a bit more than 25 + scenarios in which a socket is considered tainted.</p> + + <p>While sockets can also be marked tainted as a result of a technical + problem that may be worth fixing, the problem will be explicitly logged + as error.</p> + </div> </div> <div class="NAVFOOTER"> diff --git a/doc/webserver/index.html b/doc/webserver/index.html index fc666583..27852e30 100644 --- a/doc/webserver/index.html +++ b/doc/webserver/index.html @@ -52,7 +52,7 @@ </ul> <p>The most recent release is <a href="announce.txt" target= - "_top">3.0.24 (stable)</a>.</p> + "_top">3.0.25 (UNRELEASED)</a>.</p> </div> </div> <hr> diff --git a/doc/webserver/privoxy-index.html b/doc/webserver/privoxy-index.html index b9de3278..f096be25 100644 --- a/doc/webserver/privoxy-index.html +++ b/doc/webserver/privoxy-index.html @@ -19,7 +19,7 @@ <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy - The Privacy Enhancing Proxy</a></h1> - <h2 class="SUBTITLE">Project Index Page v3.0.24</h2> + <h2 class="SUBTITLE">Project Index Page v3.0.25</h2> <div> <div class="ABSTRACT"> diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index a0efab22..94a86172 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -6,7 +6,7 @@ <title>Actions Files</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="The Main Configuration File" href= "config.html"> <link rel="NEXT" title="Filter Files" href="filter-file.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -117,7 +117,7 @@ in <tt class="FILENAME">default.action</tt> are:</p> <div class="TABLE"> - <a name="AEN2614" id="AEN2614"></a> + <a name="AEN2618" id="AEN2618"></a> <p><b>Table 1. Default Configurations</b></p> @@ -314,8 +314,8 @@ actions</a>.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN2713" id="AEN2713">8.1. Finding the Right - Mix</a></h2> + <h2 class="SECT2"><a name="RIGHT-MIX" id="RIGHT-MIX">8.1. Finding the + Right Mix</a></h2> <p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like cookie suppression or script disabling, may render some sites unusable @@ -339,7 +339,7 @@ </div> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN2720" id="AEN2720">8.2. How to + <h2 class="SECT2"><a name="HOW-TO-EDIT" id="HOW-TO-EDIT">8.2. How to Edit</a></h2> <p>The easiest way to edit the actions files is with a browser by using @@ -644,8 +644,8 @@ </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN2914" id="AEN2914">8.4.2. The Path - Pattern</a></h3> + <h3 class="SECT3"><a name="PATH-PATTERN" id="PATH-PATTERN">8.4.2. The + Path Pattern</a></h3> <p><span class="APPLICATION">Privoxy</span> uses <span class= "QUOTE">"modern"</span> POSIX 1003.2 <a href= @@ -4513,7 +4513,7 @@ TAG:^image/ </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4653" id="AEN4653">8.5.36. + <h3 class="SECT3"><a name="SUMMARY" id="SUMMARY">8.5.36. Summary</a></h3> <p>Note that many of these actions have the potential to cause a page @@ -4672,7 +4672,7 @@ TAG:^image/ together:</p> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4717" id="AEN4717">8.7.1. + <h3 class="SECT3"><a name="MATCH-ALL" id="MATCH-ALL">8.7.1. match-all.action</a></h3> <p>Remember <span class="emphasis"><i class="EMPHASIS">all actions @@ -4721,7 +4721,7 @@ TAG:^image/ </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4739" id="AEN4739">8.7.2. + <h3 class="SECT3"><a name="DEFAULT-ACTION" id="DEFAULT-ACTION">8.7.2. default.action</a></h3> <p>If you aren't a developer, there's no need for you to edit the @@ -5064,7 +5064,7 @@ wiki. </div> <div class="SECT3"> - <h3 class="SECT3"><a name="AEN4852" id="AEN4852">8.7.3. + <h3 class="SECT3"><a name="USER-ACTION" id="USER-ACTION">8.7.3. user.action</a></h3> <p>So far we are painting with a broad brush by setting general diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html index 80ff44fe..46f97bbc 100644 --- a/doc/webserver/user-manual/appendix.html +++ b/doc/webserver/user-manual/appendix.html @@ -6,7 +6,7 @@ <title>Appendix</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="See Also" href="seealso.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> @@ -19,7 +19,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -293,8 +293,8 @@ </div> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5759" id="AEN5759">14.2. Privoxy's - Internal Pages</a></h2> + <h2 class="SECT2"><a name="INTERNAL-PAGES" id="INTERNAL-PAGES">14.2. + Privoxy's Internal Pages</a></h2> <p>Since <span class="APPLICATION">Privoxy</span> proxies each requested web page, it is easy for <span class= @@ -313,7 +313,7 @@ <ul> <li> - <p>Privoxy main page:</p><a name="AEN5773" id="AEN5773"></a> + <p>Privoxy main page:</p><a name="AEN5777" id="AEN5777"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/" target= @@ -328,8 +328,8 @@ <li> <p>Show information about the current configuration, including - viewing and editing of actions files:</p><a name="AEN5781" id= - "AEN5781"></a> + viewing and editing of actions files:</p><a name="AEN5785" id= + "AEN5785"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-status" target= @@ -338,8 +338,8 @@ </li> <li> - <p>Show the source code version numbers:</p><a name="AEN5786" id= - "AEN5786"></a> + <p>Show the source code version numbers:</p><a name="AEN5790" id= + "AEN5790"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-version" target= @@ -348,8 +348,8 @@ </li> <li> - <p>Show the browser's request headers:</p><a name="AEN5791" id= - "AEN5791"></a> + <p>Show the browser's request headers:</p><a name="AEN5795" id= + "AEN5795"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-request" target= @@ -358,8 +358,8 @@ </li> <li> - <p>Show which actions apply to a URL and why:</p><a name="AEN5796" - id="AEN5796"></a> + <p>Show which actions apply to a URL and why:</p><a name="AEN5800" + id="AEN5800"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/show-url-info" target= @@ -373,20 +373,20 @@ <span class="QUOTE">"off"</span>, <span class= "QUOTE">"Privoxy"</span> continues to run, but only as a pass-through proxy, with no actions taking place:</p><a name= - "AEN5804" id="AEN5804"></a> + "AEN5808" id="AEN5808"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/toggle" target= "_top">http://config.privoxy.org/toggle</a></p> </blockquote> - <p>Short cuts. Turn off, then on:</p><a name="AEN5808" id= - "AEN5808"></a> + <p>Short cuts. Turn off, then on:</p><a name="AEN5812" id= + "AEN5812"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/toggle?set=disable" target= "_top">http://config.privoxy.org/toggle?set=disable</a></p> - </blockquote><a name="AEN5811" id="AEN5811"></a> + </blockquote><a name="AEN5815" id="AEN5815"></a> <blockquote class="BLOCKQUOTE"> <p><a href="http://config.privoxy.org/toggle?set=enable" target= diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html index 0d13a394..44beeac6 100644 --- a/doc/webserver/user-manual/config.html +++ b/doc/webserver/user-manual/config.html @@ -6,7 +6,7 @@ <title>The Main Configuration File</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Privoxy Configuration" href= "configuration.html"> <link rel="NEXT" title="Actions Files" href="actions-file.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> diff --git a/doc/webserver/user-manual/configuration.html b/doc/webserver/user-manual/configuration.html index af213507..ed73cac2 100644 --- a/doc/webserver/user-manual/configuration.html +++ b/doc/webserver/user-manual/configuration.html @@ -6,7 +6,7 @@ <title>Privoxy Configuration</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Starting Privoxy" href="startup.html"> <link rel="NEXT" title="The Main Configuration File" href="config.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -46,8 +46,9 @@ controlled easily with a web browser.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN811" id="AEN811">6.1. Controlling Privoxy - with Your Web Browser</a></h2> + <h2 class="SECT2"><a name="CONTROL-WITH-WEBBROWSER" id= + "CONTROL-WITH-WEBBROWSER">6.1. Controlling Privoxy with Your Web + Browser</a></h2> <p><span class="APPLICATION">Privoxy</span>'s user interface can be reached through the special URL <a href="http://config.privoxy.org/" @@ -63,8 +64,8 @@ </pre> - <h2 class="BRIDGEHEAD"><a name="AEN819" id= - "AEN819"></a> Privoxy Menu</h2> + <h2 class="BRIDGEHEAD"><a name="AEN821" id= + "AEN821"></a> Privoxy Menu</h2> <pre> </pre> @@ -104,7 +105,7 @@ <tr> <td> - ▪ <a href="http://www.privoxy.org/3.0.24/user-manual/" + ▪ <a href="http://www.privoxy.org/3.0.25/user-manual/" target="_top">Documentation</a></td> </tr> </tbody> @@ -144,7 +145,9 @@ <p>For Unix, *BSD and Linux, all configuration files are located in <tt class="FILENAME">/etc/privoxy/</tt> by default. For MS Windows, OS/2, and AmigaOS these are all in the same directory as the - <span class="APPLICATION">Privoxy</span> executable.</p> + <span class="APPLICATION">Privoxy</span> executable. The name and + number of configuration files has changed from previous versions, and + is subject to change as development progresses.</p> <p>The installed defaults provide a reasonable starting point, though some settings may be aggressive by some standards. For the time being, @@ -233,6 +236,12 @@ "QUOTE">"wake up"</span> requests must obviously be sent to the <span class="emphasis"><i class="EMPHASIS">old</i></span> listening address.</p> + + <p>While under development, the configuration content is subject to + change. The below documentation may not be accurate by the time you + read this. Also, what constitutes a <span class= + "QUOTE">"default"</span> setting, may change, so please check all your + configuration files on important issues.</p> </div> </div> diff --git a/doc/webserver/user-manual/contact.html b/doc/webserver/user-manual/contact.html index ebb5e3c3..06371bd7 100644 --- a/doc/webserver/user-manual/contact.html +++ b/doc/webserver/user-manual/contact.html @@ -7,7 +7,7 @@ Requests</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Privoxy's Template Files" href= "templates.html"> <link rel="NEXT" title="Privoxy Copyright, License and History" href= @@ -23,7 +23,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> diff --git a/doc/webserver/user-manual/copyright.html b/doc/webserver/user-manual/copyright.html index c84b7353..803350e0 100644 --- a/doc/webserver/user-manual/copyright.html +++ b/doc/webserver/user-manual/copyright.html @@ -6,7 +6,7 @@ <title>Privoxy Copyright, License and History</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title= "Contacting the Developers, Bug Reporting and Feature Requests" href= "contact.html"> @@ -22,7 +22,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -562,6 +562,7 @@ Public License instead of this License. Angelina Matson<br> Jonathan McKenzie<br> David Mediavilla<br> + J. Momberger<br> Raphael Moll<br> Mathew Murphy<br> Amuro Namie<br> @@ -600,7 +601,8 @@ Public License instead of this License. Yang Xia<br> Jarry Xu<br> Oliver Yeoh<br> - Jamie Zawinski</p> + Jamie Zawinski<br> + Eduard Wulff</p> <p>Privoxy is based in part on code originally developed by Junkbusters Corp. and Anonymous Coders.</p> diff --git a/doc/webserver/user-manual/filter-file.html b/doc/webserver/user-manual/filter-file.html index 2fe7948a..3df87e6f 100644 --- a/doc/webserver/user-manual/filter-file.html +++ b/doc/webserver/user-manual/filter-file.html @@ -6,7 +6,7 @@ <title>Filter Files</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Actions Files" href="actions-file.html"> <link rel="NEXT" title="Privoxy's Template Files" href="templates.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -177,8 +177,8 @@ FILTER: foo Replace all "foo" with "bar" started.</p> <div class="SECT2"> - <h2 class="SECT2"><a name="AEN5020" id="AEN5020">9.1. Filter File - Tutorial</a></h2> + <h2 class="SECT2"><a name="FILTER-FILE-TUT" id="FILTER-FILE-TUT">9.1. + Filter File Tutorial</a></h2> <p>Now, let's complete our <span class="QUOTE">"foo"</span> content filter. We have already defined the heading, but the jobs are still diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html index 7b9add8c..712212dc 100644 --- a/doc/webserver/user-manual/index.html +++ b/doc/webserver/user-manual/index.html @@ -3,7 +3,7 @@ <html> <head> - <title>Privoxy 3.0.24 User Manual</title> + <title>Privoxy 3.0.25 User Manual</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> <link rel="NEXT" title="Introduction" href="introduction.html"> @@ -16,15 +16,15 @@ "#840084" alink="#0000FF"> <div class="ARTICLE"> <div class="TITLEPAGE"> - <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.24 User + <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.25 User Manual</a></h1> <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © 2001-2014 by <a href="http://www.privoxy.org/" target="_top">Privoxy Developers</a></sub><br></p> - <p class="PUBDATE">$Id: user-manual.sgml,v 2.202 2016/01/23 13:57:17 - diem Exp $<br></p> + <p class="PUBDATE">$Id: user-manual.sgml,v 2.204 2016/03/04 13:21:54 + fabiankeil Exp $<br></p> <div> <div class="ABSTRACT"> @@ -176,7 +176,8 @@ <dd> <dl> - <dt>6.1. <a href="configuration.html#AEN811">Controlling Privoxy + <dt>6.1. <a href= + "configuration.html#CONTROL-WITH-WEBBROWSER">Controlling Privoxy with Your Web Browser</a></dt> <dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration @@ -351,10 +352,11 @@ <dd> <dl> - <dt>8.1. <a href="actions-file.html#AEN2713">Finding the Right + <dt>8.1. <a href="actions-file.html#RIGHT-MIX">Finding the Right Mix</a></dt> - <dt>8.2. <a href="actions-file.html#AEN2720">How to Edit</a></dt> + <dt>8.2. <a href="actions-file.html#HOW-TO-EDIT">How to + Edit</a></dt> <dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions are Applied to Requests</a></dt> @@ -367,7 +369,7 @@ <dt>8.4.1. <a href="actions-file.html#HOST-PATTERN">The Host Pattern</a></dt> - <dt>8.4.2. <a href="actions-file.html#AEN2914">The Path + <dt>8.4.2. <a href="actions-file.html#PATH-PATTERN">The Path Pattern</a></dt> <dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag @@ -488,7 +490,7 @@ "actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt> <dt>8.5.36. <a href= - "actions-file.html#AEN4653">Summary</a></dt> + "actions-file.html#SUMMARY">Summary</a></dt> </dl> </dd> @@ -500,13 +502,13 @@ <dd> <dl> <dt>8.7.1. <a href= - "actions-file.html#AEN4717">match-all.action</a></dt> + "actions-file.html#MATCH-ALL">match-all.action</a></dt> <dt>8.7.2. <a href= - "actions-file.html#AEN4739">default.action</a></dt> + "actions-file.html#DEFAULT-ACTION">default.action</a></dt> <dt>8.7.3. <a href= - "actions-file.html#AEN4852">user.action</a></dt> + "actions-file.html#USER-ACTION">user.action</a></dt> </dl> </dd> </dl> @@ -516,7 +518,7 @@ <dd> <dl> - <dt>9.1. <a href="filter-file.html#AEN5020">Filter File + <dt>9.1. <a href="filter-file.html#FILTER-FILE-TUT">Filter File Tutorial</a></dt> <dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The @@ -587,8 +589,8 @@ <dt>14.1. <a href="appendix.html#REGEX">Regular Expressions</a></dt> - <dt>14.2. <a href="appendix.html#AEN5759">Privoxy's Internal - Pages</a></dt> + <dt>14.2. <a href="appendix.html#INTERNAL-PAGES">Privoxy's + Internal Pages</a></dt> <dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt> diff --git a/doc/webserver/user-manual/installation.html b/doc/webserver/user-manual/installation.html index 1e55d6b1..124aa25d 100644 --- a/doc/webserver/user-manual/installation.html +++ b/doc/webserver/user-manual/installation.html @@ -6,7 +6,7 @@ <title>Installation</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Introduction" href="introduction.html"> <link rel="NEXT" title="What's New in this Release" href="whatsnew.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -252,8 +252,8 @@ <tr> <td> <pre class="SCREEN"> - tar xzvf privoxy-3.0.24-stable-src.tar.gz - cd privoxy-3.0.24-stable + tar xzvf privoxy-3.0.25-beta-src.tar.gz + cd privoxy-3.0.25-beta </pre> </td> </tr> @@ -368,8 +368,8 @@ </tr> </table> - <p>Then build as above. In Privoxy 3.0.7 and later, all of these - options can also be disabled through the configuration file.</p> + <p>Note that all of these options can also be disabled through the + configuration file.</p> <p><span class="emphasis"><i class="EMPHASIS">WARNING:</i></span> If installing as root, the install will fail unless a non-root user or diff --git a/doc/webserver/user-manual/introduction.html b/doc/webserver/user-manual/introduction.html index 366196de..6719fb4c 100644 --- a/doc/webserver/user-manual/introduction.html +++ b/doc/webserver/user-manual/introduction.html @@ -6,8 +6,8 @@ <title>Introduction</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> - <link rel="PREVIOUS" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> + <link rel="PREVIOUS" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="NEXT" title="Installation" href="installation.html"> <link rel="STYLESHEET" type="text/css" href="../p_doc.css"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> @@ -20,7 +20,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -40,8 +40,17 @@ <h1 class="SECT1"><a name="INTRODUCTION" id="INTRODUCTION">1. Introduction</a></h1> - <p>This documentation is included with the current stable version of - <span class="APPLICATION">Privoxy</span>, 3.0.24.</p> + <p>This documentation is included with the current UNRELEASED version of + <span class="APPLICATION">Privoxy</span>, 3.0.25, and is mostly complete + at this point. The most up to date reference for the time being is still + the comments in the source files and in the individual configuration + files. Development of a new version is currently nearing completion, and + includes significant changes and enhancements over earlier versions.</p> + + <p>Since this is a UNRELEASED version, not all new features are well + tested. This documentation may be slightly out of sync as a result + (especially with CVS sources). And there <span class="emphasis"><i class= + "EMPHASIS">may be</i></span> bugs, though hopefully not many!</p> <div class="SECT2"> <h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1. @@ -50,8 +59,8 @@ <p>In addition to the core features of ad blocking and <a href= "http://en.wikipedia.org/wiki/Browser_cookie" target="_top">cookie</a> management, <span class="APPLICATION">Privoxy</span> provides many - supplemental features, that give the end-user more control, more - privacy and more freedom:</p> + supplemental features, some of them currently under development, that + give the end-user more control, more privacy and more freedom:</p> <ul> <li> @@ -157,7 +166,7 @@ </tr> <tr> - <td width="33%" align="left" valign="top">Privoxy 3.0.24 User + <td width="33%" align="left" valign="top">Privoxy 3.0.25 User Manual</td> <td width="34%" align="center" valign="top"> </td> diff --git a/doc/webserver/user-manual/quickstart.html b/doc/webserver/user-manual/quickstart.html index d36bbb56..58ac3ba8 100644 --- a/doc/webserver/user-manual/quickstart.html +++ b/doc/webserver/user-manual/quickstart.html @@ -6,7 +6,7 @@ <title>Quickstart to Using Privoxy</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="What's New in this Release" href= "whatsnew.html"> <link rel="NEXT" title="Starting Privoxy" href="startup.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -343,7 +343,7 @@ "GUIBUTTON">Edit</span>"</span>:</p> <div class="FIGURE"> - <a name="AEN572" id="AEN572"></a> + <a name="AEN574" id="AEN574"></a> <p><b>Figure 1. Actions Files in Use</b></p> diff --git a/doc/webserver/user-manual/seealso.html b/doc/webserver/user-manual/seealso.html index b748c488..e09d2701 100644 --- a/doc/webserver/user-manual/seealso.html +++ b/doc/webserver/user-manual/seealso.html @@ -6,7 +6,7 @@ <title>See Also</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Privoxy Copyright, License and History" href= "copyright.html"> <link rel="NEXT" title="Appendix" href="appendix.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html index fddc6225..efb07462 100644 --- a/doc/webserver/user-manual/startup.html +++ b/doc/webserver/user-manual/startup.html @@ -6,7 +6,7 @@ <title>Starting Privoxy</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Quickstart to Using Privoxy" href= "quickstart.html"> <link rel="NEXT" title="Privoxy Configuration" href="configuration.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> @@ -55,7 +55,7 @@ protocols.</p> <div class="FIGURE"> - <a name="AEN627" id="AEN627"></a> + <a name="AEN629" id="AEN629"></a> <p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and HTTPS (SSL) Settings</b></p> @@ -112,7 +112,7 @@ only HTTP and HTTPS (SSL)!</p> <div class="FIGURE"> - <a name="AEN672" id="AEN672"></a> + <a name="AEN674" id="AEN674"></a> <p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and HTTPS (Secure) Settings</b></p> diff --git a/doc/webserver/user-manual/templates.html b/doc/webserver/user-manual/templates.html index f2fdda10..e2879be2 100644 --- a/doc/webserver/user-manual/templates.html +++ b/doc/webserver/user-manual/templates.html @@ -6,7 +6,7 @@ <title>Privoxy's Template Files</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Filter Files" href="filter-file.html"> <link rel="NEXT" title= "Contacting the Developers, Bug Reporting and Feature Requests" href= @@ -22,7 +22,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr> diff --git a/doc/webserver/user-manual/whatsnew.html b/doc/webserver/user-manual/whatsnew.html index 3dfd2864..6eb7a630 100644 --- a/doc/webserver/user-manual/whatsnew.html +++ b/doc/webserver/user-manual/whatsnew.html @@ -6,7 +6,7 @@ <title>What's New in this Release</title> <meta name="GENERATOR" content= "Modular DocBook HTML Stylesheet Version 1.79"> - <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html"> + <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html"> <link rel="PREVIOUS" title="Installation" href="installation.html"> <link rel="NEXT" title="Quickstart to Using Privoxy" href= "quickstart.html"> @@ -21,7 +21,7 @@ <table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0"> <tr> - <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th> + <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th> </tr> <tr>