<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.23"</span>.</td>
+ <span class="QUOTE">"3.0.24"</span>.</td>
</tr>
<tr>
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.23. You can find
+ represents the state at the release of version 3.0.24. 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
<tr>
<td>
<pre class="PROGRAMLISTING">
- debchange -v 3.0.23-stable-1 "New upstream version"
+ debchange -v 3.0.24-stable-1 "New upstream version"
</pre>
</td>
</tr>
</table>
<p>This will create <tt class=
- "FILENAME">../privoxy_3.0.23-stable-1_i386.deb</tt> which can be
+ "FILENAME">../privoxy_3.0.24-stable-1_i386.deb</tt> which can be
uploaded. To upload the package to Sourceforge, simply issue</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
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.23 (beta)</i></span>.</p>
+ "emphasis"><i class="EMPHASIS">3.0.24 (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=
<h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">7. Privoxy
Copyright, License and History</a></h1>
- <p>Copyright © 2001-2015 by Privoxy Developers <code class=
+ <p>Copyright © 2001-2016 by Privoxy Developers <code class=
"EMAIL"><<a href=
"mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p>
"APPLICATION">Privoxy</span>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1469" id="AEN1469">7.1. License</a></h2>
+ <h2 class="SECT2"><a name="AEN1470" id="AEN1470">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=
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1478" id="AEN1478">7.2. History</a></h2>
+ <h2 class="SECT2"><a name="AEN1479" id="AEN1479">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.
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.107 2014/12/19 12:31:46 fabiankeil
+ <p class="PUBDATE">$Id: faq.sgml,v 2.109 2015/08/12 10:40:42 fabiankeil
Exp $<br></p>
<div>
</ul>
<p>Please note that this document is a work in progress. This copy
- represents the state at the release of version 3.0.23. You can find
+ represents the state at the release of version 3.0.24. 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=
internal CGI pages. What is a <span class=
"QUOTE">"crunch"</span>?</a></dt>
- <dt>4.21. <a href="misc.html#DOWNLOADS">Can Privoxy effect files
+ <dt>4.21. <a href="misc.html#DOWNLOADS">Can Privoxy affect files
that I download from a webserver? FTP server?</a></dt>
<dt>4.22. <a href="misc.html#DOWNLOADS2">I just downloaded a Perl
<dd>
<dl>
- <dt>5.1. <a href="trouble.html#AEN1089">I cannot connect to any
+ <dt>5.1. <a href="trouble.html#AEN1090">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#AEN1112">I just added a new rule,
+ <dt>5.3. <a href="trouble.html#AEN1113">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
<dd>
<dl>
- <dt>7.1. <a href="copyright.html#AEN1469">License</a></dt>
+ <dt>7.1. <a href="copyright.html#AEN1470">License</a></dt>
- <dt>7.2. <a href="copyright.html#AEN1478">History</a></dt>
+ <dt>7.2. <a href="copyright.html#AEN1479">History</a></dt>
</dl>
</dd>
</dl>
<div class="SECT2">
<h3 class="SECT2"><a name="DOWNLOADS" id="DOWNLOADS">4.21. Can Privoxy
- effect files that I download from a webserver? FTP server?</a></h3>
+ affect files that I download from a webserver? FTP server?</a></h3>
<p>From the webserver's perspective, there is no difference between
viewing a document (i.e. a page), and downloading a file. The same is
Privoxy, or maybe something that is based on the real Privoxy, but has
been modified.</p>
- <p>Lately there have been reports of problems with some kind of Privoxy
- versions that come preinstalled on some Netbooks. Some of the problems
- described are inconsistent with the behaviour of official Privoxy
- versions, which suggests that the preinstalled software may contain
- vendor modifications that we don't know about and thus can't debug.</p>
+ <p>Lately there have been reports of problems with some kind of
+ "parental control" software based on Privoxy that came preinstalled on
+ certain <a href="http://sourceforge.net/p/ijbswa/bugs/813/" target=
+ "_top">ASUS Netbooks</a>. The problems described are inconsistent with
+ the behaviour of official Privoxy versions, which suggests that the
+ preinstalled software may contain vendor modifications that we don't
+ know about and thus can't debug.</p>
<p>Privoxy's <a href="copyright.html">license</a> allows vendor
modifications, but the vendor has to comply with the license, which
Troubleshooting</a></h1>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN1089" id="AEN1089">5.1. I cannot connect
+ <h3 class="SECT2"><a name="AEN1090" id="AEN1090">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>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN1112" id="AEN1112">5.3. I just added a
+ <h3 class="SECT2"><a name="AEN1113" id="AEN1113">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
<h3 class="SECT2"><a name="DUN" id="DUN">5.5. After installing Privoxy,
I have to log in every time I start IE. What gives?</a></h3>
- <p>This is a quirk that effects the installation of <span class=
+ <p>This is a quirk that affects the installation of <span class=
"APPLICATION">Privoxy</span>, 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
</ul>
<p>The most recent release is <a href="announce.txt" target=
- "_top">3.0.23 (stable)</a>.</p>
+ "_top">3.0.24 (stable)</a>.</p>
</div>
</div>
<hr>
<div class="SECT1">
<h3 class="SECT1"><a name="DOWNLOAD" id="DOWNLOAD">Download</a></h3>
- <p>
- Privoxy downloads are available at
- <a href="https://sourceforge.net/projects/ijbswa/files/">SourceForge</a>.
- If you are not comfortable with downloading binaries from SourceForge, please
- use <a href="http://www.silvester.org.uk/privoxy/">the mirror</a>.
- </p>
- </ul>
+
+ <p>Privoxy downloads are available at <a href=
+ "https://sourceforge.net/projects/ijbswa/files/" target=
+ "_top">SourceForge</a>. If you are not comfortable with downloading
+ binaries from SourceForge, please use <a href=
+ "http://www.silvester.org.uk/privoxy/" target="_top">the
+ mirror</a>.</p>
</div>
<div class="SECT1">
<p><a href="user-manual/quickstart.html" target="_top">Quickstart
after installation</a></p>
</li>
+
<li>
<p><a href="user-manual/index.html" target="_top">User
manual</a></p>
<div class="SECT1">
<hr>
- <h2 class="SECT1"><a name="AEN66" id="AEN66"></a></h2>
+ <h2 class="SECT1"><a name="AEN64" id="AEN64"></a></h2>
<div class="INFORMALTABLE">
- <a name="AEN69" id="AEN69"></a>
+ <a name="AEN67" id="AEN67"></a>
<table border="0" frame="void" rules="all" width="100%" class=
"CALSTABLE">
</table>
</div>
- <p><sub>Copyright © 2001-2015 by Privoxy Developers</sub></p>
+ <p><sub>Copyright © 2001-2016 by Privoxy Developers</sub></p>
</div>
</div>
</body>
<h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy - The Privacy
Enhancing Proxy</a></h1>
- <h2 class="SUBTITLE">Project Index Page v3.0.23</h2>
+ <h2 class="SUBTITLE">Project Index Page v3.0.24</h2>
<div>
<div class="ABSTRACT">
<div class="SECT1">
<h3 class="SECT1"><a name="DOWNLOAD" id="DOWNLOAD">Download</a></h3>
- <ul>
- <li>
- <p><a href="https://sourceforge.net/projects/ijbswa/files/" target=
- "_top">Download recent releases</a></p>
- </li>
-
- <li>
- <p><a href="user-manual/quickstart.html" target="_top">Quickstart
- after installation</a></p>
- </li>
- </ul>
+ <p>Privoxy downloads are available at <a href=
+ "https://sourceforge.net/projects/ijbswa/files/" target=
+ "_top">SourceForge</a>. If you are not comfortable with downloading
+ binaries from SourceForge, please use <a href=
+ "http://www.silvester.org.uk/privoxy/" target="_top">the
+ mirror</a>.</p>
</div>
<div class="SECT1">
<h3 class="SECT1"><a name="DOCS" id="DOCS">Documentation</a></h3>
<ul>
+ <li>
+ <p><a href="user-manual/quickstart.html" target="_top">Quickstart
+ after installation</a></p>
+ </li>
+
<li>
<p><a href="user-manual/index.html" target="_top">User
manual</a></p>
<div class="SECT1">
<hr>
- <h2 class="SECT1"><a name="AEN65" id="AEN65"></a></h2>
+ <h2 class="SECT1"><a name="AEN63" id="AEN63"></a></h2>
- <p><sub>Copyright © 2001-2015 by Privoxy Developers</sub></p>
+ <p><sub>Copyright © 2001-2016 by Privoxy Developers</sub></p>
</div>
</div>
</body>
<title>Actions Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
in <tt class="FILENAME">default.action</tt> are:</p>
<div class="TABLE">
- <a name="AEN2543" id="AEN2543"></a>
+ <a name="AEN2599" id="AEN2599"></a>
<p><b>Table 1. Default Configurations</b></p>
actions</a>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2642" id="AEN2642">8.1. Finding the Right
+ <h2 class="SECT2"><a name="AEN2698" id="AEN2698">8.1. Finding the Right
Mix</a></h2>
<p>Note that some <a href="actions-file.html#ACTIONS">actions</a>, like
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2649" id="AEN2649">8.2. How to
+ <h2 class="SECT2"><a name="AEN2705" id="AEN2705">8.2. How to
Edit</a></h2>
<p>The easiest way to edit the actions files is with a browser by using
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN2843" id="AEN2843">8.4.2. The Path
+ <h3 class="SECT3"><a name="AEN2899" id="AEN2899">8.4.2. The Path
Pattern</a></h3>
<p><span class="APPLICATION">Privoxy</span> uses <span class=
<dt>Type:</dt>
<dd>
- <p>Parameterized.</p>
+ <p>Multi-value.</p>
</dd>
<dt>Parameter:</dt>
<dt>Type:</dt>
<dd>
- <p>Parameterized.</p>
+ <p>Multi-value.</p>
</dd>
<dt>Parameter:</dt>
<dt>Type:</dt>
<dd>
- <p>Parameterized.</p>
+ <p>Multi-value.</p>
</dd>
<dt>Parameter:</dt>
<dt>Type:</dt>
<dd>
- <p>Parameterized.</p>
+ <p>Multi-value.</p>
</dd>
<dt>Parameter:</dt>
<dt>Type:</dt>
<dd>
- <p>Multi-value.</p>
+ <p>Parameterized.</p>
</dd>
<dt>Parameter:</dt>
<span class="QUOTE">"forward-socks5"</span> for socks5
connections (with remote DNS resolution).</p>
</li>
+
+ <li>
+ <p><span class="QUOTE">"forward-webserver
+ 127.0.0.1:80"</span> to use the HTTP server listening at
+ 127.0.0.1 port 80 without adjusting the request
+ headers.</p>
+
+ <p>This makes it more convenient to use Privoxy to make
+ existing websites available as onion services as well.</p>
+
+ <p>Many websites serve content with hardcoded URLs and
+ can't be easily adjusted to change the domain based on the
+ one used by the client.</p>
+
+ <p>Putting Privoxy between Tor and the webserver (or an
+ stunnel that forwards to the webserver) allows to rewrite
+ headers and content to make client and server happy at the
+ same time.</p>
+
+ <p>Using Privoxy for webservers that are only reachable
+ through onion addresses and whose location is supposed to
+ be secret is not recommended and should not be necessary
+ anyway.</p>
+ </li>
</ul>
</dd>
<dt>Type:</dt>
<dd>
- <p>Parameterized.</p>
+ <p>Multi-value.</p>
</dd>
<dt>Parameter:</dt>
<dt>Type:</dt>
<dd>
- <p>Parameterized.</p>
+ <p>Multi-value.</p>
</dd>
<dt>Parameter:</dt>
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4575" id="AEN4575">8.5.36.
+ <h3 class="SECT3"><a name="AEN4638" id="AEN4638">8.5.36.
Summary</a></h3>
<p>Note that many of these actions have the potential to cause a page
together:</p>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4639" id="AEN4639">8.7.1.
+ <h3 class="SECT3"><a name="AEN4702" id="AEN4702">8.7.1.
match-all.action</a></h3>
<p>Remember <span class="emphasis"><i class="EMPHASIS">all actions
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4661" id="AEN4661">8.7.2.
+ <h3 class="SECT3"><a name="AEN4724" id="AEN4724">8.7.2.
default.action</a></h3>
<p>If you aren't a developer, there's no need for you to edit the
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4774" id="AEN4774">8.7.3.
+ <h3 class="SECT3"><a name="AEN4837" id="AEN4837">8.7.3.
user.action</a></h3>
<p>So far we are painting with a broad brush by setting general
<title>Appendix</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5681" id="AEN5681">14.2. Privoxy's
+ <h2 class="SECT2"><a name="AEN5744" id="AEN5744">14.2. Privoxy's
Internal Pages</a></h2>
<p>Since <span class="APPLICATION">Privoxy</span> proxies each
<ul>
<li>
- <p>Privoxy main page:</p><a name="AEN5695" id="AEN5695"></a>
+ <p>Privoxy main page:</p><a name="AEN5758" id="AEN5758"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/" target=
<li>
<p>Show information about the current configuration, including
- viewing and editing of actions files:</p><a name="AEN5703" id=
- "AEN5703"></a>
+ viewing and editing of actions files:</p><a name="AEN5766" id=
+ "AEN5766"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-status" target=
</li>
<li>
- <p>Show the source code version numbers:</p><a name="AEN5708" id=
- "AEN5708"></a>
+ <p>Show the source code version numbers:</p><a name="AEN5771" id=
+ "AEN5771"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-version" target=
</li>
<li>
- <p>Show the browser's request headers:</p><a name="AEN5713" id=
- "AEN5713"></a>
+ <p>Show the browser's request headers:</p><a name="AEN5776" id=
+ "AEN5776"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-request" target=
</li>
<li>
- <p>Show which actions apply to a URL and why:</p><a name="AEN5718"
- id="AEN5718"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN5781"
+ id="AEN5781"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/show-url-info" target=
<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=
- "AEN5726" id="AEN5726"></a>
+ "AEN5789" id="AEN5789"></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="AEN5730" id=
- "AEN5730"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN5793" id=
+ "AEN5793"></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="AEN5733" id="AEN5733"></a>
+ </blockquote><a name="AEN5796" id="AEN5796"></a>
<blockquote class="BLOCKQUOTE">
<p><a href="http://config.privoxy.org/toggle?set=enable" target=
<title>The Main Configuration File</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html">
<link rel="PREVIOUS" title="Privoxy Configuration" href=
"configuration.html">
<link rel="NEXT" title="Actions Files" href="actions-file.html">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<title>Privoxy Configuration</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
controlled easily with a web browser.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN740" id="AEN740">6.1. Controlling Privoxy
+ <h2 class="SECT2"><a name="AEN796" id="AEN796">6.1. Controlling Privoxy
with Your Web Browser</a></h2>
<p><span class="APPLICATION">Privoxy</span>'s user interface can be
</pre>
- <h2 class="BRIDGEHEAD"><a name="AEN748" id=
- "AEN748"></a> Privoxy Menu</h2>
+ <h2 class="BRIDGEHEAD"><a name="AEN804" id=
+ "AEN804"></a> Privoxy Menu</h2>
<pre>
</pre>
<tr>
<td>
- ▪ <a href="http://www.privoxy.org/3.0.23/user-manual/"
+ ▪ <a href="http://www.privoxy.org/3.0.24/user-manual/"
target="_top">Documentation</a></td>
</tr>
</tbody>
Requests</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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=
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<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.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html">
<link rel="PREVIOUS" title=
"Contacting the Developers, Bug Reporting and Feature Requests" href=
"contact.html">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<h1 class="SECT1"><a name="COPYRIGHT" id="COPYRIGHT">12. Privoxy
Copyright, License and History</a></h1>
- <p>Copyright © 2001-2015 by Privoxy Developers <code class=
+ <p>Copyright © 2001-2016 by Privoxy Developers <code class=
"EMAIL"><<a href=
"mailto:ijbswa-developers@lists.sourceforge.net">ijbswa-developers@lists.sourceforge.net</a>></code></p>
provided patches, made suggestions, donated or contributed in some
other way. These include (in alphabetical order):</p>
- <p class="LITERALLAYOUT"> Anatoly Arzhnikov<br>
+ <p class="LITERALLAYOUT"> Rustam Abdullaev<br>
+ Anatoly Arzhnikov<br>
Ken Arromdee<br>
Natxo Asenjo<br>
Devin Bayer<br>
Andrew J. Caines<br>
Clifford Caoile<br>
Edward Carrel<br>
+ Pak Chan<br>
Wan-Teh Chang<br>
Sam Chen<br>
Ramkumar Chinchani<br>
Julien Joubert<br>
Ralf Jungblut<br>
Petr Kadlec<br>
+ Robert Klemme<br>
Steven Kolins<br>
+ Korda<br>
Stefan Kurtz<br>
Zeno Kugy<br>
David Laight<br>
Raphael Marichez<br>
Francois Marier<br>
Angelina Matson<br>
+ Jonathan McKenzie<br>
David Mediavilla<br>
Raphael Moll<br>
Mathew Murphy<br>
Maynard Riley<br>
Andreas Rutkauskas<br>
Bart Schelstraete<br>
+ Gregory Seidman<br>
Chung-chieh Shan<br>
Benjamin C. Wiley Sittler<br>
Simon South<br>
Peter Thoenen<br>
Martin Thomas<br>
Reuben Thomas<br>
+ Guybrush Threepwood<br>
+ Joel Verhagen<br>
Bobby G. Vinyard<br>
Jochen Voss<br>
David Wagner<br>
Jörg Weinmann<br>
Darren Wiebe<br>
Anduin Withers<br>
+ Yang Xia<br>
+ Jarry Xu<br>
Oliver Yeoh<br>
Jamie Zawinski</p>
<title>Filter Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
started.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN4942" id="AEN4942">9.1. Filter File
+ <h2 class="SECT2"><a name="AEN5005" id="AEN5005">9.1. Filter File
Tutorial</a></h2>
<p>Now, let's complete our <span class="QUOTE">"foo"</span> content
<html>
<head>
- <title>Privoxy 3.0.23 User Manual</title>
+ <title>Privoxy 3.0.24 User Manual</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
<link rel="NEXT" title="Introduction" href="introduction.html">
"#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
- <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.23 User
+ <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.24 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.194 2014/10/21 15:30:52
+ <p class="PUBDATE">$Id: user-manual.sgml,v 2.197 2016/01/16 12:30:58
fabiankeil Exp $<br></p>
<div>
<dd>
<dl>
- <dt>6.1. <a href="configuration.html#AEN740">Controlling Privoxy
+ <dt>6.1. <a href="configuration.html#AEN796">Controlling Privoxy
with Your Web Browser</a></dt>
<dt>6.2. <a href="configuration.html#CONFOVERVIEW">Configuration
<dd>
<dl>
- <dt>8.1. <a href="actions-file.html#AEN2642">Finding the Right
+ <dt>8.1. <a href="actions-file.html#AEN2698">Finding the Right
Mix</a></dt>
- <dt>8.2. <a href="actions-file.html#AEN2649">How to Edit</a></dt>
+ <dt>8.2. <a href="actions-file.html#AEN2705">How to Edit</a></dt>
<dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
are Applied to Requests</a></dt>
<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#AEN2843">The Path
+ <dt>8.4.2. <a href="actions-file.html#AEN2899">The Path
Pattern</a></dt>
<dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
"actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
<dt>8.5.36. <a href=
- "actions-file.html#AEN4575">Summary</a></dt>
+ "actions-file.html#AEN4638">Summary</a></dt>
</dl>
</dd>
<dd>
<dl>
<dt>8.7.1. <a href=
- "actions-file.html#AEN4639">match-all.action</a></dt>
+ "actions-file.html#AEN4702">match-all.action</a></dt>
<dt>8.7.2. <a href=
- "actions-file.html#AEN4661">default.action</a></dt>
+ "actions-file.html#AEN4724">default.action</a></dt>
<dt>8.7.3. <a href=
- "actions-file.html#AEN4774">user.action</a></dt>
+ "actions-file.html#AEN4837">user.action</a></dt>
</dl>
</dd>
</dl>
<dd>
<dl>
- <dt>9.1. <a href="filter-file.html#AEN4942">Filter File
+ <dt>9.1. <a href="filter-file.html#AEN5005">Filter File
Tutorial</a></dt>
<dt>9.2. <a href="filter-file.html#PREDEFINED-FILTERS">The
<dt>14.1. <a href="appendix.html#REGEX">Regular
Expressions</a></dt>
- <dt>14.2. <a href="appendix.html#AEN5681">Privoxy's Internal
+ <dt>14.2. <a href="appendix.html#AEN5744">Privoxy's Internal
Pages</a></dt>
<dt>14.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>
<title>Installation</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<tr>
<td>
<pre class="SCREEN">
- tar xzvf privoxy-3.0.23-stable-src.tar.gz
- cd privoxy-3.0.23-stable
+ tar xzvf privoxy-3.0.24-stable-src.tar.gz
+ cd privoxy-3.0.24-stable
</pre>
</td>
</tr>
<title>Introduction</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
- <link rel="PREVIOUS" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <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="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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
Introduction</a></h1>
<p>This documentation is included with the current stable version of
- <span class="APPLICATION">Privoxy</span>, 3.0.23.</p>
+ <span class="APPLICATION">Privoxy</span>, 3.0.24.</p>
<div class="SECT2">
<h2 class="SECT2"><a name="FEATURES" id="FEATURES">1.1.
</tr>
<tr>
- <td width="33%" align="left" valign="top">Privoxy 3.0.23 User
+ <td width="33%" align="left" valign="top">Privoxy 3.0.24 User
Manual</td>
<td width="34%" align="center" valign="top"> </td>
<title>Quickstart to Using Privoxy</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
"GUIBUTTON">Edit</span>"</span>:</p>
<div class="FIGURE">
- <a name="AEN516" id="AEN516"></a>
+ <a name="AEN572" id="AEN572"></a>
<p><b>Figure 1. Actions Files in Use</b></p>
<title>See Also</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<title>Starting Privoxy</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
protocols.</p>
<div class="FIGURE">
- <a name="AEN571" id="AEN571"></a>
+ <a name="AEN627" id="AEN627"></a>
<p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and
HTTPS (SSL) Settings</b></p>
only HTTP and HTTPS (SSL)!</p>
<div class="FIGURE">
- <a name="AEN616" id="AEN616"></a>
+ <a name="AEN672" id="AEN672"></a>
<p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
HTTPS (Secure) Settings</b></p>
<title>Privoxy's Template Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 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=
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<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.23 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.24 User Manual" href="index.html">
<link rel="PREVIOUS" title="Installation" href="installation.html">
<link rel="NEXT" title="Quickstart to Using Privoxy" href=
"quickstart.html">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.23 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.24 User Manual</th>
</tr>
<tr>
<h1 class="SECT1"><a name="WHATSNEW" id="WHATSNEW">3. What's New in this
Release</a></h1>
- <p><span class="APPLICATION">Privoxy 3.0.23</span> stable is a bug-fix
- release, some of the fixed bugs are security issues:</p>
+ <p><span class="APPLICATION">Privoxy 3.0.24</span> stable contains a
+ couple of new features but is mainly a bug-fix release. Two of the fixed
+ bugs are security issues (CVE requests pending) and may be used to
+ remotely trigger crashes on platforms that carefully check memory
+ accesses (most don't).</p>
<ul>
+ <li>
+ <p>Security fixes (denial of service):</p>
+
+ <ul>
+ <li>
+ <p>Prevent invalid reads in case of corrupt chunk-encoded
+ content. Bug discovered with afl-fuzz and AddressSanitizer.</p>
+ </li>
+
+ <li>
+ <p>Remove empty Host headers in client requests. Previously they
+ would result in invalid reads. Bug discovered with afl-fuzz and
+ AddressSanitizer.</p>
+ </li>
+ </ul>
+ </li>
+
<li>
<p>Bug fixes:</p>
<ul>
<li>
- <p>Fixed a DoS issue in case of client requests with incorrect
- chunk-encoded body. When compiled with assertions enabled (the
- default) they could previously cause Privoxy to abort(). Reported
- by Matthew Daley. CVE-2015-1380.</p>
+ <p>When using socks5t, send the request body optimistically as
+ well. Previously the request body wasn't guaranteed to be sent at
+ all and the error message incorrectly blamed the server. Fixes
+ #1686 reported by Peter Müller and G4JC.</p>
+ </li>
+
+ <li>
+ <p>Fixed buffer scaling in execute_external_filter() that could
+ lead to crashes. Submitted by Yang Xia in #892.</p>
+ </li>
+
+ <li>
+ <p>Fixed crashes when executing external filters on platforms
+ like Mac OS X. Reported by Jonathan McKenzie on ijbswa-users@</p>
+ </li>
+
+ <li>
+ <p>Properly parse ACL directives with ports when compiled with
+ HAVE_RFC2553. Previously the port wasn't removed from the host
+ and in case of 'permit-access 127.0.0.1 example.org:80' Privoxy
+ would try (and fail) to resolve "example.org:80" instead of
+ example.org. Reported by Pak Chan on ijbswa-users@.</p>
+ </li>
+
+ <li>
+ <p>Check requests more carefully before serving them forcefully
+ when blocks aren't enforced. Privoxy always adds the force token
+ at the beginning of the path, but would previously accept it
+ anywhere in the request line. This could result in requests being
+ served that should be blocked. For example in case of pages that
+ were loaded with force and contained JavaScript to create
+ additionally requests that embed the origin URL (thus inheriting
+ the force prefix). The bug is not considered a security issue and
+ the fix does not make it harder for remote sites to intentionally
+ circumvent blocks if Privoxy isn't configured to enforce them.
+ Fixes #1695 reported by Korda.</p>
+ </li>
+
+ <li>
+ <p>Normalize the request line in intercepted requests to make
+ rewriting the destination more convenient. Previously rewrites
+ for intercepted requests were expected to fail unless $hostport
+ was being used, but they failed "the wrong way" and would result
+ in an out-of-memory message (vanilla host patterns) or a crash
+ (extended host patterns). Reported by "Guybrush Threepwood" in
+ #1694.</p>
</li>
<li>
- <p>Fixed multiple segmentation faults and memory leaks in the
- pcrs code. This fix also increases the chances that an invalid
- pcrs command is rejected as such. Previously some invalid
- commands would be loaded without error. Note that Privoxy's pcrs
- sources (action and filter files) are considered trustworthy
- input and should not be writable by untrusted third-parties.
- CVE-2015-1381.</p>
+ <p>Enable socket lingering for the correct socket. Previously it
+ was repeatedly enabled for the listen socket instead of for the
+ accepted socket. The bug was found by code inspection and did not
+ cause any (reported) issues.</p>
</li>
<li>
- <p>Fixed an 'invalid read' bug which could at least theoretically
- cause Privoxy to crash. So far, no crashes have been observed.
- CVE-2015-1382.</p>
+ <p>Detect and reject parameters for parameter-less actions.
+ Previously they were silently ignored.</p>
</li>
<li>
- <p>Compiles with --disable-force again. Reported by Kai
- Raven.</p>
+ <p>Fixed invalid reads in internal and outdated pcre code. Found
+ with afl-fuzz and AddressSanitizer.</p>
</li>
<li>
- <p>Client requests with body that can't be delivered no longer
- cause pipelined requests behind them to be rejected as invalid.
- Reported by Basil Hussain.</p>
+ <p>Prevent invalid read when loading invalid action files. Found
+ with afl-fuzz and AddressSanitizer.</p>
+ </li>
+
+ <li>
+ <p>Windows build: Use the correct function to close the event
+ handle. It's unclear if this bug had a negative impact on
+ Privoxy's behaviour. Reported by Jarry Xu in #891.</p>
+ </li>
+
+ <li>
+ <p>In case of invalid forward-socks5(t) directives, use the
+ correct directive name in the error messages. Previously they
+ referred to forward-socks4t failures. Reported by Joel Verhagen
+ in #889.</p>
</li>
</ul>
</li>
<ul>
<li>
- <p>If a pcrs command is rejected as invalid, Privoxy now logs the
- cause of the problem as text. Previously the pcrs error code was
- logged.</p>
+ <p>Set NO_DELAY flag for the accepting socket. This significantly
+ reduces the latency if the operating system is not configured to
+ set the flag by default. Reported by Johan Sintorn in #894.</p>
+ </li>
+
+ <li>
+ <p>Allow to build with mingw x86_64. Submitted by Rustam
+ Abdullaev in #135.</p>
+ </li>
+
+ <li>
+ <p>Introduce the new forwarding type 'forward-webserver'.
+ Currently it is only supported by the forward-override{} action
+ and there's no config directive with the same name. The
+ forwarding type is similar to 'forward', but the request line
+ only contains the path instead of the complete URL.</p>
+ </li>
+
+ <li>
+ <p>The CGI editor no longer treats 'standard.action' special.
+ Nowadays the official "standards" are part of default.action and
+ there's no obvious reason to disallow editing them through the
+ cgi editor anyway (if the user decided that the lack of
+ authentication isn't an issue in her environment).</p>
+ </li>
+
+ <li>
+ <p>Improved error messages when rejecting intercepted requests
+ with unknown destination.</p>
</li>
<li>
- <p>The tests are less likely to cause false positives.</p>
+ <p>A couple of log messages now include the number of active
+ threads.</p>
+ </li>
+
+ <li>
+ <p>Removed non-standard Proxy-Agent headers in HTTP snipplets to
+ make testing more convenient.</p>
+ </li>
+
+ <li>
+ <p>Include the error code for pcre errors Privoxy does not
+ recognize.</p>
+ </li>
+
+ <li>
+ <p>Config directives with numerical arguments are checked more
+ carefully.</p>
+ </li>
+
+ <li>
+ <p>Privoxy's malloc() wrapper has been changed to prevent
+ zero-size allocations which should only occur as the result of
+ bugs.</p>
+ </li>
+
+ <li>
+ <p>Various cosmetic changes.</p>
</li>
</ul>
</li>
<ul>
<li>
- <p>'.sify.com/' is no longer blocked. Apparently it is not
- actually a pure tracking site (anymore?). Reported by Andrew on
- ijbswa-users@.</p>
+ <p>Unblock ".deutschlandradiokultur.de/". Reported by u302320 in
+ #924.</p>
+ </li>
+
+ <li>
+ <p>Add two fast-redirect exceptions for "yandex.ru".</p>
+ </li>
+
+ <li>
+ <p>Disable filter{banners-by-size} for ".plasmaservice.de/".</p>
</li>
<li>
- <p>Unblock banners on .amnesty.de/ which aren't ads.</p>
+ <p>Unblock klikki.fi/adv/.</p>
+ </li>
+
+ <li>
+ <p>Block requests for "resources.infolinks.com/". Reported by
+ "Black Rider" on ijbswa-users@.</p>
+ </li>
+
+ <li>
+ <p>Block a bunch of criteo domains. Reported by Black Rider.</p>
+ </li>
+
+ <li>
+ <p>Block "abs.proxistore.com/abe/". Reported by Black Rider.</p>
+ </li>
+
+ <li>
+ <p>Disable filter{banners-by-size} for
+ ".black-mosquito.org/".</p>
+ </li>
+
+ <li>
+ <p>Disable fast-redirects for "disqus.com/".</p>
</li>
</ul>
</li>
<ul>
<li>
- <p>The 'Would you like to donate?' section now also contains a
- "Paypal" address.</p>
+ <p>FAQ: Explicitly point fingers at ASUS as an example of a
+ company that has been reported to force malware based on Privoxy
+ upon its customers.</p>
</li>
<li>
- <p>The list of supported operating systems has been updated.</p>
+ <p>Correctly document the action type for a bunch of
+ "multi-value" actions that were incorrectly documented to be
+ "parameterized". Reported by Gregory Seidman on
+ ijbswa-users@.</p>
</li>
<li>
- <p>The existence of the SF support and feature trackers has been
- deemphasized because they have been broken for months. Most of
- the time the mailing lists still work.</p>
+ <p>Fixed the documented type of the forward-override{} action
+ which is obviously 'parameterized'.</p>
</li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Website improvements:</p>
+ <ul>
<li>
- <p>The claim that default.action updates are sometimes released
- on their own has been removed. It hasn't happened in years.</p>
+ <p>Users who don't trust binaries served by SourceForge can get
+ them from a mirror. Migrating away from SourceForge is planned
+ for 2016 (TODO list item #53).</p>
</li>
<li>
- <p>Explicitly mention that Tor's port may deviate from the
- default when using a bundle. Requested by Andrew on
- ijbswa-users@.</p>
+ <p>The website is now available as onion service
+ (http://jvauzb4sb3bwlsnc.onion/).</p>
</li>
</ul>
</li>