-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
-Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+
<html>
- <head>
- <meta name="generator" content="HTML Tidy, see www.w3.org">
- <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.18 User Manual" href="index.html">
- <link rel="PREVIOUS" title="Installation" href="installation.html">
- <link rel="NEXT" title="Quickstart to Using Privoxy" href=
- "quickstart.html">
- <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
- <link rel="STYLESHEET" type="text/css" href="p_doc.css">
-<style type="text/css">
- body {
+<head>
+ <meta name="generator" content=
+ "HTML Tidy for Linux/x86 (vers 7 December 2008), see www.w3.org">
+
+ <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.18 User Manual" href="index.html">
+ <link rel="PREVIOUS" title="Installation" href="installation.html">
+ <link rel="NEXT" title="Quickstart to Using Privoxy" href=
+ "quickstart.html">
+ <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
+ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+ <link rel="STYLESHEET" type="text/css" href="p_doc.css">
+ <style type="text/css">
+body {
background-color: #EEEEEE;
color: #000000;
- }
- :link { color: #0000FF }
- :visited { color: #840084 }
- :active { color: #0000FF }
- hr.c1 {text-align: left}
-</style>
- </head>
- <body class="SECT1">
- <div class="NAVHEADER">
- <table summary="Header navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <th colspan="3" align="center">
- Privoxy 3.0.18 User Manual
- </th>
- </tr>
- <tr>
- <td width="10%" align="left" valign="bottom">
- <a href="installation.html" accesskey="P">Prev</a>
- </td>
- <td width="80%" align="center" valign="bottom">
- </td>
- <td width="10%" align="right" valign="bottom">
- <a href="quickstart.html" accesskey="N">Next</a>
- </td>
- </tr>
- </table>
- <hr width="100%" class="c1">
- </div>
- <div class="SECT1">
- <h1 class="SECT1">
- <a name="WHATSNEW">3. What's New in this Release</a>
- </h1>
- <p>
- <span class="APPLICATION">Privoxy 3.0.17</span> is a stable release.
- The changes since 3.0.16 stable are:
- </p>
- <p>
- </p>
+ }
+ :link { color: #0000FF }
+ :visited { color: #840084 }
+ :active { color: #0000FF }
+ hr.c1 {text-align: left}
+ </style>
+</head>
+
+<body class="SECT1">
+ <div class="NAVHEADER">
+ <table summary="Header navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <th colspan="3" align="center">Privoxy 3.0.18 User Manual</th>
+ </tr>
+
+ <tr>
+ <td width="10%" align="left" valign="bottom"><a href=
+ "installation.html" accesskey="P">Prev</a></td>
+
+ <td width="80%" align="center" valign="bottom"></td>
+
+ <td width="10%" align="right" valign="bottom"><a href=
+ "quickstart.html" accesskey="N">Next</a></td>
+ </tr>
+ </table>
+ <hr class="c1" width="100%">
+ </div>
+
+ <div class="SECT1">
+ <h1 class="SECT1"><a name="WHATSNEW" id="WHATSNEW">3. What's New in this
+ Release</a></h1>
+
+ <p><span class="APPLICATION">Privoxy 3.0.18</span> is a stable release.
+ The changes since 3.0.17 stable are:</p>
+
+ <ul>
+ <li>
+ <p>Bug fixes:</p>
+
+ <ul>
+ <li>
+ <p>Fix a logic bug that could cause Privoxy to reuse a tainted
+ server socket. It could happen for server sockets that got
+ tainted by a server-header-tagger-induced block, in which case
+ Privoxy doesn't necessarily read the whole server response. If
+ keep-alive was enabled and the request following the blocked one
+ was to the same host and using the same forwarding settings,
+ Privoxy would send it on the tainted server socket. While the
+ server would simply treat it as a pipelined request, Privoxy
+ would later on fail to properly parse the server's response as it
+ would try to parse the unread data from the first response as
+ server headers for the second one. Regression introduced in
+ 3.0.17.</p>
+ </li>
+
+ <li>
+ <p>When implying keep-alive in client_connection(), remember that
+ the client didn't Fixes a regression introduced in 3.0.13 that
+ would cause Privoxy to wait for additional client requests after
+ receiving a HTTP/1.1 request with "Connection: close" set and
+ connection sharing enabled. With clients like curl which
+ terminates the client connection after detecting that the whole
+ body has been received it doesn't really matter, but with clients
+ like FreeBSD's fetch the client connection would be kept open
+ until it timed out.</p>
+ </li>
+
+ <li>
+ <p>Fix a subtle race condition between
+ prepare_csp_for_next_request() and sweep() A thread preparing
+ itself for the next client request could briefly appear to be
+ inactive. If all other threads were already using more recent
+ files, the thread could get its files swept away under its feet.
+ I've only seen it while stress testing in valgrind while touching
+ action files in a loop. It's unlikely to have caused any actual
+ problems in the real world.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>General improvements:</p>
+
+ <ul>
+ <li>
+ <p>Privoxy can (re)compress buffered content before delivering it
+ to the client. Disabled by default as most users wouldn't benefit
+ from it.</p>
+ </li>
+
+ <li>
+ <p>The +fast-redirects{check-decoded-url} action checks URL
+ segments separately. If there are other parameters behind the
+ redirect URL, this makes it unnecessary to cut them of by
+ additionally using a +redirect{} pcrs command. Initial patch
+ submitted by Jamie Zawinski in #3429848.</p>
+ </li>
+
+ <li>
+ <p>Properly deal with FEATURE_TOGGLE being disabled</p>
+ </li>
+
+ <li>
+ <p>Adjust url_code_map[] so spaces are replaced with %20 instead
+ of '+' While '+' can be used by client's submitting form data,
+ this is not actually what Privoxy is using the lookups for. This
+ is more of a cosmetic issue and doesn't fix any actual problems
+ I'm aware of.</p>
+ </li>
+
+ <li>
+ <p>When compiled without FEATURE_FAST_REDIRECTS, do not silently
+ ignore +fast-redirect{} directives</p>
+ </li>
+
+ <li>
+ <p>Added a workaround for GNU libc's strptime() reporting
+ negative year values when the parsed year is only specified with
+ two digits. On affected systems cookies with such a date would
+ not be turned into session cookies by the +session-cookies-only
+ action. Reported by Vaeinoe in #3403560</p>
+ </li>
+
+ <li>
+ <p>When loading action sections, verify that the referenced
+ filters exist Currently missing filters only result in an error
+ message, but eventually the severity will be upgraded to
+ fatal.</p>
+ </li>
+
+ <li>
+ <p>Allow to bind to multiple separate addresses. Patch set
+ submitted by Petr Pisar in #3354485.</p>
+ </li>
+
+ <li>
+ <p>Set socket_error to errno if connecting fails in
+ rfc2553_connect_to() Previously rejected direct connections could
+ be incorrectly reported as DNS issues.</p>
+ </li>
+
+ <li>
+ <p>Fixed bind failures with certain GNU libc versions if no
+ non-loopback IP address has been configured on the system. This
+ is mainly an issue if the system is using DHCP and Privoxy is
+ started before the network is completely configured. Reported by
+ Raphael Marichez in #3349356. Additional insight from Petr
+ Pisar.</p>
+ </li>
+
+ <li>
+ <p>Disable filters if SDCH compression is used unless filtering
+ is forced. If SDCH was combined with a supported compression
+ algorithm, we'd previously try to decompress it, when successful
+ apply the enabled filters and ditch the Content-Encoding header
+ even though the SDCH compression wasn't removed. Reported by
+ zebul666 in #3225863.</p>
+ </li>
+
+ <li>
+ <p>Privoxy log messages now use the ISO 8601 date format
+ %Y-%m-%d. It's only slightly longer than the old format, but
+ contains the full date including the year and allows sorting by
+ date (when grepping in multiple log files) without hassle.</p>
+ </li>
+
+ <li>
+ <p>Make a copy of the --user value and only mess with that when
+ splitting user and group. On some operating systems modifying the
+ value directly is reflected in the output of ps and friends and
+ can be misleading. Reported by zepard in #3292710.</p>
+ </li>
+
+ <li>
+ <p>If forwarded-connect-retries is set, only retry if the we are
+ actually forwarding the request. Previously direct connections
+ would be retried as well.</p>
+ </li>
+
+ <li>
+ <p>Fixed a small memory leak when retrying connection</p>
+ </li>
+
+ <li>
+ <p>Remove an incorrect assertion in
+ compile_dynamic_pcrs_job_list() It could be triggered by a pcrs
+ job with an invalid pcre pattern (for example one that contains a
+ lone quantifier).</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Action file improvements:</p>
+
+ <ul>
+ <li>
+ <p>Moved the site-specific block pattern section below the one
+ for the generic patterns so for requests that are matched in
+ both, the block reason for the domain is shown which is usually
+ more useful than showing the one for the generic pattern.</p>
+ </li>
+
+ <li>
+ <p>Add a (disabled) section to block various Facebook tracking
+ URLs Reported by Dan Stahlke in #3421764.</p>
+ </li>
+
+ <li>
+ <p>Add a (disabled) section to rewrite and redirect
+ click-tracking URLs used on news.google.com Reported by Dan
+ Stahlke in #3421755.</p>
+ </li>
+
+ <li>
+ <p>Unblock linuxcounter.net/ Reported by Dan Stahlke in
+ #3422612.</p>
+ </li>
+
+ <li>
+ <p>Block 'www91.intel.com/' which is used by Omniture. Reported
+ by Adam Piggott in #3167370.</p>
+ </li>
+
+ <li>
+ <p>Disable the handle-as-empty-doc-returns-ok option and mark it
+ as deprecated. Reminded by tceverling in #2790091.</p>
+ </li>
+
+ <li>
+ <p>Add ".ivwbox.de/" to the "Cross-site user tracking" section.
+ Reported by Nettozahler in #3172525.</p>
+ </li>
+
+ <li>
+ <p>Unblock and fast-redirect ".awin1.com/.*=http://" Reported by
+ Adam Piggott in #3170921.</p>
+ </li>
+
+ <li>
+ <p>Block "b.collective-media.net/".</p>
+ </li>
+
+ <li>
+ <p>Widen the Debian popcon exception to "qa.debian.org/popcon".
+ Seen in Debian's 05_default_action.dpatch by Roland
+ Rosenfeld.</p>
+ </li>
+
+ <li>
+ <p>Block ".gemius.pl/" which only seems to be used for user
+ tracking. Reported by johnd16 in #3002731. Additional input from
+ Lee and movax.</p>
+ </li>
+
+ <li>
+ <p>Disable banners-by-size filters for '.thinkgeek.com/' The
+ filter only seems to catch pictures of the inventory.</p>
+ </li>
+
+ <li>
+ <p>Block requests for 'go.idmnet.bbelements.com/please/showit/'
+ Reported by kacperdominik in #3372959.</p>
+ </li>
+
+ <li>
+ <p>Unblock adainitiative.org/</p>
+ </li>
+
+ <li>
+ <p>Add a fast-redirects exception for
+ '.googleusercontent.com/.*=cache'</p>
+ </li>
+
+ <li>
+ <p>Add a fast-redirects exception for
+ webcache.googleusercontent.com/</p>
+ </li>
+
+ <li>
+ <p>Remove -prevent-compression from the fragile alias It's no
+ longer used anywhere by default and isn't known to break stuff
+ anyway.</p>
+ </li>
+
+ <li>
+ <p>Unblock http://adassier.wordpress.com/ and
+ http://adassier.files.wordpress.com/</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Filter file improvements:</p>
+
+ <ul>
+ <li>
+ <p>Let the yahoo filter hide '.ads'</p>
+ </li>
+
+ <li>
+ <p>Let the msn filter hide overlay ads for Facebook 'likes' in
+ search results.</p>
+ </li>
+
+ <li>
+ <p>Let the msn filter hide elements with the id 's_notf_div'.
+ They only seem to be used to advertise site 'enhancements'.</p>
+ </li>
+
+ <li>
+ <p>Let the js-events filter additionally disarm setInterval()
+ Suggested by dg1727 in #3423775.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Documentation improvements:</p>
+
+ <ul>
+ <li>
+ <p>Clarify the effect of compiling Privoxy with zlib support
+ Suggested by dg1727 in #3423782.</p>
+ </li>
+
+ <li>
+ <p>Point out that the SourceForge messaging system works like a
+ blackhole and should thus not be used</p>
+ </li>
+
+ <li>
+ <p>Mention some of the problems one can experience when not
+ explicitly configuring an IP addresses as listen address.</p>
+ </li>
+
+ <li>
+ <p>Explicitly mention that hostnames can be used instead of IP
+ addresses for the listen-address, that only the first address
+ returned will be used and what happens if the address is invalid.
+ Requested by Calestyo in #3302213.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Log message improvements:</p>
+
+ <ul>
+ <li>
+ <p>If only the server connection is kept alive, do not pretent to
+ wait for a new client request.</p>
+ </li>
+
+ <li>
+ <p>Remove a superfluos log message in forget_connection()</p>
+ </li>
+
+ <li>
+ <p>In chat(), properly report missing server responses as such
+ instead of calling them empty</p>
+ </li>
+
+ <li>
+ <p>In forwarded_connect(), fix a log message nobody should ever
+ see</p>
+ </li>
+
+ <li>
+ <p>Fix a log message in socks5_connect(), a failed write
+ operation was logged as failed read operation</p>
+ </li>
+
+ <li>
+ <p>Let load_one_actions_file() properly complain about a missing
+ '{' at the beginning of the file Simply stating that a line is
+ invalid isn't particularly helpful.</p>
+ </li>
+
+ <li>
+ <p>Do not claim to listen on a socket until we actually do. Patch
+ submitted by Petr Pisar #3354485</p>
+ </li>
+
+ <li>
+ <p>Prevent a duplicated LOG_LEVEL_CLF message when sending out
+ the "no-server-data" response</p>
+ </li>
+
+ <li>
+ <p>Also log the client socket when dropping a connection.</p>
+ </li>
+
+ <li>
+ <p>Include the destination host in the 'Request ... marked for
+ blocking. limit-connect{...} doesn't allow CONNECT ...' message
+ Patch submitted by Saperski in #3296250.</p>
+ </li>
+
+ <li>
+ <p>Prevent a duplicated log message if none of the resolved IP
+ addresses were reachable</p>
+ </li>
+
+ <li>
+ <p>In connect_to(), do not pretend to retry if
+ forwarded-connect-retries is zero or unset.</p>
+ </li>
+
+ <li>
+ <p>When a specified user or group can't be found, put the name in
+ single-quotes when logging it.</p>
+ </li>
+
+ <li>
+ <p>In rfc2553_connect_to(), explain getnameinfo() errors
+ differently.</p>
+ </li>
+
+ <li>
+ <p>Remove a useless log message in chat()</p>
+ </li>
+
+ <li>
+ <p>When retrying to connect, also log the maximum number of
+ connection attempts</p>
+ </li>
+
+ <li>
+ <p>Rephrase a log message in compile_dynamic_pcrs_job_list()
+ Divide the error code and its meaning with a colon. Call the pcrs
+ job dynamic and not the filter. Filters may contain dynamic and
+ non-dynamic pcrs jobs at the same time. Only mention the name of
+ the filter or tagger, but don't claim it's a filter when it could
+ be a tagger.</p>
+ </li>
+
+ <li>
+ <p>In a fatal error message in load_one_actions_file(), cover
+ both URL and TAG patterns</p>
+ </li>
+
+ <li>
+ <p>In pcrs_strerror(), properly report unknown positive error
+ code values as unknown. Previously they were handled like 0 (no
+ error).</p>
+ </li>
+
+ <li>
+ <p>In compile_dynamic_pcrs_job_list(), also log the actual error
+ code as pcrs_strerror() doesn't handle all errors reported by
+ pcre</p>
+ </li>
+
+ <li>
+ <p>Don't bother trying to continue chatting if the client didn't
+ ask for it. Reduces log noise a bit.</p>
+ </li>
+
+ <li>
+ <p>Make two fatal error message in load_one_actions_file() more
+ descriptive</p>
+ </li>
+
+ <li>
+ <p>In cgi_send_user_manual(), log when rejecting a file name due
+ to '/' or '..'</p>
+ </li>
+
+ <li>
+ <p>In load_file(), log a message if opening a file failed The CGI
+ error message alone isn't too helpful.</p>
+ </li>
+
+ <li>
+ <p>In connection_destination_matches(), improve two log messages
+ to help understand why the destinations don't match</p>
+ </li>
+
+ <li>
+ <p>Rephrase a log message in serve(). Client request arrival
+ should be differentiated from closed client connections now.</p>
+ </li>
+
+ <li>
+ <p>In serve(), log if a client connection isn't reused due to a
+ configuration file change.</p>
+ </li>
+
+ <li>
+ <p>Let mark_server_socket_tainted() always mark the server socket
+ tainted, just don't talk about it in cases where it has no
+ effect. It doesn't change Privoxy's behaviour, but makes
+ understanding the log file easier.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Miscellaneous Privoxy improvements:</p>
+
+ <ul>
+ <li>
+ <p>In get_last_url(), do not bother trying to decode URLs that do
+ not contain at least one '%' sign. It reduces the log noise and a
+ number of unnecessary memory allocations.</p>
+ </li>
+
+ <li>
+ <p>If the --user argument user[.group] contains a dot, always
+ bail out if no group has been specified. Previously the intended,
+ but undocumented (and apparently untested), behaviour was to try
+ interpreting the whole argument as user name, but the detection
+ was flawed and checked for '0' isntead of '\0', thus merely
+ preventing group names beginning with a zero.</p>
+ </li>
+
+ <li>
+ <p>Simplify the signal setup in main()</p>
+ </li>
+
+ <li>
+ <p>Streamline socks5_connect() slightly</p>
+ </li>
+
+ <li>
+ <p>In case of SOCKS5 failures, dump the socks response</p>
+ </li>
+
+ <li>
+ <p>In socks5_connect(), require a complete socks response from
+ the server Previously we didn't care how much data the server
+ response contained as long as the first two bytes contained the
+ expected values. While at it, shrink the buffer size so we can't
+ read more than a whole socks response. This is required to
+ support Tor's optimistic data extension.</p>
+ </li>
+
+ <li>
+ <p>In chat(), do not bother to generate a client request in case
+ of direct CONNECT requests</p>
+ </li>
+
+ <li>
+ <p>Reduce server_last_modified()'s stack size</p>
+ </li>
+
+ <li>
+ <p>Shorten get_http_time() by using strftime()</p>
+ </li>
+
+ <li>
+ <p>Constify the known_http_methods pointers in
+ unknown_method()</p>
+ </li>
+
+ <li>
+ <p>Constify the time_formats pointers in parse_header_time()</p>
+ </li>
+
+ <li>
+ <p>Constify the formerly_valid_actions pointers in
+ action_used_to_be_valid()</p>
+ </li>
+
+ <li>
+ <p>In html_code_map[], use a numeric character reference instead
+ of ' which wasn't standardized before XHTML 1.0</p>
+ </li>
+
+ <li>
+ <p>Introduce a MAN_PAGE variable that defaults to privoxy.1. The
+ Debian package uses section 8 for the man page and this should
+ simplify the patch.</p>
+ </li>
+
+ <li>
+ <p>Deduplicate the INADDR_NONE definition for Solaris by moving
+ it to jbsockets.h</p>
+ </li>
+
+ <li>
+ <p>In block_url(), ditch the obsolete workaround for ancient
+ Netscape versions that supposedly couldn't properly deal with
+ status code 403.</p>
+ </li>
+
+ <li>
+ <p>Remove a useless NULL pointer check in load_trustfile()</p>
+ </li>
+
+ <li>
+ <p>Remove two useless NULL pointer checks in
+ load_one_re_filterfile().</p>
+ </li>
+
+ <li>
+ <p>Change url_code_map[] from an array of pointers to an array of
+ arrays It removes an unnecessary layer of indirection and on
+ 64bit system reduces the size of the binary a bit.</p>
+ </li>
+
+ <li>
+ <p>Fix various typos. Fixes taken from Debian's 29_typos.dpatch
+ by Roland Rosenfeld.</p>
+ </li>
+
+ <li>
+ <p>Add a dok-tidy GNUMakefile target to clean up the messy HTML
+ generated by the other dok targets.</p>
+ </li>
+
+ <li>
+ <p>GNUisms in the GNUMakefile have been removed.</p>
+ </li>
+
+ <li>
+ <p>Change the HTTP version in static responses to 1.1</p>
+ </li>
+
+ <li>
+ <p>Synced config.sub and config.guess with upstream
+ 2011-11-11/386c7218162c145f5f9e1ff7f558a3fbb66c37c5.</p>
+ </li>
+
+ <li>
+ <p>Add a dedicated function to parse the values of toggles
+ Reduces duplicated code in load_config() and provides better
+ error handling. Invalid or missing toggle values are now a fatal
+ error instead of being silently ignored.</p>
+ </li>
+
+ <li>
+ <p>Terminate HTML lines in static error messages with \n instead
+ of \r\n.</p>
+ </li>
+
+ <li>
+ <p>Simplify cgi_error_unknown() a bit.</p>
+ </li>
+
+ <li>
+ <p>In LogPutString(), don't bother looking at pszText when not
+ actually logging anything</p>
+ </li>
+
+ <li>
+ <p>Change ssplit()'s fourth parameter from int to size_t. Fixes a
+ clang complaint.</p>
+ </li>
+
+ <li>
+ <p>Add a warning that the statistics currently can't be trusted.
+ Mention Privoxy-Log-Parser's --statistics option as an
+ alternative for the time being.</p>
+ </li>
+
+ <li>
+ <p>In rfc2553_connect_to(), start setting cgi->error_message
+ on error</p>
+ </li>
+
+ <li>
+ <p>Change the expected status code returned for http://p.p/die
+ depending on whether or not FEATURE_GRACEFUL_TERMINATION is
+ available.</p>
+ </li>
+
+ <li>
+ <p>In cgi_die(), mark the client connection for closing. If the
+ client will fetch the style sheet through another connection it
+ gets the main thread out of the accept() state and should thus
+ trigger the actual shutdown.</p>
+ </li>
+
+ <li>
+ <p>Add a proper CGI message for cgi_die().</p>
+ </li>
+
+ <li>
+ <p>Fix an invalid free when compiled with
+ FEATURE_GRACEFUL_TERMINATION and shut down through
+ http://config.privoxy.org/die</p>
+ </li>
+
+ <li>
+ <p>Don't enforce a logical line length limit in
+ read_config_line()</p>
+ </li>
+
+ <li>
+ <p>Slightly refactor server_last_modified() to remove useless
+ gmtime*() calls</p>
+ </li>
+
+ <li>
+ <p>In get_content_type(), also recognize '.jpeg' as JPEG
+ extension</p>
+ </li>
+
+ <li>
+ <p>Add '.png' to the list of recognized file extenstions in
+ get_content_type()</p>
+ </li>
+
+ <li>
+ <p>In block_url(), consistently use the block reason "Request
+ blocked by Privoxy" In two places the reason was "Request for
+ blocked URL" which hides the fact that the request got blocked by
+ Privoxy and isn't necessarly correct as the block may be due to
+ tags.</p>
+ </li>
+
+ <li>
+ <p>In get_actions(), fix the "temporary" backwards compatibility
+ hack to accept block actions without reason. It also covered
+ other actions that should be rejected as invalid. Reported by
+ Billy Crook.</p>
+ </li>
+
+ <li>
+ <p>In listen_loop(), reload the configuration files after
+ accepting a new connection instead of before. Previously the
+ first connection that arrived after a configuration change would
+ still be handled with the old configuration.</p>
+ </li>
+
+ <li>
+ <p>In chat()'s receive-data loop, skip a client socket check if
+ the socket will be written to right away anyway. This can
+ increase the transfer speed for unfiltered content on fast
+ network connections.</p>
+ </li>
+
+ <li>
+ <p>The socket timeout is used for SOCKS negotiation as well.</p>
+ </li>
+
+ <li>
+ <p>Don't keep the client connection alive if any configuration
+ file changed since the time the connection came in. This is
+ closer to Privoxy's behaviour before keep-alive support for
+ client connection has been added and also less confusing in
+ general.</p>
+ </li>
+
+ <li>
+ <p>Treat all Content-Type header values containing the pattern
+ 'script' as a sign of text. Reported by pribog in #3134970.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>configure:</p>
+
+ <ul>
+ <li>
+ <p>Added a --disable-ipv6-support switch for platforms where
+ support is detected but doesn't actually work.</p>
+ </li>
+
+ <li>
+ <p>Do not check for the existence of strerror() and memmove()
+ twice</p>
+ </li>
+
+ <li>
+ <p>Remove a useless test for setpgrp(2). Privoxy doesn't need it
+ and it can cause problems when cross-compiling</p>
+ </li>
+
+ <li>
+ <p>Rename the --disable-acl-files switch to --disable-acl-support
+ Since about 2001, ACL directives are specified in the standard
+ config file.</p>
+ </li>
+
+ <li>
+ <p>Update the URL of the 'Removing outdated PCRE version after
+ the next stable release' posting. The old URL stopped working
+ after one of SF's recent layout pessimizations. Reported by Han
+ Liu.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Privoxy-Regression-Test:</p>
+
+ <ul>
+ <li>
+ <p>Added --shuffle-tests option to increase the chances of
+ detection race conditions</p>
+ </li>
+
+ <li>
+ <p>Added a --local-test-file option that allows to use
+ Privoxy-Regression-Test without Privoxy</p>
+ </li>
+
+ <li>
+ <p>Added tests for missing socks4 and socks4a forwarders</p>
+ </li>
+
+ <li>
+ <p>The --privoxy-address option now works with IPv6 addresses
+ containing brackets, too</p>
+ </li>
+
+ <li>
+ <p>Perform limited sanity checks for parameters that are supposed
+ to have numerical values.</p>
+ </li>
+
+ <li>
+ <p>Added a --sleep-time option to specify a number of seconds to
+ sleep between tests, defaults to 0.</p>
+ </li>
+
+ <li>
+ <p>Disable the range-requests tagger for tests that break if it's
+ enabled</p>
+ </li>
+
+ <li>
+ <p>Log messages use the ISO 8601 date format %Y-%m-%d.</p>
+ </li>
+
+ <li>
+ <p>Fix spelling in two error messages.</p>
+ </li>
+
+ <li>
+ <p>In the --help output, include a list of supported tests and
+ their default levels.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>Privoxy-Log-Parser:</p>
+
+ <ul>
+ <li>
+ <p>Perform limited sanity checks for parameters that are supposed
+ to have numerical values.</p>
+ </li>
+
+ <li>
+ <p>Implement a --unbreak-lines-only option to try to revert MUA
+ breakage.</p>
+ </li>
+
+ <li>
+ <p>Accept and highlight: Added header: Content-Encoding:
+ deflate</p>
+ </li>
+
+ <li>
+ <p>Accept and highlight: Compressed content from 29258 to 8630
+ bytes.</p>
+ </li>
+
+ <li>
+ <p>Accept and highlight: Client request arrived in time on socket
+ 21.</p>
+ </li>
+
+ <li>
+ <p>Highlight: Didn't receive data in time: a.fsdn.com:443</p>
+ </li>
+
+ <li>
+ <p>Accept log messages with ISO 8601 time stamps, too</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>uagen:</p>
+
+ <ul>
+ <li>
+ <p>Bump generated Firefox version to 9.0</p>
+ </li>
+
+ <li>
+ <p>Only randomize the release date if the new
+ --randomize-release-date option is enabled. Firefox versions
+ after 4 use a fixed date string without meaning.</p>
+ </li>
+ </ul>
+ </li>
+ </ul>
+
+ <div class="SECT2">
+ <h2 class="SECT2"><a name="UPGRADERSNOTE" id="UPGRADERSNOTE">3.1. Note
+ to Upgraders</a></h2>
+
+ <p>A quick list of things to be aware of before upgrading from earlier
+ versions of <span class="APPLICATION">Privoxy</span>:</p>
+
<ul>
<li>
- <p>
- Fixed last-chunk-detection for responses where the content was
- small enough to be read with the body, causing Privoxy to wait
- for the end of the content until the server closed the connection
- or the request timed out. Reported by "Karsten" in #3028326.
- </p>
- </li>
- <li>
- <p>
- Responses with status code 204 weren't properly detected as
- body-less like RFC2616 mandates. Like the previous bug, this
- caused Privoxy to wait for the end of the content until the
- server closed the connection or the request timed out. Fixes
- #3022042 and #3025553, reported by a user with no visible name.
- Most likely also fixes a bunch of other AJAX-related problem
- reports that got closed in the past due to insufficient
- information and lack of feedback.
- </p>
- </li>
- <li>
- <p>
- Fixed an ACL bug that made it impossible to build a blacklist.
- Usually the ACL directives are used in a whitelist, which worked
- as expected, but blacklisting is still useful for public proxies
- where one only needs to deny known abusers access.
- </p>
- </li>
- <li>
- <p>
- Added LOG_LEVEL_RECEIVED to log the not-yet-parsed data read from
- the network. This should make debugging various parsing issues a
- lot easier.
- </p>
- </li>
- <li>
- <p>
- The IPv6 code is enabled by default on Windows versions that
- support it. Patch submitted by oCameLo in #2942729.
- </p>
- </li>
- <li>
- <p>
- In mingw32 versions, the user.filter file is reachable through
- the GUI, just like default.filter is. Feature request 3040263.
- </p>
- </li>
- <li>
- <p>
- Added the configure option --enable-large-file-support to set a
- few defines that are required by platforms like GNU/Linux to
- support files larger then 2GB. Mainly interesting for users
- without proper logfile management.
- </p>
- </li>
- <li>
- <p>
- Logging with "debug 16" no longer stops at the first nul byte
- which is pretty useless. Non-printable characters are replaced
- with their hex value so the result can't span multiple lines
- making parsing them harder then necessary.
- </p>
- </li>
- <li>
- <p>
- Privoxy logs when reading an action, filter or trust file.
- </p>
- </li>
- <li>
- <p>
- Fixed incorrect regression test markup which caused a test in
- 3.0.16 to fail while Privoxy itself was working correctly. While
- Privoxy accepts hide-referer, too, the action name is actually
- hide-referrer which is also the name used one the final results
- page, where the test expected the alias.
- </p>
- </li>
- <li>
- <p>
- CGI interface improvements:
- </p>
- <ul>
- <li>
- <p>
- In finish_http_response(), continue to add the 'Connection:
- close' header if the client connection will not be kept
- alive. Anonymously pointed out in #2987454.
- </p>
- </li>
- <li>
- <p>
- Apostrophes in block messages no longer cause parse errors
- when the blocked page is viewed with JavaScript enabled.
- Reported by dg1727 in #3062296.
- </p>
- </li>
- <li>
- <p>
- Fix a bunch of anchors that used underscores instead of
- dashes.
- </p>
- </li>
- <li>
- <p>
- Allow to keep the client connection alive after crunching the
- previous request. Already opened server connections can be
- kept alive, too.
- </p>
- </li>
- <li>
- <p>
- In cgi_show_url_info(), don't forget to prefix URLs that only
- contain http:// or https:// in the path. Fixes #2975765
- reported by Adam Piggott.
- </p>
- </li>
- <li>
- <p>
- Show the 404 CGI page if cgi_send_user_manual() is called
- while local user manual delivery is disabled.
- </p>
- </li>
- </ul>
+ <p>The recommended way to upgrade <span class=
+ "APPLICATION">Privoxy</span> is to backup your old configuration
+ files, install the new ones, verify that <span class=
+ "APPLICATION">Privoxy</span> is working correctly and finally merge
+ back your changes using <span class="APPLICATION">diff</span> and
+ maybe <span class="APPLICATION">patch</span>.</p>
+
+ <p>There are a number of new features in each <span class=
+ "APPLICATION">Privoxy</span> 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 <span class=
+ "APPLICATION">Privoxy</span> isn't always possible anyway.</p>
</li>
+
<li>
- <p>
- Action file improvements:
- </p>
- <ul>
- <li>
- <p>
- Enable user.filter by default. Suggested by David White in
- #3001830.
- </p>
- </li>
- <li>
- <p>
- Block .sitestat.com/. Reported by johnd16 in #3002725.
- </p>
- </li>
- <li>
- <p>
- Block .atemda.com/. Reported by johnd16 in #3002723.
- </p>
- </li>
- <li>
- <p>
- Block js.adlink.net/. Reported by johnd16 in #3002720.
- </p>
- </li>
- <li>
- <p>
- Block .analytics.yahoo.com/. Reported by johnd16 in #3002713.
- </p>
- </li>
- <li>
- <p>
- Block sb.scorecardresearch.com, too. Reported by dg1727 in
- #2992652.
- </p>
- </li>
- <li>
- <p>
- Fix problems noticed on Yahoo mail and news pages.
- </p>
- </li>
- <li>
- <p>
- Remove the too broad yahoo section, only keeping the
- fast-redirects exception as discussed on ijbswa-devel@.
- </p>
- </li>
- <li>
- <p>
- Don't block adesklets.sourceforge.net. Reported in #2974204.
- </p>
- </li>
- <li>
- <p>
- Block chartbeat ping tracking. Reported in #2975895.
- </p>
- </li>
- <li>
- <p>
- Tag CSS and image requests with cautious and medium settings,
- too.
- </p>
- </li>
- <li>
- <p>
- Don't handle view.atdmt.com as image. It's used for
- click-throughs so users should be able to "go there anyway".
- Reported by Adam Piggott in #2975927.
- </p>
- </li>
- <li>
- <p>
- Also let the refresh-tags filter remove invalid refresh tags
- where the 'url=' part is missing. Anonymously reported in
- #2986382. While at it, update the description to mention the
- fact that only refresh tags with refresh times above 9
- seconds are covered.
- </p>
- </li>
- <li>
- <p>
- javascript needs to be blocked with +handle-as-empty-document
- to work around Firefox bug 492459. So move .js blockers from
- +block{Might be a web-bug.} -handle-as-empty-document to
- +block{Might be a web-bug.} +handle-as-empty-document.
- </p>
- </li>
- <li>
- <p>
- ijbswa-Feature Requests-3006719 - Block 160x578 Banners.
- </p>
- </li>
- <li>
- <p>
- Block another omniture tracking domain.
- </p>
- </li>
- <li>
- <p>
- Added a range-requests tagger.
- </p>
- </li>
- <li>
- <p>
- Added two sections to get Flickr's Ajax interface working
- with default pre-settings. If you change the configuration to
- block cookies by default, you'll need additional exceptions.
- Reported by Mathias Homann in #3101419 and by Patrick on
- ijbswa-users@.
- </p>
- </li>
- </ul>
+ <p>Note that some installers remove earlier versions completely,
+ including configuration files, therefore you should really save any
+ important configuration files!</p>
</li>
+
<li>
- <p>
- Documentation improvements:
- </p>
- <ul>
- <li>
- <p>
- Explicitly mention how to match all URLs.
- </p>
- </li>
- <li>
- <p>
- Consistently recommend socks5 in the Tor FAQ entry and
- mention its advantage compared to socks4a. Reported by David
- in #2960129.
- </p>
- </li>
- <li>
- <p>
- Slightly improve the explanation of why filtering may appear
- slower than it is.
- </p>
- </li>
- <li>
- <p>
- Grammar fixes for the ACL section.
- </p>
- </li>
- <li>
- <p>
- Fixed a link to the 'intercepting' entry and add another one.
- </p>
- </li>
- <li>
- <p>
- Rename the 'Other' section to 'Mailing Lists' and reword it
- to make it clear that nobody is forced to use the trackers
- </p>
- </li>
- <li>
- <p>
- Note that 'anonymously' posting on the trackers may not
- always be possible.
- </p>
- </li>
- <li>
- <p>
- Suggest to enable debug 32768 when suspecting parsing
- problems.
- </p>
- </li>
- </ul>
+ <p>On the other hand, other installers don't overwrite existing
+ configuration files, thinking you will want to do that
+ yourself.</p>
</li>
+
<li>
- <p>
- Privoxy-Log-Parser improvements:
- </p>
- <ul>
- <li>
- <p>
- Gather statistics for ressources, methods, and HTTP versions
- used by the client.
- </p>
- </li>
- <li>
- <p>
- Also gather statistics for blocked and redirected requests.
- </p>
- </li>
- <li>
- <p>
- Provide the percentage of keep-alive offers the client
- accepted.
- </p>
- </li>
- <li>
- <p>
- Add a --url-statistics-threshold option.
- </p>
- </li>
- <li>
- <p>
- Add a --host-statistics-threshold option to also gather
- statistics about how many request where made per host.
- </p>
- </li>
- <li>
- <p>
- Fix a bug in handle_loglevel_header() where a 'scan: ' got
- lost.
- </p>
- </li>
- <li>
- <p>
- Add a --shorten-thread-ids option to replace the thread id
- with a decimal number.
- </p>
- </li>
- <li>
- <p>
- Accept and ignore: Looks like we got the last chunk together
- with the server headers. We better stop reading.
- </p>
- </li>
- <li>
- <p>
- Accept and ignore: Continue hack in da house.
- </p>
- </li>
- <li>
- <p>
- Accept and higlight: Rejecting connection from 10.0.0.2.
- Maximum number of connections reached.
- </p>
- </li>
- <li>
- <p>
- Accept and highlight: Loading actions file:
- /usr/local/etc/privoxy/default.action
- </p>
- </li>
- <li>
- <p>
- Accept and highlight: Loading filter file:
- /usr/local/etc/privoxy/default.filter
- </p>
- </li>
- <li>
- <p>
- Accept and highlight: Killed all-caps Host header line: HOST:
- bestproxydb.com
- </p>
- </li>
- <li>
- <p>
- Accept and highlight: Reducing expected bytes to 0. Marking
- the server socket tainted after throwing 4 bytes away.
- </p>
- </li>
- <li>
- <p>
- Accept: Merged multiple header lines to: 'X-FORWARDED-PROTO:
- http X-HOST: 127.0.0.1'
- </p>
- </li>
- </ul>
+ <p><tt class="FILENAME">standard.action</tt> has been merged into
+ the <tt class="FILENAME">default.action</tt> file.</p>
</li>
+
<li>
- <p>
- Code cleanups:
- </p>
- <ul>
- <li>
- <p>
- Remove the next member from the client_state struct. Only the
- main thread needs access to all client states so give it its
- own struct.
- </p>
- </li>
- <li>
- <p>
- Garbage-collect request_contains_null_bytes().
- </p>
- </li>
- <li>
- <p>
- Ditch redundant code in unload_configfile().
- </p>
- </li>
- <li>
- <p>
- Ditch LogGetURLUnderCursor() which doesn't seem to be used
- anywhere.
- </p>
- </li>
- <li>
- <p>
- In write_socket(), remove the write-only variable write_len
- in an ifdef __OS2__ block. Spotted by cppcheck.
- </p>
- </li>
- <li>
- <p>
- In connect_to(), don't declare the variable 'flags' on OS/2
- where it isn't used. Spotted by cppcheck.
- </p>
- </li>
- <li>
- <p>
- Limit the scope of various variables. Spotted by cppcheck.
- </p>
- </li>
- <li>
- <p>
- In add_to_iob(), turn an interestingly looking for loop into
- a boring while loop.
- </p>
- </li>
- <li>
- <p>
- Code cleanup in preparation for external filters.
- </p>
- </li>
- <li>
- <p>
- In listen_loop(), mention the socket on which we accepted the
- connection, not just the source IP address.
- </p>
- </li>
- <li>
- <p>
- In write_socket(), also log the socket we're writing to.
- </p>
- </li>
- <li>
- <p>
- In log_error(), assert that escaped characters get logged
- completely or not at all.
- </p>
- </li>
- <li>
- <p>
- In log_error(), assert that ival and sval have reasonable
- values. There's no reason not to abort() if they don't.
- </p>
- </li>
- <li>
- <p>
- Remove an incorrect cgi_error_unknown() call in a
- cannot-happen-situation in send_crunch_response().
- </p>
- </li>
- <li>
- <p>
- Clean up white-space in http_response definition and move the
- crunch_reason to the beginning.
- </p>
- </li>
- <li>
- <p>
- Turn http_response.reason into an enum and rename it to
- http_response.crunch_reason.
- </p>
- </li>
- <li>
- <p>
- Silence a 'gcc (Debian 4.3.2-1.1) 4.3.2' warning on i686
- GNU/Linux.
- </p>
- </li>
- <li>
- <p>
- Fix white-space in a log message in
- remove_chunked_transfer_coding(). While at it, add a note
- that the message doesn't seem to be entirely correct and
- should be improved later on.
- </p>
- </li>
- </ul>
+ <p>In the default configuration only fatal errors are logged now.
+ You can change that in the <a href="config.html#DEBUG">debug
+ section</a> of the configuration file. You may also want to enable
+ more verbose logging until you verified that the new <span class=
+ "APPLICATION">Privoxy</span> version is working as expected.</p>
</li>
+
<li>
- <p>
- GNUmakefile improvements:
- </p>
- <ul>
- <li>
- <p>
- Use $(SSH) instead of ssh, so one only needs to specify a
- username once.
- </p>
- </li>
- <li>
- <p>
- Removed references to the action feedback thingy that hasn't
- been working for years.
- </p>
- </li>
- <li>
- <p>
- Consistently use shell.sourceforge.net instead of
- shell.sf.net so one doesn't need to check server fingerprints
- twice.
- </p>
- </li>
- <li>
- <p>
- Removed GNUisms in the webserver and webactions targets so
- they work with standard tar.
- </p>
- </li>
- </ul>
+ <p>Three other config file settings are now off by default:
+ <a href="config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>,
+ <a href=
+ "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>,
+ and <a href=
+ "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>. If you
+ use or want these, you will need to explicitly enable them, and be
+ aware of the security issues involved.</p>
</li>
</ul>
-
- <div class="SECT2">
- <h2 class="SECT2">
- <a name="UPGRADERSNOTE">3.1. Note to Upgraders</a>
- </h2>
- <p>
- A quick list of things to be aware of before upgrading from earlier
- versions of <span class="APPLICATION">Privoxy</span>:
- </p>
- <p>
- </p>
- <ul>
- <li>
- <p>
- The recommended way to upgrade <span class=
- "APPLICATION">Privoxy</span> is to backup your old
- configuration files, install the new ones, verify that <span
- class="APPLICATION">Privoxy</span> is working correctly and
- finally merge back your changes using <span class=
- "APPLICATION">diff</span> and maybe <span class=
- "APPLICATION">patch</span>.
- </p>
- <p>
- There are a number of new features in each <span class=
- "APPLICATION">Privoxy</span> 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 <span class=
- "APPLICATION">Privoxy</span> isn't always possible anyway.
- </p>
- </li>
- <li>
- <p>
- Note that some installers remove earlier versions completely,
- including configuration files, therefore you should really save
- any important configuration files!
- </p>
- </li>
- <li>
- <p>
- On the other hand, other installers don't overwrite existing
- configuration files, thinking you will want to do that
- yourself.
- </p>
- </li>
- <li>
- <p>
- <tt class="FILENAME">standard.action</tt> has been merged into
- the <tt class="FILENAME">default.action</tt> file.
- </p>
- </li>
- <li>
- <p>
- In the default configuration only fatal errors are logged now.
- You can change that in the <a href="config.html#DEBUG">debug
- section</a> of the configuration file. You may also want to
- enable more verbose logging until you verified that the new
- <span class="APPLICATION">Privoxy</span> version is working as
- expected.
- </p>
- </li>
- <li>
- <p>
- Three other config file settings are now off by default: <a
- href=
- "config.html#ENABLE-REMOTE-TOGGLE">enable-remote-toggle</a>, <a
- href=
- "config.html#ENABLE-REMOTE-HTTP-TOGGLE">enable-remote-http-toggle</a>,
- and <a href=
- "config.html#ENABLE-EDIT-ACTIONS">enable-edit-actions</a>. If
- you use or want these, you will need to explicitly enable them,
- and be aware of the security issues involved.
- </p>
- </li>
- </ul>
- </div>
- </div>
- <div class="NAVFOOTER">
- <hr width="100%" class="c1">
- <table summary="Footer navigation table" width="100%" border="0"
- cellpadding="0" cellspacing="0">
- <tr>
- <td width="33%" align="left" valign="top">
- <a href="installation.html" accesskey="P">Prev</a>
- </td>
- <td width="34%" align="center" valign="top">
- <a href="index.html" accesskey="H">Home</a>
- </td>
- <td width="33%" align="right" valign="top">
- <a href="quickstart.html" accesskey="N">Next</a>
- </td>
- </tr>
- <tr>
- <td width="33%" align="left" valign="top">
- Installation
- </td>
- <td width="34%" align="center" valign="top">
-
- </td>
- <td width="33%" align="right" valign="top">
- Quickstart to Using Privoxy
- </td>
- </tr>
- </table>
</div>
- </body>
-</html>
+ </div>
+
+ <div class="NAVFOOTER">
+ <hr class="c1" width="100%">
+
+ <table summary="Footer navigation table" width="100%" border="0"
+ cellpadding="0" cellspacing="0">
+ <tr>
+ <td width="33%" align="left" valign="top"><a href="installation.html"
+ accesskey="P">Prev</a></td>
+
+ <td width="34%" align="center" valign="top"><a href="index.html"
+ accesskey="H">Home</a></td>
+ <td width="33%" align="right" valign="top"><a href="quickstart.html"
+ accesskey="N">Next</a></td>
+ </tr>
+
+ <tr>
+ <td width="33%" align="left" valign="top">Installation</td>
+
+ <td width="34%" align="center" valign="top"> </td>
+
+ <td width="33%" align="right" valign="top">Quickstart to Using
+ Privoxy</td>
+ </tr>
+ </table>
+ </div>
+</body>
+</html>