Privoxy 3.0.8 User Manual
Prev		Next

3. What's New in this Release

There are many improvements and new features since Privoxy 3.0.6, the last stable release:

Two new actions server-header-tagger - and client-header-tagger - that can be used to create arbitrary "tags" - based on client and server headers. - These "tags" can then subsequently be used - to control the other actions used for the current request, - greatly increasing Privoxy's flexibility and selectivity. See tag patterns for more information on tags. -
Header filtering is done with dedicated header filters now. As a result - the actions "filter-client-headers" and "filter-server-headers" - that were introduced with Privoxy 3.0.5 to apply - content filters to the headers have been removed. - See the new actions server-header-filter - and client-header-filter for details. -
There are four new options for the main config file: -
- allow-cgi-request-crunching - which allows requests for Privoxy's internal CGI pages to be - blocked, redirected or (un)trusted like ordinary requests. -
- split-large-forms - that will work around a browser bug that caused IE6 and IE7 to - ignore the Submit button on the Privoxy's edit-actions-for-url CGI - page. -
- accept-intercepted-requests - which allows to combine Privoxy with any packet filter to create an - intercepting proxy for HTTP/1.1 requests (and for HTTP/1.0 requests - with Host header set). This means clients can be forced to use - Privoxy even if their proxy settings are configured differently. -
- templdir - to designate an alternate location for Privoxy's - locally customized CGI templates so that - these are not overwritten during upgrades. -
A new command line option --pre-chroot-nslookup hostname to - initialize the resolver library before chroot'ing. On some systems this - reduces the number of files that must be copied into the chroot tree. - (Patch provided by Stephen Gildea) -
The forward-override action - allows changing of the forwarding settings through the actions files. - Combined with tags, this allows to choose the forwarder based on - client headers like the User-Agent, or the request origin. -
The redirect action can now use regular - expression substitutions against the original URL. -
zlib support is now available as a compile - time option to filter compressed content. Patch provided by Wil Mahan. -
Improve various filters, and add new ones. -
Include support for RFC 3253 so that Subversion works - with Privoxy. Patch provided by Petr Kadlec. -
Logging can be completely turned off by not specifying a logfile directive. -
A number of improvements to Privoxy's internal CGI pages, including the - use of favicons for error and control pages. -
Many bugfixes, memory leaks addressed, code improvements, and logging - improvements. -

For a more detailed list of changes please have a look at the ChangeLog.

3.1. Note to Upgraders

A quick list of things to be aware of before upgrading from earlier - versions of Privoxy:

The recommended way to upgrade Privoxy is to backup your old - configuration files, install the new ones, verify that Privoxy - is working correctly and finally merge back your changes using - diff and maybe patch. -
There are a number of new features in each Privoxy release and - most of them have to be explicitly enabled in the configuration - files. Old configuration files obviously don't do that and due - to syntax changes using old configuration files with a new - Privoxy isn't always possible anyway. -
- Note that some installers remove earlier versions completely, - including configuration files, therefore you should really save - any important configuration files! -
- On the other hand, other installers don't overwrite existing configuration - files, thinking you will want to do that yourself. -
- standard.action now only includes the enabled actions. - Not all actions as before. -
In the default configuration only fatal errors are logged now. - You can change that in the debug section - of the configuration file. You may also want to enable more verbose - logging until you verified that the new Privoxy version is working - as expected. -
Three other config file settings are now off by default: - enable-remote-toggle, - enable-remote-http-toggle, - and enable-edit-actions. - If you use or want these, you will need to explicitly enable them, and - be aware of the security issues involved. -
The "filter-client-headers" and - "filter-server-headers" actions that were introduced with - Privoxy 3.0.5 to apply content filters to - the headers have been removed and replaced with new actions. - See the What's New section above. -

Privoxy 3.0.30 User Manual
Prev		Next

3. What's New in this Release

Privoxy 3.0.30 fixes a couple of bugs and introduces a few new features.

Changes in Privoxy 3.0.30 stable:

+
Bug fixes:
+
- +
  Check the actual URL for redirects when https inspecting requests. Previously Privoxy would only check + the path which resulted in rewrite results being rejected as invalid URLs. Reported by withoutname in + #1736.
  +
