"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
- <title>Privoxy 3.0.27 User Manual</title>
+ <title>Privoxy 3.0.35 User Manual</title>
<meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.79">
<link rel="NEXT" title="Introduction" href="introduction.html">
<link rel="STYLESHEET" type="text/css" href="../p_doc.css">
<body class="ARTICLE" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="ARTICLE">
<div class="TITLEPAGE">
- <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.27 User Manual</a></h1>
- <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © 2001-20
18 by <a href=
+ <h1 class="TITLE"><a name="AEN2" id="AEN2">Privoxy 3.0.35 User Manual</a></h1>
+ <p class="PUBDATE"><sub><a href="copyright.html">Copyright</a> © 2001-20
23 by <a href=
"https://www.privoxy.org/" target="_top">Privoxy Developers</a></sub><br></p>
<div>
<div class="ABSTRACT">
web page data and HTTP headers, controlling access, and removing ads and other obnoxious Internet junk.
Privoxy has a flexible configuration and can be customized to suit individual needs and tastes. It has
application for both stand-alone systems and multi-user networks.</p>
- <p>Privoxy is Free Software and licensed under the GNU GPLv2.</p>
+ <p>Privoxy is Free Software and licensed under the GNU GPLv2 or later.</p>
<p>Privoxy is an associated project of Software in the Public Interest (SPI).</p>
<p>Helping hands and donations are welcome:</p>
<ul>
<li>
- <p><a href="https://www.privoxy.org/faq/general.html#PARTICIPATE" target=
- "_top">https://www.privoxy.org/faq/general.html#PARTICIPATE</a></p>
+ <p><a href="https://www.privoxy.org/participate" target=
+ "_top">https://www.privoxy.org/participate</a></p>
</li>
<li>
- <p><a href="https://www.privoxy.org/faq/general.html#DONATE" target=
- "_top">https://www.privoxy.org/faq/general.html#DONATE</a></p>
+ <p><a href="https://www.privoxy.org/donate" target="_top">https://www.privoxy.org/donate</a></p>
</li>
</ul>
<p>You can find the latest version of the <i class="CITETITLE">Privoxy User Manual</i> at <a href=
<dl>
<dt>2.1.1. <a href="installation.html#INSTALLATION-DEB">Debian and Ubuntu</a></dt>
<dt>2.1.2. <a href="installation.html#INSTALLATION-PACK-WIN">Windows</a></dt>
- <dt>2.1.3. <a href="installation.html#INSTALLATION-OS2">OS/2</a></dt>
- <dt>2.1.4. <a href="installation.html#INSTALLATION-MAC">Mac OS X</a></dt>
- <dt>2.1.5. <a href="installation.html#OS-X-INSTALL-FROM-PACKAGE">Installation from ready-built
+ <dt>2.1.3. <a href="installation.html#INSTALLATION-MAC">Mac OS X</a></dt>
+ <dt>2.1.4. <a href="installation.html#OS-X-INSTALL-FROM-PACKAGE">Installation from ready-built
package</a></dt>
- <dt>2.1.
6. <a href="installation.html#OS-X-INSTALL-FROM-SOURCE">Installation from source</a></dt>
- <dt>2.1.7. <a href="installation.html#INSTALLATION-FREEBSD">FreeBSD</a></dt>
+ <dt>2.1.
5. <a href="installation.html#OS-X-INSTALL-FROM-SOURCE">Installation from source</a></dt>
+ <dt>2.1.6. <a href="installation.html#INSTALLATION-FREEBSD">FreeBSD and ElectroBSD</a></dt>
</dl>
</dd>
<dt>2.2. <a href="installation.html#INSTALLATION-SOURCE">Building from Source</a></dt>
<dt>5.3. <a href="startup.html#START-WINDOWS">Windows</a></dt>
<dt>5.4. <a href="startup.html#START-UNICES">Generic instructions for Unix derivates (Solaris, NetBSD,
HP-UX etc.)</a></dt>
- <dt>5.5. <a href="startup.html#START-OS2">OS/2</a></dt>
- <dt>5.6. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
- <dt>5.7. <a href="startup.html#CMDOPTIONS">Command Line Options</a></dt>
+ <dt>5.5. <a href="startup.html#START-MACOSX">Mac OS X</a></dt>
+ <dt>5.6. <a href="startup.html#CMDOPTIONS">Command Line Options</a></dt>
</dl>
</dd>
<dt>6. <a href="configuration.html">Privoxy Configuration</a></dt>
<dt>7.4.9. <a href=
"config.html#ENABLE-PROXY-AUTHENTICATION-FORWARDING">enable-proxy-authentication-forwarding</a></dt>
<dt>7.4.10. <a href="config.html#TRUSTED-CGI-REFERER">trusted-cgi-referer</a></dt>
+ <dt>7.4.11. <a href="config.html#CORS-ALLOWED-ORIGIN">cors-allowed-origin</a></dt>
</dl>
</dd>
<dt>7.5. <a href="config.html#FORWARDING">Forwarding</a></dt>
<dt>7.6.19. <a href="config.html#RECEIVE-BUFFER-SIZE">receive-buffer-size</a></dt>
</dl>
</dd>
- <dt>7.7. <a href="config.html#WINDOWS-GUI">Windows GUI Options</a></dt>
+ <dt>7.7. <a href="config.html#HTTPS-INSPECTION-DIRECTIVES">HTTPS Inspection</a></dt>
+ <dd>
+ <dl>
+ <dt>7.7.1. <a href="config.html#CA-DIRECTORY">ca-directory</a></dt>
+ <dt>7.7.2. <a href="config.html#CA-CERT-FILE">ca-cert-file</a></dt>
+ <dt>7.7.3. <a href="config.html#CA-KEY-FILE">ca-key-file</a></dt>
+ <dt>7.7.4. <a href="config.html#CA-PASSWORD">ca-password</a></dt>
+ <dt>7.7.5. <a href="config.html#CERTIFICATE-DIRECTORY">certificate-directory</a></dt>
+ <dt>7.7.6. <a href="config.html#CIPHER-LIST">cipher-list</a></dt>
+ <dt>7.7.7. <a href="config.html#TRUSTED-CAS-FILE">trusted-cas-file</a></dt>
+ </dl>
+ </dd>
+ <dt>7.8. <a href="config.html#WINDOWS-GUI">Windows GUI Options</a></dt>
</dl>
</dd>
<dt>8. <a href="actions-file.html">Actions Files</a></dt>
<dt>8.5.2. <a href="actions-file.html#BLOCK">block</a></dt>
<dt>8.5.3. <a href="actions-file.html#CHANGE-X-FORWARDED-FOR">change-x-forwarded-for</a></dt>
<dt>8.5.4. <a href="actions-file.html#CLIENT-HEADER-FILTER">client-header-filter</a></dt>
- <dt>8.5.5. <a href="actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt>
- <dt>8.5.6. <a href="actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt>
- <dt>8.5.7. <a href="actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt>
- <dt>8.5.8. <a href="actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt>
- <dt>8.5.9. <a href="actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt>
- <dt>8.5.10. <a href="actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt>
- <dt>8.5.11. <a href="actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt>
- <dt>8.5.12. <a href="actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt>
- <dt>8.5.13. <a href="actions-file.html#DELAY-RESPONSE">delay-response</a></dt>
- <dt>8.5.14. <a href="actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt>
- <dt>8.5.15. <a href="actions-file.html#EXTERNAL-FILTER">external-filter</a></dt>
- <dt>8.5.16. <a href="actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt>
- <dt>8.5.17. <a href="actions-file.html#FILTER">filter</a></dt>
- <dt>8.5.18. <a href="actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt>
- <dt>8.5.19. <a href="actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt>
- <dt>8.5.20. <a href="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt>
- <dt>8.5.21. <a href="actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt>
- <dt>8.5.22. <a href="actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt>
- <dt>8.5.23. <a href="actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt>
- <dt>8.5.24. <a href="actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt>
- <dt>8.5.25. <a href="actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt>
- <dt>8.5.26. <a href="actions-file.html#HIDE-REFERRER">hide-referrer</a></dt>
- <dt>8.5.27. <a href="actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt>
- <dt>8.5.28. <a href="actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>
- <dt>8.5.29. <a href="actions-file.html#LIMIT-COOKIE-LIFETIME">limit-cookie-lifetime</a></dt>
- <dt>8.5.30. <a href="actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
- <dt>8.5.31. <a href="actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
- <dt>8.5.32. <a href="actions-file.html#REDIRECT">redirect</a></dt>
- <dt>8.5.33. <a href="actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
- <dt>8.5.34. <a href="actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
- <dt>8.5.35. <a href="actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
- <dt>8.5.36. <a href="actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
- <dt>8.5.37. <a href="actions-file.html#SUMMARY">Summary</a></dt>
+ <dt>8.5.5. <a href="actions-file.html#CLIENT-BODY-FILTER">client-body-filter</a></dt>
+ <dt>8.5.6. <a href="actions-file.html#CLIENT-BODY-TAGGER">client-body-tagger</a></dt>
+ <dt>8.5.7. <a href="actions-file.html#CLIENT-HEADER-TAGGER">client-header-tagger</a></dt>
+ <dt>8.5.8. <a href="actions-file.html#CONTENT-TYPE-OVERWRITE">content-type-overwrite</a></dt>
+ <dt>8.5.9. <a href="actions-file.html#CRUNCH-CLIENT-HEADER">crunch-client-header</a></dt>
+ <dt>8.5.10. <a href="actions-file.html#CRUNCH-IF-NONE-MATCH">crunch-if-none-match</a></dt>
+ <dt>8.5.11. <a href="actions-file.html#CRUNCH-INCOMING-COOKIES">crunch-incoming-cookies</a></dt>
+ <dt>8.5.12. <a href="actions-file.html#CRUNCH-SERVER-HEADER">crunch-server-header</a></dt>
+ <dt>8.5.13. <a href="actions-file.html#CRUNCH-OUTGOING-COOKIES">crunch-outgoing-cookies</a></dt>
+ <dt>8.5.14. <a href="actions-file.html#DEANIMATE-GIFS">deanimate-gifs</a></dt>
+ <dt>8.5.15. <a href="actions-file.html#DELAY-RESPONSE">delay-response</a></dt>
+ <dt>8.5.16. <a href="actions-file.html#DOWNGRADE-HTTP-VERSION">downgrade-http-version</a></dt>
+ <dt>8.5.17. <a href="actions-file.html#EXTERNAL-FILTER">external-filter</a></dt>
+ <dt>8.5.18. <a href="actions-file.html#FAST-REDIRECTS">fast-redirects</a></dt>
+ <dt>8.5.19. <a href="actions-file.html#FILTER">filter</a></dt>
+ <dt>8.5.20. <a href="actions-file.html#FORCE-TEXT-MODE">force-text-mode</a></dt>
+ <dt>8.5.21. <a href="actions-file.html#FORWARD-OVERRIDE">forward-override</a></dt>
+ <dt>8.5.22. <a href="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT">handle-as-empty-document</a></dt>
+ <dt>8.5.23. <a href="actions-file.html#HANDLE-AS-IMAGE">handle-as-image</a></dt>
+ <dt>8.5.24. <a href="actions-file.html#HIDE-ACCEPT-LANGUAGE">hide-accept-language</a></dt>
+ <dt>8.5.25. <a href="actions-file.html#HIDE-CONTENT-DISPOSITION">hide-content-disposition</a></dt>
+ <dt>8.5.26. <a href="actions-file.html#HIDE-IF-MODIFIED-SINCE">hide-if-modified-since</a></dt>
+ <dt>8.5.27. <a href="actions-file.html#HIDE-FROM-HEADER">hide-from-header</a></dt>
+ <dt>8.5.28. <a href="actions-file.html#HIDE-REFERRER">hide-referrer</a></dt>
+ <dt>8.5.29. <a href="actions-file.html#HIDE-USER-AGENT">hide-user-agent</a></dt>
+ <dt>8.5.30. <a href="actions-file.html#HTTPS-INSPECTION">https-inspection</a></dt>
+ <dt>8.5.31. <a href="actions-file.html#IGNORE-CERTIFICATE-ERRORS">ignore-certificate-errors</a></dt>
+ <dt>8.5.32. <a href="actions-file.html#LIMIT-CONNECT">limit-connect</a></dt>
+ <dt>8.5.33. <a href="actions-file.html#LIMIT-COOKIE-LIFETIME">limit-cookie-lifetime</a></dt>
+ <dt>8.5.34. <a href="actions-file.html#PREVENT-COMPRESSION">prevent-compression</a></dt>
+ <dt>8.5.35. <a href="actions-file.html#OVERWRITE-LAST-MODIFIED">overwrite-last-modified</a></dt>
+ <dt>8.5.36. <a href="actions-file.html#REDIRECT">redirect</a></dt>
+ <dt>8.5.37. <a href="actions-file.html#SERVER-HEADER-FILTER">server-header-filter</a></dt>
+ <dt>8.5.38. <a href="actions-file.html#SERVER-HEADER-TAGGER">server-header-tagger</a></dt>
+ <dt>8.5.39. <a href="actions-file.html#SUPPRESS-TAG">suppress-tag</a></dt>
+ <dt>8.5.40. <a href="actions-file.html#SESSION-COOKIES-ONLY">session-cookies-only</a></dt>
+ <dt>8.5.41. <a href="actions-file.html#SET-IMAGE-BLOCKER">set-image-blocker</a></dt>
+ <dt>8.5.42. <a href="actions-file.html#SUMMARY">Summary</a></dt>
</dl>
</dd>
<dt>8.6. <a href="actions-file.html#ALIASES">Aliases</a></dt>
</dl>
</dd>
<dt>10. <a href="templates.html">Privoxy's Template Files</a></dt>
- <dt>11. <a href="contact.html">Contacting the Developers, Bug Reporting and Feature Requests</a></dt>
+ <dt>11. <a href="howto.html">HOWTOs</a></dt>
+ <dd>
+ <dl>
+ <dt>11.1. <a href="howto.html#H2-HTTPS-INSPECTION">HTTPS-Inspection HOWTO</a></dt>
+ <dd>
+ <dl>
+ <dt>11.1.1. <a href="howto.html#H2-HI-TLS">How TLS Certificates for websites work</a></dt>
+ <dt>11.1.2. <a href="howto.html#H2-HI-WORKS">How HTTPS inspection works</a></dt>
+ <dt>11.1.3. <a href="howto.html#H2-HI-INVALID-CERT">What happens, if the original certificate is
+ invalid?</a></dt>
+ <dt>11.1.4. <a href="howto.html#H2-HI-PREREQUISITES">HTTPS inspection prerequisites</a></dt>
+ <dt>11.1.5. <a href="howto.html#H2-HI-CONFIG">Configuring HTTPS inspection in Privoxy</a></dt>
+ <dt>11.1.6. <a href="howto.html#H2-HI-BROWSER">Browser configuration</a></dt>
+ <dt>11.1.7. <a href="howto.html#H2-HI-ENABLE">Enabeling HTTPS inspection</a></dt>
+ </dl>
+ </dd>
+ <dt>11.2. <a href="howto.html#H2-CLIENT-TAGS">Client Tags HOWTO</a></dt>
+ </dl>
+ </dd>
+ <dt>12. <a href="contact.html">Contacting the Developers, Bug Reporting and Feature Requests</a></dt>
<dd>
<dl>
- <dt>1
1.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please provide sufficient information</a></dt>
- <dt>1
1.2. <a href="contact.html#CONTACT-SUPPORT">Get Support</a></dt>
- <dt>1
1.3. <a href="contact.html#REPORTING">Reporting Problems</a></dt>
+ <dt>1
2.1. <a href="contact.html#SUFFICIENT-INFORMATION">Please provide sufficient information</a></dt>
+ <dt>1
2.2. <a href="contact.html#CONTACT-SUPPORT">Get Support</a></dt>
+ <dt>1
2.3. <a href="contact.html#REPORTING">Reporting Problems</a></dt>
<dd>
<dl>
- <dt>1
1.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads or Other Configuration Problems</a></dt>
- <dt>1
1.3.2. <a href="contact.html#CONTACT-BUGS">Reporting Bugs</a></dt>
+ <dt>1
2.3.1. <a href="contact.html#CONTACT-ADS">Reporting Ads or Other Configuration Problems</a></dt>
+ <dt>1
2.3.2. <a href="contact.html#CONTACT-BUGS">Reporting Bugs</a></dt>
</dl>
</dd>
- <dt>1
1.4. <a href="contact.html#SECURITY-CONTACT">Reporting security problems</a></dt>
- <dt>1
1.5. <a href="contact.html#MAILING-LISTS">Mailing Lists</a></dt>
- <dt>1
1.6. <a href="contact.html#SF-TRACKERS">SourceForge support trackers</a></dt>
+ <dt>1
2.4. <a href="contact.html#SECURITY-CONTACT">Reporting security problems</a></dt>
+ <dt>1
2.5. <a href="contact.html#MAILING-LISTS">Mailing Lists</a></dt>
+ <dt>1
2.6. <a href="contact.html#SF-TRACKERS">SourceForge support trackers</a></dt>
</dl>
</dd>
- <dt>1
2. <a href="copyright.html">Privoxy Copyright, License and History</a></dt>
+ <dt>1
3. <a href="copyright.html">Privoxy Copyright, License and History</a></dt>
<dd>
<dl>
- <dt>12.1. <a href="copyright.html#LICENSE">License</a></dt>
- <dt>12.2. <a href="copyright.html#HISTORY">History</a></dt>
- <dt>12.3. <a href="copyright.html#AUTHORS">Authors</a></dt>
+ <dt>13.1. <a href="copyright.html#LICENSE">License</a></dt>
+ <dd>
+ <dl>
+ <dt>13.1.1. <a href="copyright.html#GPLV2">GNU General Public License version 2</a></dt>
+ <dt>13.1.2. <a href="copyright.html#GPLV3">GNU General Public License version 3</a></dt>
+ <dt>13.1.3. <a href="copyright.html#THIRD-PARTY-LICENSES">Third-party licenses and copyrights</a></dt>
+ </dl>
+ </dd>
+ <dt>13.2. <a href="copyright.html#HISTORY">History</a></dt>
+ <dt>13.3. <a href="copyright.html#AUTHORS">Authors</a></dt>
</dl>
</dd>
- <dt>1
3. <a href="seealso.html">See Also</a></dt>
- <dt>1
4. <a href="appendix.html">Appendix</a></dt>
+ <dt>1
4. <a href="seealso.html">See Also</a></dt>
+ <dt>1
5. <a href="appendix.html">Appendix</a></dt>
<dd>
<dl>
- <dt>1
4.1. <a href="appendix.html#REGEX">Regular Expressions</a></dt>
- <dt>1
4.2. <a href="appendix.html#INTERNAL-PAGES">Privoxy's Internal Pages</a></dt>
- <dt>1
4.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>
- <dt>1
4.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting: Anatomy of an Action</a></dt>
+ <dt>1
5.1. <a href="appendix.html#REGEX">Regular Expressions</a></dt>
+ <dt>1
5.2. <a href="appendix.html#INTERNAL-PAGES">Privoxy's Internal Pages</a></dt>
+ <dt>1
5.3. <a href="appendix.html#CHAIN">Chain of Events</a></dt>
+ <dt>1
5.4. <a href="appendix.html#ACTIONSANAT">Troubleshooting: Anatomy of an Action</a></dt>
</dl>
</dd>
</dl>
projects / privoxy.git / blobdiff