<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.21"</span>.</td>
+ <span class="QUOTE">"3.0.22"</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.21. You can find
+ represents the state at the release of version 3.0.22. 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.21-stable-1 "New upstream version"
+ debchange -v 3.0.22-UNRELEASED-1 "New upstream version"
</pre>
</td>
</tr>
</table>
<p>This will create <tt class=
- "FILENAME">../privoxy_3.0.21-stable-1_i386.deb</tt> which can be
+ "FILENAME">../privoxy_3.0.22-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%">
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.21 (beta)</i></span>.</p>
+ "emphasis"><i class="EMPHASIS">3.0.22 (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=
configuration so complicated?</a></h3>
<p><span class="QUOTE">"Complicated"</span> is in the eye of the
- beholder. Those that are familiar with some of the underlying concepts,
- such as regular expression syntax, take to it like a fish takes to
- water. Also, software that tries hard to be <span class="QUOTE">"user
- friendly"</span>, often lacks sophistication and flexibility. There is
- always that trade-off there between power vs. easy-of-use. Furthermore,
- anyone is welcome to contribute ideas and implementations to enhance
- <span class="APPLICATION">Privoxy</span>.</p>
+ beholder.</p>
+
+ <p>Privoxy is currently mainly written by and for people who are
+ already familiar with the underlying concepts like regular expressions,
+ HTTP and HTML, or are willing to become familiar with them to be able
+ to get the most out of a powerful and flexible tool such as
+ Privoxy.</p>
+
+ <p>While everybody is expected to be able to get a Privoxy default
+ installation up and running, fine-tuning requires a certain amount of
+ background information and Privoxy's documentation mainly concentrates
+ on the Privoxy-specific parts while only providing references to the
+ rest.</p>
+
+ <p>If you or anyone you know has the skills, time and energy to reduce
+ the barrier of entry, please <a href="general.html#PARTICIPATE">get
+ involved</a>.</p>
</div>
<div class="SECT2">
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN486" id="AEN486">3.11. What is the
+ <h3 class="SECT2"><a name="AEN488" id="AEN488">3.11. What is the
<tt class="FILENAME">default.filter</tt> file? What is a <span class=
"QUOTE">"filter"</span>?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN537" id="AEN537">3.13. Instead of ads,
+ <h3 class="SECT2"><a name="AEN539" id="AEN539">3.13. Instead of ads,
now I get a checkerboard pattern. I don't want to see
anything.</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN554" id="AEN554">3.14. Why would anybody
+ <h3 class="SECT2"><a name="AEN556" id="AEN556">3.14. Why would anybody
want to see a checkerboard pattern?</a></h3>
<p>Remember that <a href="general.html#WHATSANAD">telling which image
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN560" id="AEN560">3.15. I see some images
+ <h3 class="SECT2"><a name="AEN562" id="AEN562">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>
<li>
<p><span class="QUOTE">"Bugs"</span> in the programming code that
makes up <span class="APPLICATION">Privoxy</span>, such as that
- might cause a crash.</p>
+ might cause a crash. Documentation issues, for example spelling
+ errors and unclear descriptions, are bugs, too.</p>
</li>
</ul>
"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="AEN1479" id="AEN1479">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="AEN1479" id="AEN1479">7.2. History</a></h2>
+ <h2 class="SECT2"><a name="AEN1488" id="AEN1488">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.
and <span class="APPLICATION">Privoxy's</span> privacy enhancing
features at the same time. While your browser probably lacks some
features <span class="APPLICATION">Privoxy</span> offers, it should
- also be able to do some things more reliable, for example restricting
+ also be able to do some things more reliably, for example restricting
and suppressing JavaScript.</p>
</div>
2001-2011 by <a href="http://www.privoxy.org/" target="_top">Privoxy
Developers</a></sub><br></p>
- <p class="PUBDATE">$Id: faq.sgml,v 2.92 2013/03/01 17:44:24 fabiankeil
+ <p class="PUBDATE">$Id: faq.sgml,v 2.100 2014/05/05 09:59:30 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.21. You can find
+ represents the state at the release of version 3.0.22. 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=
change the configuration with a browser? Does that not raise
security issues?</a></dt>
- <dt>3.11. <a href="configuration.html#AEN486">What is the
+ <dt>3.11. <a href="configuration.html#AEN488">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#AEN537">Instead of ads, now
+ <dt>3.13. <a href="configuration.html#AEN539">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#AEN554">Why would anybody
+ <dt>3.14. <a href="configuration.html#AEN556">Why would anybody
want to see a checkerboard pattern?</a></dt>
- <dt>3.15. <a href="configuration.html#AEN560">I see some images
+ <dt>3.15. <a href="configuration.html#AEN562">I see some images
being replaced with text instead of the checkerboard image. Why
and how do I get rid of this?</a></dt>
<dd>
<dl>
- <dt>4.1. <a href="misc.html#AEN735">How much does Privoxy slow my
+ <dt>4.1. <a href="misc.html#AEN737">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
<dt>4.7. <a href="misc.html#IP">How can I hide my IP
address?</a></dt>
- <dt>4.8. <a href="misc.html#AEN800">Can Privoxy guarantee I am
+ <dt>4.8. <a href="misc.html#AEN802">Can Privoxy guarantee I am
anonymous?</a></dt>
- <dt>4.9. <a href="misc.html#AEN818">A test site says I am not
+ <dt>4.9. <a href="misc.html#AEN820">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#AEN874">Might some things break
+ <dt>4.11. <a href="misc.html#AEN876">Might some things break
because header information or content is being altered?</a></dt>
- <dt>4.12. <a href="misc.html#AEN888">Can Privoxy act as a
+ <dt>4.12. <a href="misc.html#AEN890">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#AEN898">What about as a firewall?
+ <dt>4.13. <a href="misc.html#AEN900">What about as a firewall?
Can Privoxy protect me?</a></dt>
- <dt>4.14. <a href="misc.html#AEN903">I have large empty spaces /
+ <dt>4.14. <a href="misc.html#AEN905">I have large empty spaces /
a checkerboard pattern now where ads used to be. Why?</a></dt>
- <dt>4.15. <a href="misc.html#AEN911">How can Privoxy filter
+ <dt>4.15. <a href="misc.html#AEN913">How can Privoxy filter
Secure (HTTPS) URLs?</a></dt>
- <dt>4.16. <a href="misc.html#AEN925">Privoxy runs as a
+ <dt>4.16. <a href="misc.html#AEN927">Privoxy runs as a
<span class="QUOTE">"server"</span>. How secure is it? Do I need
to take any special precautions?</a></dt>
<dd>
<dl>
- <dt>5.1. <a href="trouble.html#AEN1091">I cannot connect to any
+ <dt>5.1. <a href="trouble.html#AEN1093">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#AEN1114">I just added a new rule,
+ <dt>5.3. <a href="trouble.html#AEN1116">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
delays in page loading. I'm using <tt class=
"LITERAL">localhost</tt> as my browser's proxy setting.</a></dt>
- <dt>5.10. <a href="trouble.html#BLANKPAGE">I get a completely
+ <dt>5.10. <a href="trouble.html#MACOSXACCOUNTDELETION">I just
+ upgraded to Mac OS X 10.9 (Mavericks) and now <span class=
+ "APPLICATION">Privoxy</span> has stopped working.</a></dt>
+
+ <dt>5.11. <a href="trouble.html#BLANKPAGE">I get a completely
blank page at one site. <span class="QUOTE">"View Source"</span>
shows only: <span class=
"MARKUP"><html><body></body></html></span>.
Without Privoxy the page loads fine.</a></dt>
- <dt>5.1
1. <a href="trouble.html#NOHOSTNAME">My logs show many
+ <dt>5.1
2. <a href="trouble.html#NOHOSTNAME">My logs show many
<span class="QUOTE">"Unable to get my own hostname"</span> lines.
Why?</a></dt>
- <dt>5.1
2. <a href="trouble.html#INUSE">When I try to launch
+ <dt>5.1
3. <a href="trouble.html#INUSE">When I try to launch
Privoxy, I get an error message <span class="QUOTE">"port 8118 is
already in use"</span> (or similar wording). Why?</a></dt>
- <dt>5.1
3. <a href="trouble.html#DEMORONIZER">Pages with UTF-8
+ <dt>5.1
4. <a href="trouble.html#DEMORONIZER">Pages with UTF-8
fonts are garbled.</a></dt>
- <dt>5.1
4. <a href="trouble.html#DEMORONIZER2">Why are binary
+ <dt>5.1
5. <a href="trouble.html#DEMORONIZER2">Why are binary
files (such as images) corrupted when Privoxy is used?</a></dt>
- <dt>5.1
5. <a href="trouble.html#DEMORONIZER3">What is the
+ <dt>5.1
6. <a href="trouble.html#DEMORONIZER3">What is the
<span class="QUOTE">"demoronizer"</span> and why is it
there?</a></dt>
- <dt>5.1
6. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing
+ <dt>5.1
7. <a href="trouble.html#WINDOWOPEN">Why do I keep seeing
<span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw source
code?</a></dt>
- <dt>5.1
7. <a href="trouble.html#DNSERRORS">I am getting too many
+ <dt>5.1
8. <a href="trouble.html#DNSERRORS">I am getting too many
DNS errors like <span class="QUOTE">"404 No Such Domain"</span>.
Why can't Privoxy do this better?</a></dt>
- <dt>5.1
8. <a href="trouble.html#ALLCPU">At one site Privoxy just
+ <dt>5.1
9. <a href="trouble.html#ALLCPU">At one site Privoxy just
hangs, and starts taking all CPU. Why is this?</a></dt>
- <dt>5.
19. <a href="trouble.html#SLOWCRAWL">I just installed
+ <dt>5.
20. <a href="trouble.html#SLOWCRAWL">I just installed
Privoxy, and all my browsing has slowed to a crawl. What
gives?</a></dt>
- <dt>5.2
0. <a href="trouble.html#PREVENTCOMP">Why do my filters
+ <dt>5.2
1. <a href="trouble.html#PREVENTCOMP">Why do my filters
work on some sites but not on others?</a></dt>
- <dt>5.2
1. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites
+ <dt>5.2
2. <a href="trouble.html#SSL-WARNINGS">On some HTTPS sites
my browser warns me about unauthenticated content, the URL bar
doesn't get highlighted and the lock symbol appears to be broken.
What's going on?</a></dt>
- <dt>5.2
2. <a href="trouble.html#SE-LINUX">I get selinux error
+ <dt>5.2
3. <a href="trouble.html#SE-LINUX">I get selinux error
messages. How can I fix this?</a></dt>
- <dt>5.2
3. <a href="trouble.html#GENTOO-RICERS">I compiled
+ <dt>5.2
4. <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>
</dl>
<dd>
<dl>
- <dt>7.1. <a href="copyright.html#AEN1470">License</a></dt>
+ <dt>7.1. <a href="copyright.html#AEN1479">License</a></dt>
- <dt>7.2. <a href="copyright.html#AEN1479">History</a></dt>
+ <dt>7.2. <a href="copyright.html#AEN1488">History</a></dt>
</dl>
</dd>
</dl>
<h1 class="SECT1"><a name="MISC" id="MISC">4. Miscellaneous</a></h1>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN735" id="AEN735">4.1. How much does
+ <h3 class="SECT2"><a name="AEN737" id="AEN737">4.1. How much does
Privoxy slow my browsing down? This has to add extra time to
browsing.</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN800" id="AEN800">4.8. Can Privoxy
+ <h3 class="SECT2"><a name="AEN802" id="AEN802">4.8. Can Privoxy
guarantee I am anonymous?</a></h3>
<p>No. Your chances of remaining anonymous are improved, but unless you
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN818" id="AEN818">4.9. A test site says I
+ <h3 class="SECT2"><a name="AEN820" id="AEN820">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
your local network. Using socks4a would work too, but with socks5 you
get more precise error messages.</p>
- <p>
Since <span class="APPLICATION">Privoxy</span> 3.0.5, its <a href=
+ <p>
<span class="APPLICATION">Privoxy's</span> <a href=
"../user-manual/config.html" target="_top">main configuration file</a>
is already prepared for <span class="APPLICATION">Tor</span>, if you
are using a default <span class="APPLICATION">Tor</span> configuration
<tr>
<td>
<pre class="SCREEN">
-# forward-socks5 / 127.0.0.1:9050 .
+# forward-socks5t / 127.0.0.1:9050 .
</pre>
</td>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN874" id="AEN874">4.11. Might some things
+ <h3 class="SECT2"><a name="AEN876" id="AEN876">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
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN888" id="AEN888">4.12. Can Privoxy act as
+ <h3 class="SECT2"><a name="AEN890" id="AEN890">4.12. Can Privoxy act as
a <span class="QUOTE">"caching"</span> proxy to speed up web
browsing?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN898" id="AEN898">4.13. What about as a
+ <h3 class="SECT2"><a name="AEN900" id="AEN900">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
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN903" id="AEN903">4.14. I have large empty
+ <h3 class="SECT2"><a name="AEN905" id="AEN905">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
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN911" id="AEN911">4.15. How can Privoxy
+ <h3 class="SECT2"><a name="AEN913" id="AEN913">4.15. How can Privoxy
filter Secure (HTTPS) URLs?</a></h3>
<p>Since secure HTTP connections are encrypted SSL sessions between
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN925" id="AEN925">4.16. Privoxy runs as a
+ <h3 class="SECT2"><a name="AEN927" id="AEN927">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>
Troubleshooting</a></h1>
<div class="SECT2">
- <h3 class="SECT2"><a name="AEN1091" id="AEN1091">5.1. I cannot connect
+ <h3 class="SECT2"><a name="AEN1093" id="AEN1093">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="AEN1114" id="AEN1114">5.3. I just added a
+ <h3 class="SECT2"><a name="AEN1116" id="AEN1116">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
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.10. I get a
+ <h3 class="SECT2"><a name="MACOSXACCOUNTDELETION" id=
+ "MACOSXACCOUNTDELETION">5.10. I just upgraded to Mac OS X 10.9
+ (Mavericks) and now <span class="APPLICATION">Privoxy</span> has
+ stopped working.</a></h3>
+
+ <p>The upgrade process to Mac OS X Mavericks (10.9) from an earlier
+ version of OS X deletes all user accounts that are either not part of
+ OS X itself or are not interactive user accounts (ones you log in
+ with). Since, for the sake of security, <span class=
+ "APPLICATION">Privoxy</span> runs as a non-privileged user that is
+ created by its installer (_privoxy), it can no longer start up once
+ that account gets deleted. The solution is to perform a complete
+ uninstall using the supplied <span class=
+ "APPLICATION">uninstall.command</span> script (either back up your
+ configuration files or select to not have the uninstaller remove them
+ when it prompts you) and then reinstall <span class=
+ "APPLICATION">Privoxy</span> using the installer package and merge in
+ your configuration.</p>
+ </div>
+
+ <div class="SECT2">
+ <h3 class="SECT2"><a name="BLANKPAGE" id="BLANKPAGE">5.11. I get a
completely blank page at one site. <span class="QUOTE">"View
Source"</span> shows only: <span class=
"MARKUP"><html><body></body></html></span>.
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.11. My logs
+ <h3 class="SECT2"><a name="NOHOSTNAME" id="NOHOSTNAME">5.12. My logs
show many <span class="QUOTE">"Unable to get my own hostname"</span>
lines. Why?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="INUSE" id="INUSE">5.12. When I try to launch
+ <h3 class="SECT2"><a name="INUSE" id="INUSE">5.13. When I try to launch
Privoxy, I get an error message <span class="QUOTE">"port 8118 is
already in use"</span> (or similar wording). Why?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.13. Pages
+ <h3 class="SECT2"><a name="DEMORONIZER" id="DEMORONIZER">5.14. Pages
with UTF-8 fonts are garbled.</a></h3>
- <p>This is caused by the <span class="QUOTE">"demoronizer"</span>
- filter. You should either upgrade <span class=
- "APPLICATION">Privoxy</span>, or at least upgrade to the most recent
- <tt class="FILENAME">default.action</tt> file available from <a href=
+ <p>This may be the result of an overly aggressive filter. The filters
+ that are enabled in the default configuration aren't expected to cause
+ problems like this. If you enabled the <span class=
+ "QUOTE">"demoronizer"</span> filter, please try temporarily disabling
+ it.</p>
+
+ <p>If that doesn't help, temporarily disable all filters to see if
+ another filter could be the culprit. If the problem disappears, enable
+ the filters one by one, until the problem reappears and the offending
+ filter is found.</p>
+
+ <p>Once the problem-causing filter is known, it can be fixed or
+ disabled.</p>
+
+ <p>Upgrading <span class="APPLICATION">Privoxy</span>, or going to the
+ most recent <tt class="FILENAME">default.action</tt> file available
+ from <a href=
"http://sourceforge.net/project/showfiles.php?group_id=11118" target=
- "_top">SourceForge</a>. Or you can simply disable the demoronizer
- filter.</p>
+ "_top">SourceForge</a> might be worth a try, too.</p>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.14. Why
+ <h3 class="SECT2"><a name="DEMORONIZER2" id="DEMORONIZER2">5.15. Why
are binary files (such as images) corrupted when Privoxy is
used?</a></h3>
- <p>This may also be caused by the <span class=
- "QUOTE">"demoronizer"</span> filter, in conjunction with a web server
- that is misreporting the content type. Binary files are exempted from
- <span class="APPLICATION">Privoxy's</span> filtering (unless the web
- server by mistake says the file is something else). Either upgrade
- <span class="APPLICATION">Privoxy</span>, or go to the most recent
- <tt class="FILENAME">default.action</tt> file available from <a href=
- "http://sourceforge.net/project/showfiles.php?group_id=11118" target=
- "_top">SourceForge</a>.</p>
+ <p>This may also be caused by an (<a href=
+ "trouble.html#DEMORONIZER">overly aggressive filter</a> in conjunction
+ with a web server that is misreporting the content type. By default
+ binary files are exempted from <span class=
+ "APPLICATION">Privoxy's</span> filtering (unless the web server by
+ mistake says the file is something else).</p>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.15. What
+ <h3 class="SECT2"><a name="DEMORONIZER3" id="DEMORONIZER3">5.16. What
is the <span class="QUOTE">"demoronizer"</span> and why is it
there?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.16. Why do I
+ <h3 class="SECT2"><a name="WINDOWOPEN" id="WINDOWOPEN">5.17. Why do I
keep seeing <span class="QUOTE">"PrivoxyWindowOpen()"</span> in raw
source code?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.17. I am getting
+ <h3 class="SECT2"><a name="DNSERRORS" id="DNSERRORS">5.18. I am getting
too many DNS errors like <span class="QUOTE">"404 No Such
Domain"</span>. Why can't Privoxy do this better?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.18. At one site
+ <h3 class="SECT2"><a name="ALLCPU" id="ALLCPU">5.19. At one site
Privoxy just hangs, and starts taking all CPU. Why is this?</a></h3>
<p>This is probably a manifestation of the <span class="QUOTE">"100%
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.19. I just
+ <h3 class="SECT2"><a name="SLOWCRAWL" id="SLOWCRAWL">5.20. I just
installed Privoxy, and all my browsing has slowed to a crawl. What
gives?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.20. Why do
+ <h3 class="SECT2"><a name="PREVENTCOMP" id="PREVENTCOMP">5.21. Why do
my filters work on some sites but not on others?</a></h3>
<p>It's probably due to compression. It is a common practice for web
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.21. On
+ <h3 class="SECT2"><a name="SSL-WARNINGS" id="SSL-WARNINGS">5.22. On
some HTTPS sites my browser warns me about unauthenticated content, the
URL bar doesn't get highlighted and the lock symbol appears to be
broken. What's going on?</a></h3>
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.22. I get selinux
+ <h3 class="SECT2"><a name="SE-LINUX" id="SE-LINUX">5.23. I get selinux
error messages. How can I fix this?</a></h3>
<p>Please report the problem to the creator of your selinux
</div>
<div class="SECT2">
- <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.23. I
+ <h3 class="SECT2"><a name="GENTOO-RICERS" id="GENTOO-RICERS">5.24. I
compiled <span class="APPLICATION">Privoxy</span> with Gentoo's portage
and it appears to be very slow. Why?</a></h3>
</ul>
<p>The most recent release is <a href="announce.txt" target=
- "_top">3.0.21 (stable)</a>.</p>
+ "_top">3.0.22 (UNRELEASED)</a>.</p>
</div>
</div>
<hr>
<h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy - The Privacy
Enhancing Proxy</a></h1>
- <h2 class="SUBTITLE">Project Index Page v3.0.21</h2>
+ <h2 class="SUBTITLE">Project Index Page v3.0.22</h2>
<div>
<div class="ABSTRACT">
<title>Actions Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
in <tt class="FILENAME">default.action</tt> are:</p>
<div class="TABLE">
- <a name="AEN2858" id="AEN2858"></a>
+ <a name="AEN2863" id="AEN2863"></a>
<p><b>Table 1. Default Configurations</b></p>
actions</a>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN2957" id="AEN2957">8.1. Finding the Right
+ <h2 class="SECT2"><a name="AEN2962" id="AEN2962">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="AEN2964" id="AEN2964">8.2. How to
+ <h2 class="SECT2"><a name="AEN2969" id="AEN2969">8.2. How to
Edit</a></h2>
<p>The easiest way to edit the actions files is with a browser by using
and potentially match against many similar patterns.</p>
<p>Generally, an URL pattern has the form <tt class=
- "LITERAL"><domain><port>/<path></tt>, where the
- <tt class="LITERAL"><domain></tt>, the <tt class=
+ "LITERAL"><host><port>/<path></tt>, where the
+ <tt class="LITERAL"><host></tt>, the <tt class=
"LITERAL"><port></tt> and the <tt class=
"LITERAL"><path></tt> are optional. (This is why the special
<tt class="LITERAL">/</tt> pattern matches all URLs). Note that the
"EMPHASIS">not</i></span> be included in the pattern. This is assumed
already!</p>
- <p>The pattern matching syntax is different for the domain and path
- parts of the URL. The domain part uses a simple globbing type matching
+ <p>The pattern matching syntax is different for the host and path parts
+ of the URL. The host part uses a simple globbing type matching
technique, while the path part uses more flexible <a href=
"http://en.wikipedia.org/wiki/Regular_expressions" target=
"_top"><span class="QUOTE">"Regular Expressions"</span></a> (POSIX
1003.2).</p>
<p>The port part of a pattern is a decimal port number preceded by a
- colon (<tt class="LITERAL">:</tt>). If the domain part contains a
+ colon (<tt class="LITERAL">:</tt>). If the host part contains a
numerical IPv6 address, it has to be put into angle brackets
(<tt class="LITERAL"><</tt>, <tt class="LITERAL">></tt>).</p>
<dt><tt class="LITERAL">www.example.com/</tt></dt>
<dd>
- <p>is a domain-only pattern and will match any request to
+ <p>is a host-only pattern and will match any request to
<tt class="LITERAL">www.example.com</tt>, regardless of which
document on that server is requested. So ALL pages in this domain
would be covered by the scope of this action. Note that a simple
<dt><tt class="LITERAL">www.example.com</tt></dt>
<dd>
- <p>means exactly the same. For domain-only patterns, the trailing
+ <p>means exactly the same. For host-only patterns, the trailing
<tt class="LITERAL">/</tt> may be omitted.</p>
</dd>
<p>Matches any URL pointing to TCP port 8000.</p>
</dd>
+ <dt><tt class="LITERAL">10.0.0.1/</tt></dt>
+
+ <dd>
+ <p>Matches any URL with the host address <tt class=
+ "LITERAL">10.0.0.1</tt>. (Note that the real URL uses plain
+ brackets, not angle brackets.)</p>
+ </dd>
+
<dt><tt class="LITERAL"><2001:db8::1>/</tt></dt>
<dd>
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN3076" id="AEN3076">8.4.1. The Domain
- Pattern</a></h3>
+ <h3 class="SECT3"><a name="HOST-PATTERN" id="HOST-PATTERN">8.4.1. The
+ Host Pattern</a></h3>
- <p>The matching of the domain part offers some flexible options: if
- the domain starts or ends with a dot, it becomes unanchored at that
- end. For example:</p>
+ <p>The matching of the host part offers some flexible options: if the
+ host pattern starts or ends with a dot, it becomes unanchored at that
+ end. The host pattern is often referred to as domain pattern as it is
+ usually used to match domain names and not IP addresses. For
+ example:</p>
<div class="VARIABLELIST">
<dl>
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN3152" id="AEN3152">8.4.2. The Path
+ <h3 class="SECT3"><a name="AEN3163" id="AEN3163">8.4.2. The Path
Pattern</a></h3>
<p><span class="APPLICATION">Privoxy</span> uses <span class=
indirection is seldom needed anyway and even the example doesn't make
too much sense.</p>
</div>
+
+ <div class="SECT3">
+ <h3 class="SECT3"><a name="NEGATIVE-TAG-PATTERNS" id=
+ "NEGATIVE-TAG-PATTERNS">8.4.4. The Negative Tag Patterns</a></h3>
+
+ <p>To match requests that do not have a certain tag, specify a
+ negative tag pattern by prefixing the tag pattern line with either
+ <span class="QUOTE">"NO-REQUEST-TAG:"</span> or <span class=
+ "QUOTE">"NO-RESPONSE-TAG:"</span> instead of <span class=
+ "QUOTE">"TAG:"</span>.</p>
+
+ <p>Negative tag patterns created with <span class=
+ "QUOTE">"NO-REQUEST-TAG:"</span> are checked after all client headers
+ are scanned, the ones created with <span class=
+ "QUOTE">"NO-RESPONSE-TAG:"</span> are checked after all server
+ headers are scanned. In both cases all the created tags are
+ considered.</p>
+ </div>
</div>
<div class="SECT2">
</div>
<div class="SECT3">
- <h3 class="SECT3"><a name="AEN4827" id="AEN4827">8.5.35.
+ <h3 class="SECT3"><a name="AEN4847" id="AEN4847">8.5.35.
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="AEN4891" id="AEN4891">8.7.1.
+ <h3 class="SECT3"><a name="AEN4911" id="AEN4911">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="AEN4913" id="AEN4913">8.7.2.
+ <h3 class="SECT3"><a name="AEN4933" id="AEN4933">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="AEN5026" id="AEN5026">8.7.3.
+ <h3 class="SECT3"><a name="AEN5046" id="AEN5046">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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5902" id="AEN5902">14.2. Privoxy's
+ <h2 class="SECT2"><a name="AEN5929" id="AEN5929">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="AEN5916" id="AEN5916"></a>
+ <p>Privoxy main page:</p><a name="AEN5943" id="AEN5943"></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="AEN5924" id=
- "AEN5924"></a>
+ viewing and editing of actions files:</p><a name="AEN5951" id=
+ "AEN5951"></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="AEN5929" id=
- "AEN5929"></a>
+ <p>Show the source code version numbers:</p><a name="AEN5956" id=
+ "AEN5956"></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="AEN5934" id=
- "AEN5934"></a>
+ <p>Show the browser's request headers:</p><a name="AEN5961" id=
+ "AEN5961"></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="AEN5939"
- id="AEN5939"></a>
+ <p>Show which actions apply to a URL and why:</p><a name="AEN5966"
+ id="AEN5966"></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=
- "AEN5947" id="AEN5947"></a>
+ "AEN5974" id="AEN5974"></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="AEN5951" id=
- "AEN5951"></a>
+ <p>Short cuts. Turn off, then on:</p><a name="AEN5978" id=
+ "AEN5978"></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="AEN5954" id="AEN5954"></a>
+ </blockquote><a name="AEN5981" id="AEN5981"></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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
<tr>
<td>
<pre class="SCREEN">
- forward-socks5 / 127.0.0.1:9050 .
+ forward-socks5t / 127.0.0.1:9050 .
</pre>
</td>
</tr>
HTTP connections into <span class=
"APPLICATION">Privoxy</span>.</p>
+ <p>Note that intercepting encrypted connections (HTTPS) isn't
+ supported.</p>
+
<p>Make sure that <span class="APPLICATION">Privoxy's</span>
own requests aren't redirected as well. Additionally take care
that <span class="APPLICATION">Privoxy</span> can't
<title>Privoxy Configuration</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
controlled easily with a web browser.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN1078" id="AEN1078">6.1. Controlling
+ <h2 class="SECT2"><a name="AEN1080" id="AEN1080">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="AEN1086" id=
- "AEN1086"></a> Privoxy Menu</h2>
+ <h2 class="BRIDGEHEAD"><a name="AEN1088" id=
+ "AEN1088"></a> Privoxy Menu</h2>
<pre>
</pre>
<tr>
<td>
- ▪ <a href="http://www.privoxy.org/3.0.21/user-manual/"
+ ▪ <a href="http://www.privoxy.org/3.0.22/user-manual/"
target="_top">Documentation</a></td>
</tr>
</tbody>
<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,
"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>
Requests</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
<li>
<p><span class="QUOTE">"Bugs"</span> in the programming code that
makes up <span class="APPLICATION">Privoxy</span>, such as that
- might cause a crash.</p>
+ might cause a crash. Documentation issues, for example spelling
+ errors and unclear descriptions, are bugs, too.</p>
</li>
</ul>
<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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
provided patches, made suggestions or contributed in some way. These
include (in alphabetical order):</p>
- <p class="LITERALLAYOUT"> Ken Arromdee<br>
+ <p class="LITERALLAYOUT"> Anatoly Arzhnikov<br>
+ Ken Arromdee<br>
Natxo Asenjo<br>
Devin Bayer<br>
Havard Berland<br>
Spinor S.<br>
Peter Thoenen<br>
Martin Thomas<br>
+ Reuben Thomas<br>
Bobby G. Vinyard<br>
Jochen Voss<br>
+ David Wagner<br>
Glenn Washburn<br>
Song Weijia<br>
Jörg Weinmann<br>
<title>Filter Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
"_top">Perl</a>'s <tt class="LITERAL">s///</tt> operator. If you are
familiar with Perl, you will find this to be quite intuitive, and may
want to look at the PCRS documentation for the subtle differences to Perl
- behaviour. Most notably, the non-standard option letter <tt class=
+ behaviour.</p>
+
+ <p>Most notably, the non-standard option letter <tt class=
"LITERAL">U</tt> is supported, which turns the default to ungreedy
- matching.</p>
+ matching (add <tt class="LITERAL">?</tt> to quantifiers to turn them
+ greedy again).</p>
+
+ <p>The non-standard option letter <tt class="LITERAL">D</tt> (dynamic)
+ allows to use the variables $host, $origin (the IP address the request
+ came from), $path and $url. They will be replaced with the value they
+ refer to before the filter is executed.</p>
+
+ <p>Note that '$' is a bad choice for a delimiter in a dynamic filter as
+ you might end up with unintended variables if you use a variable name
+ directly after the delimiter. Variables will be resolved without escaping
+ anything, therefore you also have to be careful not to chose delimiters
+ that appear in the replacement text. For example '<' should be save,
+ while '?' will sooner or later cause conflicts with $url.</p>
+
+ <p>The non-standard option letter <tt class="LITERAL">T</tt> (trivial)
+ prevents parsing for backreferences in the substitute. Use it if you want
+ to include text like '$&' in your substitute without quoting.</p>
<p>If you are new to <a href=
"http://en.wikipedia.org/wiki/Regular_expressions" target=
started.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="AEN5181" id="AEN5181">9.1. Filter File
+ <h2 class="SECT2"><a name="AEN5208" id="AEN5208">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.21 User Manual</title>
+ <title>Privoxy 3.0.22 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.21 User
+ <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.22 User
Manual</a></h1>
<p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> ©
2001-2013 by <a href="http://www.privoxy.org/" target="_top">Privoxy
Developers</a></sub><br></p>
- <p class="PUBDATE">$Id: user-manual.sgml,v 2.175 2013/03/20 11:30:28
+ <p class="PUBDATE">$Id: user-manual.sgml,v 2.182 2014/05/05 10:08:43
fabiankeil Exp $<br></p>
<div>
<dd>
<dl>
- <dt>6.1. <a href="configuration.html#AEN1078">Controlling Privoxy
+ <dt>6.1. <a href="configuration.html#AEN1080">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#AEN2957">Finding the Right
+ <dt>8.1. <a href="actions-file.html#AEN2962">Finding the Right
Mix</a></dt>
- <dt>8.2. <a href="actions-file.html#AEN2964">How to Edit</a></dt>
+ <dt>8.2. <a href="actions-file.html#AEN2969">How to Edit</a></dt>
<dt>8.3. <a href="actions-file.html#ACTIONS-APPLY">How Actions
are Applied to Requests</a></dt>
<dd>
<dl>
- <dt>8.4.1. <a href="actions-file.html#AEN3076">The Domain
+ <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#AEN3152">The Path
+ <dt>8.4.2. <a href="actions-file.html#AEN3163">The Path
Pattern</a></dt>
<dt>8.4.3. <a href="actions-file.html#TAG-PATTERN">The Tag
Pattern</a></dt>
+
+ <dt>8.4.4. <a href=
+ "actions-file.html#NEGATIVE-TAG-PATTERNS">The Negative Tag
+ Patterns</a></dt>
</dl>
</dd>
"actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
<dt>8.5.35. <a href=
- "actions-file.html#AEN4827">Summary</a></dt>
+ "actions-file.html#AEN4847">Summary</a></dt>
</dl>
</dd>
<dd>
<dl>
<dt>8.7.1. <a href=
- "actions-file.html#AEN4891">match-all.action</a></dt>
+ "actions-file.html#AEN4911">match-all.action</a></dt>
<dt>8.7.2. <a href=
- "actions-file.html#AEN4913">default.action</a></dt>
+ "actions-file.html#AEN4933">default.action</a></dt>
<dt>8.7.3. <a href=
- "actions-file.html#AEN5026">user.action</a></dt>
+ "actions-file.html#AEN5046">user.action</a></dt>
</dl>
</dd>
</dl>
<dd>
<dl>
- <dt>9.1. <a href="filter-file.html#AEN5181">Filter File
+ <dt>9.1. <a href="filter-file.html#AEN5208">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#AEN5902">Privoxy's Internal
+ <dt>14.2. <a href="appendix.html#AEN5929">Privoxy's Internal
Pages</a></dt>
<dd>
<title>Installation</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
<tr>
<td>
<pre class="SCREEN">
- tar xzvf privoxy-3.0.21-stable-src.tar.gz
- cd privoxy-3.0.21-stable
+ tar xzvf privoxy-3.0.22-beta-src.tar.gz
+ cd privoxy-3.0.22-beta
</pre>
</td>
</tr>
<title>Introduction</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
- <link rel="PREVIOUS" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 User Manual" href="index.html">
+ <link rel="PREVIOUS" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
<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.21.</p>
+ <p>This documentation is included with the current UNRELEASED version of
+ <span class="APPLICATION">Privoxy</span>, 3.0.22, 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.
<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>
</tr>
<tr>
- <td width="33%" align="left" valign="top">Privoxy 3.0.21 User
+ <td width="33%" align="left" valign="top">Privoxy 3.0.22 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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
"GUIBUTTON">Edit</span>"</span>:</p>
<div class="FIGURE">
- <a name="AEN854" id="AEN854"></a>
+ <a name="AEN856" id="AEN856"></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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
protocols.</p>
<div class="FIGURE">
- <a name="AEN909" id="AEN909"></a>
+ <a name="AEN911" id="AEN911"></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="AEN954" id="AEN954"></a>
+ <a name="AEN956" id="AEN956"></a>
<p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
HTTPS (Secure) Settings</b></p>
<p><span class="emphasis"><i class="EMPHASIS">--pre-chroot-nslookup
hostname</i></span></p>
- <p>Specifies a hostname to look up before doing a chroot. On some
- systems, initializing the resolver library involves reading config
- files from /etc and/or loading additional shared libraries from
- /lib. On these systems, doing a hostname lookup before the chroot
- reduces the number of files that must be copied into the chroot
- tree.</p>
+ <p>Specifies a hostname (for example www.privoxy.org) to look up
+ before doing a chroot. On some systems, initializing the resolver
+ library involves reading config files from /etc and/or loading
+ additional shared libraries from /lib. On these systems, doing a
+ hostname lookup before the chroot reduces the number of files that
+ must be copied into the chroot tree.</p>
<p>For fastest startup speed, a good value is a hostname that is
not in /etc/hosts but that your local name server (listed in
<title>Privoxy's Template Files</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 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.21 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.22 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.21 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.22 User Manual</th>
</tr>
<tr>
projects / privoxy.git / commitdiff