- +
  Let the hide-referrer code tolerate Referer headers with https:// URLs. Previously they would always be + treated like a changed host.
  +
- +
  Use the https headers if the show-request handler is reached through https://. Previously Privoxy would + use the http headers which may be empty on a reused connection.
  +
- +
  Make CGI_PREFIX protocol-relative when building with FEATURE_HTTPS_INSPECTION. This unbreaks (at least) + https://config.privoxy.org/client-tags whose buttons would previously use a http:// URL resulting in + browser warnings.
  +
- +
  Support using https-inspection and client-header-order at the same time. Previously Privoxy would crash. + Reported by: Kai Raven
  +
- +
  Properly reject rewrites from http to https as they currently aren't supported. Previously Privoxy would + wait for the client to establish an encrypted connection which obviously would not happen.
  +
- +
  When https inspection is enabled and Privoxy has been compiled with FEATURE_GRACEFUL_TERMINATION (not + recommended for production builds), the TLS backend resources are free'd later on and only if no active + connections are left. Prevents crashes when exiting "gracefully" at the wrong time.
  +
- +
  Let the uninstall target remove the config file even if DESTDIR is set and properly announce the + deletion of the configuration files.
  +
+
+
General improvements:
+
- +
  Allow to rewrite the request destination for https-inspected requests behind the client's back. The + documentation already sort of claimed that it was supported by not especially mentioning that it didn't + work for https-inspected requests. Fixes SF bug #923 reported by withoutname.
  +
- +
  Add support for filtering client request bodies by using CLIENT-BODY-FILTER filters which can be enabled + with the client-body-filter action. Patch submitted by Maxim Antonov. Sponsored by: Robert Klemme
  +
- +
  Add the new action suppress-tag{} which can be used to prevent a tagger from adding a tag. Patch + submitted by Maxim Antonov. Sponsored by: Robert Klemme
  +
- +
  Gracefully handle existing website keys without matching certificates. This can happen if Privoxy was + previously running with an invalid TLS configuration that didn't allow it to create a certificate.
  +
- +
  Recycle debug bit 4 for Tagging-related messages.
  +
- +
  Improve the message shown when the client-tags CGI page is requested with no tags configured.
  +
- +
  Shorten the 'donate' and 'participate' links used by templates using redirects. Currently the redirects + lead to the FAQ entries but in the future we may want to relocate the content and using redirects makes + this more convenient.
  +
- +
  Log an error when a PCRE-HOST-PATTERN is used with FEATURE_PCRE_HOST_PATTERNS disabled. Don't treat this + a fatal error so the regression tests can be used with and without FEATURE_PCRE_HOST_PATTERNS.
  +
- +
  The code compiles with older C compilers again.
  +
- +
  The chdir() return code is checked to fix a compiler warning.
  +
- +
  The packages feed has been removed from the source tarball. It's usually out of date when the source + tarball is generated for the release.
  +
- +
  Fixed harmless compiler warnings from GCC9 with -D_FORTIFY_SOURCE=2.
  +
- +
  windows: Remove obsolete '$(DEST)/doc/images' target.
  +
- +
  windows: Install the images referenced in the user manual.
  +
- +
  Remove obsolete 'gnu_regex.@OBJEXT@' target.
  +
- +
  When installing from the GNUMAkefile, don't create an 'images' directory which is no longer used. The + images were relocated to the user-manual directory years ago.
  +
- +
  Add new FEATURES to the show-status page and resort list.
  +
- +
  Remove unused variable in the OpenSSL-specific code.
  +
- +
  Update bug tracker URL in cgi_error_unknown().
  +
- +
  Saved a couple of memory allocations when sorting client headers.
  +
- +
  Improved a couple of error messages.
  +
- +
  Saved memory allocations when using OpenSSL and checking if a key already exists.
  +
- +
  The configure script will bail out if OpenSSL and mbedTLS are enabled at the same time.
  +
- +
  Log a message right before exiting gracefully.
  +
- +
  A couple of structures have been rearranged to require slightly less memory.
  +
- +
  When https inspection is enabled and the certificate is invalid the error message is now sent with + status code 403 instead of 200.
  +
- +
  The Slackware rc script template has been renamed to slackware/rc.privoxy.in to silence complaints when + building Debian packages.
  +
