doc/webserver/user-manual/whatsnew.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >What's New in this Release</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy 3.0.18 User Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Installation"
  14 HREF="installation.html"><LINK
  15 REL="NEXT"
  16 TITLE="Quickstart to Using Privoxy"
  17 HREF="quickstart.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"><META
  21 HTTP-EQUIV="Content-Type"
  22 CONTENT="text/html;
  23 charset=ISO-8859-1">
  24 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
  25 </head
  26 ><BODY
  27 CLASS="SECT1"
  28 BGCOLOR="#EEEEEE"
  29 TEXT="#000000"
  30 LINK="#0000FF"
  31 VLINK="#840084"
  32 ALINK="#0000FF"
  33 ><DIV
  34 CLASS="NAVHEADER"
  35 ><TABLE
  36 SUMMARY="Header navigation table"
  37 WIDTH="100%"
  38 BORDER="0"
  39 CELLPADDING="0"
  40 CELLSPACING="0"
  41 ><TR
  42 ><TH
  43 COLSPAN="3"
  44 ALIGN="center"
  45 >Privoxy 3.0.18 User Manual</TH
  46 ></TR
  47 ><TR
  48 ><TD
  49 WIDTH="10%"
  50 ALIGN="left"
  51 VALIGN="bottom"
  52 ><A
  53 HREF="installation.html"
  54 ACCESSKEY="P"
  55 >Prev</A
  56 ></TD
  57 ><TD
  58 WIDTH="80%"
  59 ALIGN="center"
  60 VALIGN="bottom"
  61 ></TD
  62 ><TD
  63 WIDTH="10%"
  64 ALIGN="right"
  65 VALIGN="bottom"
  66 ><A
  67 HREF="quickstart.html"
  68 ACCESSKEY="N"
  69 >Next</A
  70 ></TD
  71 ></TR
  72 ></TABLE
  73 ><HR
  74 ALIGN="LEFT"
  75 WIDTH="100%"></DIV
  76 ><DIV
  77 CLASS="SECT1"
  78 ><H1
  79 CLASS="SECT1"
  80 ><A
  81 NAME="WHATSNEW"
  82 >3. What's New in this Release</A
  83 ></H1
  84 ><P
  85 > <SPAN
  86 CLASS="APPLICATION"
  87 >Privoxy 3.0.17</SPAN
  88 > is a stable release.
  89  The changes since 3.0.16 stable are:</P
  90 ><P
  91 > <P
  92 ></P
  93 ><UL
  94 ><LI
  95 ><P
  96 >    Fixed last-chunk-detection for responses where the content was small
  97     enough to be read with the body, causing Privoxy to wait for the
  98     end of the content until the server closed the connection or the
  99     request timed out. Reported by "Karsten" in #3028326.
 100    </P
 101 ></LI
 102 ><LI
 103 ><P
 104 >    Responses with status code 204 weren't properly detected as body-less
 105     like RFC2616 mandates. Like the previous bug, this caused Privoxy to
 106     wait for the end of the content until the server closed the connection
 107     or the request timed out. Fixes #3022042 and #3025553, reported by a
 108     user with no visible name. Most likely also fixes a bunch of other
 109     AJAX-related problem reports that got closed in the past due to
 110     insufficient information and lack of feedback.
 111    </P
 112 ></LI
 113 ><LI
 114 ><P
 115 >    Fixed an ACL bug that made it impossible to build a blacklist.
 116     Usually the ACL directives are used in a whitelist, which worked
 117     as expected, but blacklisting is still useful for public proxies
 118     where one only needs to deny known abusers access.
 119    </P
 120 ></LI
 121 ><LI
 122 ><P
 123 >    Added LOG_LEVEL_RECEIVED to log the not-yet-parsed data read from the
 124     network. This should make debugging various parsing issues a lot easier.
 125    </P
 126 ></LI
 127 ><LI
 128 ><P
 129 >    The IPv6 code is enabled by default on Windows versions that support it.
 130     Patch submitted by oCameLo in #2942729.
 131    </P
 132 ></LI
 133 ><LI
 134 ><P
 135 >    In mingw32 versions, the user.filter file is reachable through the
 136     GUI, just like default.filter is. Feature request 3040263.
 137    </P
 138 ></LI
 139 ><LI
 140 ><P
 141 >    Added the configure option --enable-large-file-support to set a few
 142     defines that are required by platforms like GNU/Linux to support files
 143     larger then 2GB. Mainly interesting for users without proper logfile
 144     management.
 145    </P
 146 ></LI
 147 ><LI
 148 ><P
 149 >    Logging with "debug 16" no longer stops at the first nul byte which is
 150     pretty useless. Non-printable characters are replaced with their hex value
 151     so the result can't span multiple lines making parsing them harder then
 152     necessary.
 153    </P
 154 ></LI
 155 ><LI
 156 ><P
 157 >    Privoxy logs when reading an action, filter or trust file.
 158    </P
 159 ></LI
 160 ><LI
 161 ><P
 162 >    Fixed incorrect regression test markup which caused a test in
 163     3.0.16 to fail while Privoxy itself was working correctly.
 164     While Privoxy accepts hide-referer, too, the action name is actually
 165     hide-referrer which is also the name used one the final results page,
 166     where the test expected the alias.
 167    </P
 168 ></LI
 169 ><LI
 170 ><P
 171 >    CGI interface improvements:
 172     <P
 173 ></P
 174 ><UL
 175 ><LI
 176 ><P
 177 >      In finish_http_response(), continue to add the 'Connection: close'
 178       header if the client connection will not be kept alive.
 179       Anonymously pointed out in #2987454.
 180      </P
 181 ></LI
 182 ><LI
 183 ><P
 184 >      Apostrophes in block messages no longer cause parse errors
 185       when the blocked page is viewed with JavaScript enabled.
 186       Reported by dg1727 in #3062296.
 187      </P
 188 ></LI
 189 ><LI
 190 ><P
 191 >      Fix a bunch of anchors that used underscores instead of dashes.
 192      </P
 193 ></LI
 194 ><LI
 195 ><P
 196 >      Allow to keep the client connection alive after crunching the previous request.
 197       Already opened server connections can be kept alive, too.
 198      </P
 199 ></LI
 200 ><LI
 201 ><P
 202 >      In cgi_show_url_info(), don't forget to prefix URLs that only contain
 203       http:// or https:// in the path. Fixes #2975765 reported by Adam Piggott.
 204      </P
 205 ></LI
 206 ><LI
 207 ><P
 208 >      Show the 404 CGI page if cgi_send_user_manual() is called while
 209       local user manual delivery is disabled.
 210      </P
 211 ></LI
 212 ></UL
 213 >
 214    </P
 215 ></LI
 216 ><LI
 217 ><P
 218 >    Action file improvements:
 219     <P
 220 ></P
 221 ><UL
 222 ><LI
 223 ><P
 224 >      Enable user.filter by default. Suggested by David White in #3001830.
 225      </P
 226 ></LI
 227 ><LI
 228 ><P
 229 >      Block .sitestat.com/. Reported by johnd16 in #3002725.
 230      </P
 231 ></LI
 232 ><LI
 233 ><P
 234 >      Block .atemda.com/. Reported by johnd16 in #3002723.
 235      </P
 236 ></LI
 237 ><LI
 238 ><P
 239 >      Block js.adlink.net/. Reported by johnd16 in #3002720.
 240      </P
 241 ></LI
 242 ><LI
 243 ><P
 244 >      Block .analytics.yahoo.com/. Reported by johnd16 in #3002713.
 245      </P
 246 ></LI
 247 ><LI
 248 ><P
 249 >      Block sb.scorecardresearch.com, too. Reported by dg1727 in #2992652.
 250      </P
 251 ></LI
 252 ><LI
 253 ><P
 254 >      Fix problems noticed on Yahoo mail and news pages.
 255      </P
 256 ></LI
 257 ><LI
 258 ><P
 259 >      Remove the too broad yahoo section, only keeping the
 260       fast-redirects exception as discussed on ijbswa-devel@.
 261      </P
 262 ></LI
 263 ><LI
 264 ><P
 265 >      Don't block adesklets.sourceforge.net. Reported in #2974204.
 266      </P
 267 ></LI
 268 ><LI
 269 ><P
 270 >      Block chartbeat ping tracking. Reported in #2975895.
 271      </P
 272 ></LI
 273 ><LI
 274 ><P
 275 >      Tag CSS and image requests with cautious and medium settings, too.
 276      </P
 277 ></LI
 278 ><LI
 279 ><P
 280 >      Don't handle view.atdmt.com as image. It's used for click-throughs
 281       so users should be able to "go there anyway".
 282       Reported by Adam Piggott in #2975927.
 283      </P
 284 ></LI
 285 ><LI
 286 ><P
 287 >      Also let the refresh-tags filter remove invalid refresh tags where
 288       the 'url=' part is missing. Anonymously reported in #2986382.
 289       While at it, update the description to mention the fact that only
 290       refresh tags with refresh times above 9 seconds are covered.
 291      </P
 292 ></LI
 293 ><LI
 294 ><P
 295 >      javascript needs to be blocked with +handle-as-empty-document to
 296       work around Firefox bug 492459.  So move .js blockers from
 297       +block{Might be a web-bug.} -handle-as-empty-document to
 298       +block{Might be a web-bug.} +handle-as-empty-document.
 299      </P
 300 ></LI
 301 ><LI
 302 ><P
 303 >      ijbswa-Feature Requests-3006719 - Block 160x578 Banners.
 304      </P
 305 ></LI
 306 ><LI
 307 ><P
 308 >      Block another omniture tracking domain.
 309      </P
 310 ></LI
 311 ><LI
 312 ><P
 313 >      Added a range-requests tagger.
 314      </P
 315 ></LI
 316 ><LI
 317 ><P
 318 >      Added two sections to get Flickr's Ajax interface working with
 319       default pre-settings. If you change the configuration to block
 320       cookies by default, you'll need additional exceptions.
 321       Reported by Mathias Homann in #3101419 and by Patrick on ijbswa-users@.
 322      </P
 323 ></LI
 324 ></UL
 325 >
 326    </P
 327 ></LI
 328 ><LI
 329 ><P
 330 >    Documentation improvements:
 331     <P
 332 ></P
 333 ><UL
 334 ><LI
 335 ><P
 336 >      Explicitly mention how to match all URLs.
 337      </P
 338 ></LI
 339 ><LI
 340 ><P
 341 >      Consistently recommend socks5 in the Tor FAQ entry and mention
 342       its advantage compared to socks4a. Reported by David in #2960129.
 343      </P
 344 ></LI
 345 ><LI
 346 ><P
 347 >      Slightly improve the explanation of why filtering may appear
 348       slower than it is.
 349      </P
 350 ></LI
 351 ><LI
 352 ><P
 353 >      Grammar fixes for the ACL section.
 354      </P
 355 ></LI
 356 ><LI
 357 ><P
 358 >      Fixed a link to the 'intercepting' entry and add another one.
 359      </P
 360 ></LI
 361 ><LI
 362 ><P
 363 >      Rename the 'Other' section to 'Mailing Lists' and reword it
 364       to make it clear that nobody is forced to use the trackers
 365      </P
 366 ></LI
 367 ><LI
 368 ><P
 369 >      Note that 'anonymously' posting on the trackers may not always
 370       be possible.
 371      </P
 372 ></LI
 373 ><LI
 374 ><P
 375 >      Suggest to enable debug 32768 when suspecting parsing problems.
 376      </P
 377 ></LI
 378 ></UL
 379 >
 380    </P
 381 ></LI
 382 ><LI
 383 ><P
 384 >    Privoxy-Log-Parser improvements:
 385     <P
 386 ></P
 387 ><UL
 388 ><LI
 389 ><P
 390 >      Gather statistics for ressources, methods, and HTTP versions
 391       used by the client.
 392      </P
 393 ></LI
 394 ><LI
 395 ><P
 396 >      Also gather statistics for blocked and redirected requests.
 397      </P
 398 ></LI
 399 ><LI
 400 ><P
 401 >      Provide the percentage of keep-alive offers the client accepted.
 402      </P
 403 ></LI
 404 ><LI
 405 ><P
 406 >      Add a --url-statistics-threshold option.
 407      </P
 408 ></LI
 409 ><LI
 410 ><P
 411 >      Add a --host-statistics-threshold option to also gather
 412       statistics about how many request where made per host.
 413      </P
 414 ></LI
 415 ><LI
 416 ><P
 417 >      Fix a bug in handle_loglevel_header() where a 'scan: ' got lost.
 418      </P
 419 ></LI
 420 ><LI
 421 ><P
 422 >      Add a --shorten-thread-ids option to replace the thread id with
 423       a decimal number.
 424      </P
 425 ></LI
 426 ><LI
 427 ><P
 428 >      Accept and ignore: Looks like we got the last chunk together
 429       with the server headers. We better stop reading.
 430      </P
 431 ></LI
 432 ><LI
 433 ><P
 434 >      Accept and ignore: Continue hack in da house.
 435      </P
 436 ></LI
 437 ><LI
 438 ><P
 439 >      Accept and higlight: Rejecting connection from 10.0.0.2.
 440       Maximum number of connections reached.
 441      </P
 442 ></LI
 443 ><LI
 444 ><P
 445 >      Accept and highlight: Loading actions file: /usr/local/etc/privoxy/default.action
 446      </P
 447 ></LI
 448 ><LI
 449 ><P
 450 >      Accept and highlight: Loading filter file: /usr/local/etc/privoxy/default.filter
 451      </P
 452 ></LI
 453 ><LI
 454 ><P
 455 >      Accept and highlight: Killed all-caps Host header line: HOST: bestproxydb.com
 456      </P
 457 ></LI
 458 ><LI
 459 ><P
 460 >      Accept and highlight: Reducing expected bytes to 0. Marking
 461       the server socket tainted after throwing 4 bytes away.
 462      </P
 463 ></LI
 464 ><LI
 465 ><P
 466 >      Accept: Merged multiple header lines to: 'X-FORWARDED-PROTO: http X-HOST: 127.0.0.1'
 467      </P
 468 ></LI
 469 ></UL
 470 >
 471    </P
 472 ></LI
 473 ><LI
 474 ><P
 475 >    Code cleanups:
 476     <P
 477 ></P
 478 ><UL
 479 ><LI
 480 ><P
 481 >      Remove the next member from the client_state struct. Only the main
 482       thread needs access to all client states so give it its own struct.
 483      </P
 484 ></LI
 485 ><LI
 486 ><P
 487 >      Garbage-collect request_contains_null_bytes().
 488      </P
 489 ></LI
 490 ><LI
 491 ><P
 492 >      Ditch redundant code in unload_configfile().
 493      </P
 494 ></LI
 495 ><LI
 496 ><P
 497 >      Ditch LogGetURLUnderCursor() which doesn't seem to be used anywhere.
 498      </P
 499 ></LI
 500 ><LI
 501 ><P
 502 >      In write_socket(), remove the write-only variable write_len in
 503       an ifdef __OS2__ block. Spotted by cppcheck.
 504      </P
 505 ></LI
 506 ><LI
 507 ><P
 508 >      In connect_to(), don't declare the variable 'flags' on OS/2 where
 509       it isn't used. Spotted by cppcheck.
 510      </P
 511 ></LI
 512 ><LI
 513 ><P
 514 >      Limit the scope of various variables. Spotted by cppcheck.
 515      </P
 516 ></LI
 517 ><LI
 518 ><P
 519 >      In add_to_iob(), turn an interestingly looking for loop into a
 520       boring while loop.
 521      </P
 522 ></LI
 523 ><LI
 524 ><P
 525 >      Code cleanup in preparation for external filters.
 526      </P
 527 ></LI
 528 ><LI
 529 ><P
 530 >      In listen_loop(), mention the socket on which we accepted the
 531       connection, not just the source IP address.
 532      </P
 533 ></LI
 534 ><LI
 535 ><P
 536 >      In write_socket(), also log the socket we're writing to.
 537      </P
 538 ></LI
 539 ><LI
 540 ><P
 541 >      In log_error(), assert that escaped characters get logged
 542       completely or not at all.
 543      </P
 544 ></LI
 545 ><LI
 546 ><P
 547 >      In log_error(), assert that ival and sval have reasonable values.
 548       There's no reason not to abort() if they don't.
 549      </P
 550 ></LI
 551 ><LI
 552 ><P
 553 >      Remove an incorrect cgi_error_unknown() call in a
 554       cannot-happen-situation in send_crunch_response().
 555      </P
 556 ></LI
 557 ><LI
 558 ><P
 559 >      Clean up white-space in http_response definition and
 560       move the crunch_reason to the beginning.
 561      </P
 562 ></LI
 563 ><LI
 564 ><P
 565 >      Turn http_response.reason into an enum and rename it
 566       to http_response.crunch_reason.
 567      </P
 568 ></LI
 569 ><LI
 570 ><P
 571 >      Silence a 'gcc (Debian 4.3.2-1.1) 4.3.2' warning on i686 GNU/Linux.
 572      </P
 573 ></LI
 574 ><LI
 575 ><P
 576 >      Fix white-space in a log message in remove_chunked_transfer_coding().
 577       While at it, add a note that the message doesn't seem to
 578       be entirely correct and should be improved later on.
 579      </P
 580 ></LI
 581 ></UL
 582 >
 583    </P
 584 ></LI
 585 ><LI
 586 ><P
 587 >    GNUmakefile improvements:
 588     <P
 589 ></P
 590 ><UL
 591 ><LI
 592 ><P
 593 >      Use $(SSH) instead of ssh, so one only needs to specify a username once.
 594      </P
 595 ></LI
 596 ><LI
 597 ><P
 598 >      Removed references to the action feedback thingy that hasn't been
 599       working for years.
 600      </P
 601 ></LI
 602 ><LI
 603 ><P
 604 >      Consistently use shell.sourceforge.net instead of shell.sf.net so
 605       one doesn't need to check server fingerprints twice.
 606      </P
 607 ></LI
 608 ><LI
 609 ><P
 610 >      Removed GNUisms in the webserver and webactions targets so they
 611       work with standard tar.
 612      </P
 613 ></LI
 614 ></UL
 615 >
 616    </P
 617 ></LI
 618 ></UL
 619 ></P
 620 ><DIV
 621 CLASS="SECT2"
 622 ><H2
 623 CLASS="SECT2"
 624 ><A
 625 NAME="UPGRADERSNOTE"
 626 >3.1. Note to Upgraders</A
 627 ></H2
 628 ><P
 629 > A quick list of things to be aware of before upgrading from earlier
 630  versions of <SPAN
 631 CLASS="APPLICATION"
 632 >Privoxy</SPAN
 633 >:</P
 634 ><P
 635 > <P
 636 ></P
 637 ><UL
 638 ><LI
 639 ><P
 640 >   The recommended way to upgrade <SPAN
 641 CLASS="APPLICATION"
 642 >Privoxy</SPAN
 643 > is to backup your old
 644    configuration files, install the new ones, verify that <SPAN
 645 CLASS="APPLICATION"
 646 >Privoxy</SPAN
 647 >
 648    is working correctly and finally merge back your changes using
 649    <SPAN
 650 CLASS="APPLICATION"
 651 >diff</SPAN
 652 > and maybe <SPAN
 653 CLASS="APPLICATION"
 654 >patch</SPAN
 655 >.
 656   </P
 657 ><P
 658 >   There are a number of new features in each <SPAN
 659 CLASS="APPLICATION"
 660 >Privoxy</SPAN
 661 > release and
 662    most of them have to be explicitly enabled in the configuration
 663    files. Old configuration files obviously don't do that and due
 664    to syntax changes using old configuration files with a new
 665    <SPAN
 666 CLASS="APPLICATION"
 667 >Privoxy</SPAN
 668 > isn't always possible anyway.
 669   </P
 670 ></LI
 671 ><LI
 672 ><P
 673 >
 674     Note that some installers remove earlier versions completely,
 675     including configuration files, therefore you should really save
 676     any important configuration files!
 677   </P
 678 ></LI
 679 ><LI
 680 ><P
 681 >
 682    On the other hand, other installers don't overwrite existing configuration
 683    files, thinking you will want to do that yourself.
 684   </P
 685 ></LI
 686 ><LI
 687 ><P
 688 >
 689    <TT
 690 CLASS="FILENAME"
 691 >standard.action</TT
 692 > has been merged into
 693    the <TT
 694 CLASS="FILENAME"
 695 >default.action</TT
 696 > file.
 697   </P
 698 ></LI
 699 ><LI
 700 ><P
 701 >   In the default configuration only fatal errors are logged now.
 702    You can change that in the <A
 703 HREF="config.html#DEBUG"
 704 >debug section</A
 705 >
 706    of the configuration file. You may also want to enable more verbose
 707    logging until you verified that the new <SPAN
 708 CLASS="APPLICATION"
 709 >Privoxy</SPAN
 710 > version is working
 711    as expected.
 712   </P
 713 ></LI
 714 ><LI
 715 ><P
 716 >     Three other config file settings are now off by default:
 717      <A
 718 HREF="config.html#ENABLE-REMOTE-TOGGLE"
 719 >enable-remote-toggle</A
 720 >,
 721      <A
 722 HREF="config.html#ENABLE-REMOTE-HTTP-TOGGLE"
 723 >enable-remote-http-toggle</A
 724 >,
 725      and  <A
 726 HREF="config.html#ENABLE-EDIT-ACTIONS"
 727 >enable-edit-actions</A
 728 >.
 729      If you use or want these, you will need to explicitly enable them, and
 730      be aware of the security issues involved.
 731     </P
 732 ></LI
 733 ></UL
 734 ></P
 735 ></DIV
 736 ></DIV
 737 ><DIV
 738 CLASS="NAVFOOTER"
 739 ><HR
 740 ALIGN="LEFT"
 741 WIDTH="100%"><TABLE
 742 SUMMARY="Footer navigation table"
 743 WIDTH="100%"
 744 BORDER="0"
 745 CELLPADDING="0"
 746 CELLSPACING="0"
 747 ><TR
 748 ><TD
 749 WIDTH="33%"
 750 ALIGN="left"
 751 VALIGN="top"
 752 ><A
 753 HREF="installation.html"
 754 ACCESSKEY="P"
 755 >Prev</A
 756 ></TD
 757 ><TD
 758 WIDTH="34%"
 759 ALIGN="center"
 760 VALIGN="top"
 761 ><A
 762 HREF="index.html"
 763 ACCESSKEY="H"
 764 >Home</A
 765 ></TD
 766 ><TD
 767 WIDTH="33%"
 768 ALIGN="right"
 769 VALIGN="top"
 770 ><A
 771 HREF="quickstart.html"
 772 ACCESSKEY="N"
 773 >Next</A
 774 ></TD
 775 ></TR
 776 ><TR
 777 ><TD
 778 WIDTH="33%"
 779 ALIGN="left"
 780 VALIGN="top"
 781 >Installation</TD
 782 ><TD
 783 WIDTH="34%"
 784 ALIGN="center"
 785 VALIGN="top"
 786 >&nbsp;</TD
 787 ><TD
 788 WIDTH="33%"
 789 ALIGN="right"
 790 VALIGN="top"
 791 >Quickstart to Using Privoxy</TD
 792 ></TR
 793 ></TABLE
 794 ></DIV
 795 ></BODY
 796 ></HTML
 797 >