- +
  When building with MbedTLS support, mbedtls_md5_ret() is used instead of mbedtls_md5() which is + deprecated and causes a warning on Debian GNU/Linux.
  +
+
+
Action file improvements:
+
- +
  Block requests to eu-tlp03.kameleoon.com/.
  +
- +
  Unblock metrics.sr.ht/.
  +
- +
  Disable fast-redirects for .fsf.org/.
  +
- +
  Disable fast-redirects for .gravater.com/.
  +
- +
  Disable fast-redirects for .ksta.de/.
  +
- +
  Block requests to tag.crsspxl.com/.
  +
- +
  Block requests to analytics.slashdotmedia.com/.
  +
- +
  Block requests to ml314.com/.
  +
- +
  Block requests to .adroll.com/.
  +
- +
  Block requests to fastlane.rubiconproject.com/.
  +
- +
  Block requests to api.theadex.com/.
  +
- +
  Block requests to ih.adscale.de/.
  +
- +
  Block requests to .s400.meetrics.net/.
  +
- +
  Block requests for pp.lp4.io/.
  +
- +
  Block requests for trc-events.taboola.com/.
  +
+
+
Filter file improvements:
+
- +
  A allow-autocompletion filter has been added which changes autocomplete="off" to "on" on input fields to + allow autocompletion. Requested by Jamie Zawinski in #370. Filter based on a submission by Aaron + Linville.
  +
- +
  Added an imdb filter.
  +
- +
  Added a sourceforge filter that reduces the amount of ads for proprietary software.
  +
- +
  Added a github filter that removes the annoying "Sign-Up" banner and the Cookie disclaimer.
  +
- +
  Removed a duplicated pcrs command from the js-annoyances filter.
  +
- +
  The crude-parental filter now provides a short reason when blocking, inserts a link to Privoxy's + webinterface and adds a new line at the end of the generated page.
  +
+
+
Privoxy-Log-Parser:
+
- +
  Highlight a few more messages.
  +
- +
  Add a handler for tagging messages.
  +
- +
  Properly deal with 'Certificate error' crunches Previously the error description was highlighted as + 'host'.
  +
- +
  Log truncated LOG_LEVEL_CLF messages more gracefully and note that the statistics will be imprecise.
  +
- +
  Fixed perldoc typo.
  +
- +
  Bump version to 0.9.2.
  +
+
+
Privoxy-Regression-Test:
+
- +
  Use http://127.0.0.1:8118/ as default Privoxy address unless http_proxy is set through the + environment.
  +
- +
  Add a --privoxy-cgi-prefix option that specifies the prefix to use when building URLs that are supposed + to reach Privoxy's CGI interface. If it's not set, http://p.p/ is used, which is supposed to work with the + default Privoxy configuration. If Privoxy has been built with FEATURE_HTTPS_INSPECTION enabled, and if + https inspection is activated with the +https-inspection action, this option can be used with + "https://p.p/" provided the system running Privoxy-Regression-Test has been configured to trust the + certificate used by Privoxy. Note that there are currently two tests in the official + regression-tests.action file that are expected to fail when using "https://p.p/" as privoxy-cgi-prefix.
  +
- +
  Skip the connection-established response in get_status_code() when looking for the status code with a + CGI prefix that starts with https://. We care about the status code sent by the impersonated web + server.
  +
- +
  Use --proxy-header when using a CGI prefix with https:// and a "Host:" header.
  +
- +
  Allow '|' in tokens and values to allow tag patterns like + "TAG:^(application|text)/(x-)?javascript$".
  +
- +
  When get_cgi_page_or_else() fails, include the URL of the requested page in the log message.
  +
- +
  Added a --check-bad-ssl option that can be used to verify that Privoxy detects certificate problems when + accessing the test sites from badssl.com.
  +
- +
  Bumped version to 0.7.2
  +
+
+
uagen:
+
- +
  Update example output.
  +
- +
  Recommend the use of the https-inspection action in the documentation.
  +
- +
  Upgrade a couple of URLs to https://.
  +
- +
  Add ElectroBSD to the list of operating systems.
  +
- +
  Bumped generated Firefox version to 78 (ESR).
  +
- +
  Bumped version to 1.2.2.
  +
+
+
User documentation:
+
- +
  Remove reference to 'How to Report Bugs Effectively'. It was only rendered as text without URL in the + README anyway and there's no indication that users read it ...
  +
- +
  Let the dok-readme target fix the location embedded into the README file. This used to be done by CVS + but since the git migration it has to be done through other means.
  +
- +
  Remove 'experimental' warning for client-specific-tag-related directives. They seem to work reliably and + there is no obvious reason why we would change the syntax in the near future.
  +
- +
  Describe how to check if Privoxy has been built with FEATURE_HTTPS_INSPECTION.
  +
- +
  Add a link to the trusted-cas-file documentation that explains how the user can create the file + herself.
  +
- +
  Don't explicitly mention the license for the code coming from 'Anonymous Coders' and Junkbusters. It's + obviously licensed under the GNU GPL like the rest of Privoxy or we wouldn't be allowed to distribute + it.
  +
- +
  Update the +hide-user-agent example with uagen output.
  +
- +
  Slightly improve the wording of the ca-key-file documentation.
  +
- +
  Explicitly mention Windows 10 as supported so search engines and users looking for it can find it.
  +
- +
  Import a bunch of contributors from the ChangeLog.
  +
- +
  Remove obsolete doc/gpl.html.
  +
- +
  Upgrade a couple of links to https://.
  +
- +
  Don't prefer the SourceForge patch tracker over the privoxy-devel mailing list. While at it, link to the + SourceForge patch tracker.
  +
- +
  Mention http-inspection in the 'my browser warns me about unauthenticated content' FAQ entry.
  +
- +
  Simplify the 'Is there is a license or fee?' FAQ entry.
  +
- +
  Add another +redirect{} example.
  +
- +
  Explicitly mention that interested sponsors should include the link target in their first mail.
  +
- +
  Clarify that only Privoxy team members can object to new sponsors and link to the list of current team + members.
  +
- +
  Note that sponsor URLs may not contain keyword spam.
  +
- +
  Garbage collect doc/webserver/images which isn't referenced anymore.
  +
- +
  Update the method to reach the proxy settings in Firefox.
  +
- +
  Update proxy_setup.jpg description to refer to Firefox.
  +
- +
  Regenerate proxy_setup.jpg with a more recent Firefox (78.0).
  +
- +
  Regenerate files-in-use.jpg without obsolete standard.action with modern colors and a slightly better + quality.
  +
- +
  Update URL to the actionsfile tracker.
  +
- +
  Update a support request URL.
  +
- +
  Rephrase the 'Can Privoxy run as service' FAQ entry and remove an obsolete paragraph.
  +
- +
  Let the 'Where can I get updated Actions Files?' entry link to the gitweb version of + default.action.master.
  +
- +
  Update a link to the default.action file.
  +
- +
  Update URLs for trackers and mailing lists.
  +
- +
  Replace CVS reference with git.
  +
- +
  Mention regression-tests.action in the config file.
  +
- +
  Explicitly mention in the config file that access to the CA key should be limited to Privoxy.
  +
- +
  List more client-specific-tag examples for inspiration.
  +
- +
  Add additional headers to the client-header-order example.
  +
- +
  Note that actions aren't updated after rewrites.
  +
- +
  Explicitly mention that upgrading from http to https with a client-header filter is not supported
  +
- +
  Note that protocol and host have to be added when rewriting the destination host for https-inspected + requests.
  +
- +
  Explicitly mention that the CA key is used to sign certificates.
  +
- +
  Put openssl command in 'command' tags.
  +
- +
  The man page has been moved from section 1 to man section 8.
  +
+
+
Developer manual:
+
- +
  Flesh out the build instructions for Debian.
  +
- +
  Remove the packaging instructions for RPM-based systems. They don't work and we don't release RPM + packages anymore anyway.
  +
- +
  Remove the packaging instructions for Solaris. They don't work and we don't release Solaris packages + anymore anyway.
  +
- +
  Update the suggested subject for the announce mails.
  +
- +
  Update upload instructions. ftp://upload.sourceforge.net is no longer functional.
  +
- +
  Remove a couple of package-dependent upload instructions that don't actually work.
  +
- +
  Remove 'cd current' that no longer works.
  +
- +
  Add regression-tests.action to the list of files that should be installed.
  +
- +
  Stop claiming that there are text versions of the manuals. We stopped building them in 2008 + (9ed36a3c5e6f12).
  +
- +
  Note that the 'webserver' target creates the link needed for the user-manual.
  +
- +
  Suggest to use the master branch as reference when creating the ChangeLog so the steps work when the + current branch differs from master which is likely as the developer manual suggests to use a local branch + for development.
  +
- +
  Add the -s flag to the suggested 'git tag' command. We prefer signed tags.
  +
- +
  Mention that merges into 'master' should be avoided.
  +
- +
  Add git commands that should result in a merge-free history.
  +
- +
  Mention Privoxy-Regression-Test.
  +
- +
  Add a section id to reduce link churn.
  +
- +
  Recommend the dok-tidy target when building docs for the webserver.
  +
- +
  Add another plug for the privoxy-devel mailing list.
  +
- +
  Let the intro link the copyright section in the user manual instead of giving an incomplete summary of + the license status.
  +
- +
  Clarify that the webserver target uploads to the SourceForge webserver.
  +
- +
  Mark the documentation for the Mac OS X installers as out of date and change the SCM name back to + CVS.
  +
- +
  Fix the location of the installer modules for Mac OS X. They are not actually available through git + (yet).
  +
- +
  Don't speak of Privoxy version 3 in the past tense.
  +
- +
  Update the list of programs required for the release process.
  +
- +
  Update description of the webserver target which uses ssh, not scp.
  +
- +
  Remove obsolete reference to config.new.
  +
+
+
Tests:
+
- +
  Add another hide-referrer{conditional-block} test.
  +
- +
  Add another hide-referrer{conditional-forge} test.
  +
- +
  Fix a hide-referrer{conditional-forge} test that expected an acceptable header to be forged.
  +
- +
  Fix a hide-referrer{conditional-block} test that expected an acceptable Referer to be removed.
  +
- +
  Explain why the "Set Header = Host: whatever.example.org" test is expected to fail when using a CGI + prefix that starts with "https://".
  +
- +
  Explain why a connection-sharing test is known to fail when using "https://p.p/" as CGI prefix.
  +
- +
  Add a link to Privoxy-Regression-Test to regression-tests.action in case it isn't packaged.
  +
- +
  Add regression tests for pcre host patterns.
  +
- +
  Fixed a regression test that is executed when FEATURE_GRACEFUL_TERMINATION is enabled.
  +
+
+
Privoxy infrastructure:
+
- +
  Import a Privoxy logo for the website.
  +
- +
  Update Tor onion service to HiddenServiceVersion 3.
  +
- +
  Display the "model" photos in a single row and remove placeholder images.
  +
- +
  Regenerate homepage with updated sponsor list.
  +
- +
  Use the '/sponsor' redirect for the link to the sponsor page.
  +
- +
  Git commit messages are sent to the Privoxy-commits mailing list.
  +
+

3.1. Note to Upgraders

A quick list of things to be aware of before upgrading from earlier versions of Privoxy:

+
The recommended way to upgrade Privoxy is to backup your old + configuration files, install the new ones, verify that Privoxy is working + correctly and finally merge back your changes using diff and maybe + patch.
+
There are a number of new features in each Privoxy release and most of + them have to be explicitly enabled in the configuration files. Old configuration files obviously don't do + that and due to syntax changes using old configuration files with a new Privoxy isn't always possible anyway.
+
+
Note that some installers remove earlier versions completely, including configuration files, therefore you + should really save any important configuration files!
+
+
On the other hand, other installers don't overwrite existing configuration files, thinking you will want + to do that yourself.
+
+
In the default configuration only fatal errors are logged now. You can change that in the debug section of the configuration file. You may also want to enable more verbose + logging until you verified that the new Privoxy version is working as + expected.
+
+
Three other config file settings are now off by default: enable-remote-toggle, enable-remote-http-toggle, and enable-edit-actions. If you use or want these, you will need to + explicitly enable them, and be aware of the security issues involved.
+

Prev	Home	Next
Installation		Quickstart to Using Privoxy

Prev	Home	Next
Installation		Quickstart to Using Privoxy