doc/webserver/faq/trouble.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
   2 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   3 <html>
   4   <head>
   5     <meta name="generator" content="HTML Tidy, see www.w3.org">
   6     <title>
   7       Troubleshooting
   8     </title>
   9     <meta name="GENERATOR" content=
  10     "Modular DocBook HTML Stylesheet Version 1.79">
  11     <link rel="HOME" title="Privoxy Frequently Asked Questions" href=
  12     "index.html">
  13     <link rel="PREVIOUS" title="Miscellaneous" href="misc.html">
  14     <link rel="NEXT" title=
  15     "Contacting the developers, Bug Reporting and Feature Requests" href=
  16     "contact.html">
  17     <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
  18     <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  19 <style type="text/css">
  20  body {
  21   background-color: #EEEEEE;
  22   color: #000000;
  23  }
  24  :link { color: #0000FF }
  25  :visited { color: #840084 }
  26  :active { color: #0000FF }
  27  hr.c1 {text-align: left}
  28 </style>
  29   </head>
  30   <body class="SECT1">
  31     <div class="NAVHEADER">
  32       <table summary="Header navigation table" width="100%" border="0"
  33       cellpadding="0" cellspacing="0">
  34         <tr>
  35           <th colspan="3" align="center">
  36             Privoxy Frequently Asked Questions
  37           </th>
  38         </tr>
  39         <tr>
  40           <td width="10%" align="left" valign="bottom">
  41             <a href="misc.html" accesskey="P">Prev</a>
  42           </td>
  43           <td width="80%" align="center" valign="bottom">
  44           </td>
  45           <td width="10%" align="right" valign="bottom">
  46             <a href="contact.html" accesskey="N">Next</a>
  47           </td>
  48         </tr>
  49       </table>
  50       <hr width="100%" class="c1">
  51     </div>
  52     <div class="SECT1">
  53       <h1 class="SECT1">
  54         <a name="TROUBLE">5. Troubleshooting</a>
  55       </h1>
  56       <div class="SECT2">
  57         <h3 class="SECT2">
  58           <a name="AEN1091">5.1. I cannot connect to any websites. Or, I am
  59           getting <span class="QUOTE">"connection refused"</span> message
  60           with every web page. Why?</a>
  61         </h3>
  62         <p>
  63           There are several possibilities:
  64         </p>
  65         <ul>
  66           <li>
  67             <p>
  68               <span class="APPLICATION">Privoxy</span> is not running.
  69               Solution: verify that <span class="APPLICATION">Privoxy</span>
  70               is installed correctly, has not crashed, and is indeed running.
  71               Turn on <span class="APPLICATION">Privoxy's</span> logging, and
  72               look at the logs to see what they say.
  73             </p>
  74           </li>
  75           <li>
  76             <p>
  77               Or your browser is configured for a different port than what
  78               <span class="APPLICATION">Privoxy</span> is using. Solution:
  79               verify that <span class="APPLICATION">Privoxy</span> and your
  80               browser are set to the same port (<tt class=
  81               "LITERAL">listen-address</tt>).
  82             </p>
  83           </li>
  84           <li>
  85             <p>
  86               Or if using a forwarding rule, you have a configuration problem
  87               or a problem with a host in the forwarding chain. Solution:
  88               temporarily alter your configuration and take the forwarders
  89               out of the equation.
  90             </p>
  91           </li>
  92           <li>
  93             <p>
  94               Or you have a firewall that is interfering and blocking you.
  95               Solution: try disabling or removing the firewall as a simple
  96               test.
  97             </p>
  98           </li>
  99         </ul>
 100       </div>
 101       <div class="SECT2">
 102         <h3 class="SECT2">
 103           <a name="ERROR503">5.2. Why am I getting a 503 Error
 104           (WSAECONNREFUSED) on every page?</a>
 105         </h3>
 106         <p>
 107           More than likely this is a problem with your TCP/IP networking.
 108           ZoneAlarm has been reported to cause this symptom -- even if not
 109           running! The solution is to either fight the ZA configuration, or
 110           uninstall ZoneAlarm, and then find something better behaved in its
 111           place. Other personal firewall type products may cause similar type
 112           problems if not configured correctly.
 113         </p>
 114       </div>
 115       <div class="SECT2">
 116         <h3 class="SECT2">
 117           <a name="AEN1114">5.3. I just added a new rule, but the steenkin ad
 118           is still getting through. How?</a>
 119         </h3>
 120         <p>
 121           If the ad had been displayed before you added its URL, it will
 122           probably be held in the browser's cache for some time, so it will
 123           be displayed without the need for any request to the server, and
 124           <span class="APPLICATION">Privoxy</span> will not be involved.
 125           Flush the browser's caches, and then try again.
 126         </p>
 127         <p>
 128           If this doesn't help, you probably have an error in the rule you
 129           applied. Try pasting the full URL of the offending ad into <a href=
 130           "http://config.privoxy.org/show-url-info" target=
 131           "_top">http://config.privoxy.org/show-url-info</a> and see if it
 132           really matches your new rule. Blocking ads is like blocking spam: a
 133           lot of tinkering is required to stay ahead of the game. And
 134           remember you need to block the URL of the ad in question, which may
 135           be entirely different from the site URL itself. Most ads are hosted
 136           on different servers than the main site itself. If you right-click
 137           on the ad, you should be able to get all the relevant information
 138           you need. Alternately, you can find the correct URL by looking at
 139           <span class="APPLICATION">Privoxy's</span> logs (you may need to
 140           enable logging in the main config file if its disabled).
 141         </p>
 142         <p>
 143           Below is a slightly modified real-life log snippet that originates
 144           with one requested URL: <tt class="LITERAL">www.example.com</tt>
 145           (name of site was changed for this example, the number of requests
 146           is real). You can see in this the complexity of what goes into
 147           making up this one <span class="QUOTE">"page"</span>. There are
 148           eight different domains involved here, with thirty two separate
 149           URLs requested in all, making up all manner of images, Shockwave
 150           Flash, JavaScript, CSS stylesheets, scripts, and other related
 151           content. Some of this content is obviously <span class=
 152           "QUOTE">"good"</span> or <span class="QUOTE">"bad"</span>, but not
 153           all. Many of the more questionable looking requests, are going to
 154           outside domains that seem to be identifying themselves with
 155           suspicious looking names, making our job a little easier. <span
 156           class="APPLICATION">Privoxy</span> has <span class=
 157           "QUOTE">"crunched"</span> (meaning caught and BLOCKED) quite a few
 158           items in this example, but perhaps missed a few as well.
 159         </p>
 160         <table border="0" bgcolor="#E0E0E0" width="100%">
 161           <tr>
 162             <td>
 163 <pre class="SCREEN">
 164 Request: www.example.com/
 165 Request: www.example.com/favicon.ico
 166 Request: img.example.com/main.css
 167 Request: img.example.com/sr.js
 168 Request: example.betamarker.com/example.html
 169 Request: www.lik-sang.com/Banners/bestsellers/skyscraper.php?likref=BSellers
 170 Request: img.example.com/pb.png
 171 Request: www.google-analytics.com/urchin.js crunch! (Blocked)
 172 Request: www.advertising-department.com/ats/switch.ps.php?26856 crunch! (Blocked)
 173 Request: img.example.com/p.gif
 174 Request: www.popuptraffic.com/assign.php?l=example&amp;mode=behind crunch! (Blocked)
 175 Request: www.popuptraffic.com/scripts/popup.php?hid=5c3cf&amp;tmpl=PBa.tmpl crunch! (Blocked)
 176 Request: www.popuptraffic.com/assign.php?l=example crunch! (Blocked)
 177 Request: www.lik-sang.com/Banners/best_sellers/best_sellers.css
 178 Request: www.adtrak.net/adx.js crunch! (Blocked)
 179 Request: img.example.com/hbg.gif
 180 Request: img.example.com/example.jpg
 181 Request: img.example.com/mt.png
 182 Request: img.example.com/mm.png
 183 Request: img.example.com/mb.png
 184 Request: www.popuptraffic.com/scripts/popup.php?hid=a71b91fa5&amp;tmpl=Ua.tmp crunch! (Blocked)
 185 Request: www.example.com/tracker.js
 186 Request: www.lik-sang.com/Banners/best_sellers/lsi_head.gif
 187 Request: www.adtrak.net/adjs.php?n=020548130&amp;what=zone:61 crunch! (Blocked)
 188 Request: www.adtrak.net/adjs.php?n=463594413&amp;what=zone:58&amp;source=Ua crunch! (Blocked)
 189 Request: www.lik-sang.com/Banners/best_sellers/bottomani.swf
 190 Request: mmm.elitemediagroup.net/install.php?allowpop=no&amp;popupmincook=0&amp;allowsp2=1 crunch! (Blocked)
 191 Request: www.example.com/tracker.js?screen=1400x1050&amp;win=962x693
 192 Request: www.adtrak.net/adlog.php?bannerid=1309&amp;clientid=439&amp;zoneid=61 crunch! (Blocked)
 193 Request: 66.70.21.80/scripts/click.php?hid=5c3cf599a9efd0320d26&amp;si
 194 Request: 66.70.21.80/img/pixel.gif
 195 Request: www.adtrak.net/adlog.php?bannerid=1309&amp;clientid=439&amp;zoneid=58&amp;source=Ua&amp;block=86400 crunch! (Blocked)
 196 Request: 66.70.21.80/scripts/click.php?hid=a71b9f6504b0c5681fa5&amp;si=Ua
 197 </pre>
 198             </td>
 199           </tr>
 200         </table>
 201
 202         <p>
 203           Despite 12 out of 32 requests being blocked, the page looked, and
 204           seemed to behave perfectly <span class="QUOTE">"normal"</span>
 205           (minus some ads, of course).
 206         </p>
 207       </div>
 208       <div class="SECT2">
 209         <h3 class="SECT2">
 210           <a name="BADSITE">5.4. One of my favorite sites does not work with
 211           Privoxy. What can I do?</a>
 212         </h3>
 213         <p>
 214           First verify that it is indeed a <span class=
 215           "APPLICATION">Privoxy</span> problem, by toggling off <span class=
 216           "APPLICATION">Privoxy</span> through <a href=
 217           "http://config.privoxy.org/toggle" target=
 218           "_top">http://config.privoxy.org/toggle</a> (the toggle feature may
 219           need to be enabled in the main <tt class="FILENAME">config</tt>),
 220           and then shift-reloading the problem page (i.e. holding down the
 221           shift key while clicking reload. Alternatively, flush your
 222           browser's disk and memory caches).
 223         </p>
 224         <p>
 225           If the problem went away, we know we have a configuration related
 226           problem. Now go to <a href=
 227           "http://config.privoxy.org/show-url-info" target=
 228           "_top">http://config.privoxy.org/show-url-info</a> and paste the
 229           full URL of the page in question into the prompt. See which actions
 230           are being applied to the URL, and which matches in which actions
 231           files are responsible for that. It might be helpful also to look at
 232           your logs for this site too, to see what else might be happening
 233           (note: logging may need to be enabled in the main config file).
 234           Many sites are complex and require a number of related pages to
 235           help present their content. Look at what else might be used by the
 236           page in question, and what of that might be <span class=
 237           "emphasis"><i class="EMPHASIS">required</i></span>. Now, armed with
 238           this information, go to <a href=
 239           "http://config.privoxy.org/show-status" target=
 240           "_top">http://config.privoxy.org/show-status</a> and select the
 241           appropriate actions files for editing.
 242         </p>
 243         <p>
 244           You can now either look for a section which disables the actions
 245           that you suspect to cause the problem and add a pattern for your
 246           site there, or make up a completely new section for your site. In
 247           any case, the recommended way is to disable only the prime suspect,
 248           reload the problem page, and only if the problem persists, disable
 249           more and more actions until you have identified the culprit. You
 250           may or may not want to turn the other actions on again. Remember to
 251           flush your browser's caches in between any such changes!
 252         </p>
 253         <p>
 254           Alternately, if you are comfortable with a text editor, you can
 255           accomplish the same thing by editing the appropriate actions file.
 256           Probably the easiest way to deal with such problems when editing by
 257           hand is to add your site to a <tt class="LITERAL">{ fragile }</tt>
 258           section in <tt class="FILENAME">user.action</tt>, which is an alias
 259           that turns off most <span class="QUOTE">"dangerous"</span> actions,
 260           but is also likely to turn off more actions then needed, and thus
 261           lower your privacy and protection more than necessary,
 262         </p>
 263         <p>
 264           Troubleshooting actions is discussed in more detail in the <a href=
 265           "../user-manual/appendix.html#ACTIONSANAT" target="_top">User
 266           Manual appendix, Troubleshooting: the Anatomy of an Action</a>.
 267           There is also an <a href=
 268           "../user-manual/actions-file.html#ACT-EXAMPLES" target=
 269           "_top">actions tutorial</a> with general configuration information
 270           and examples.
 271         </p>
 272         <p>
 273           As a last resort, you can always see if your browser has a setting
 274           that will bypass the proxy setting for selective sites. Modern
 275           browsers can do this.
 276         </p>
 277       </div>
 278       <div class="SECT2">
 279         <h3 class="SECT2">
 280           <a name="DUN">5.5. After installing Privoxy, I have to log in every
 281           time I start IE. What gives?</a>
 282         </h3>
 283         <p>
 284           This is a quirk that effects the installation of <span class=
 285           "APPLICATION">Privoxy</span>, in conjunction with Internet Explorer
 286           and Internet Connection Sharing on Windows 2000 and Windows XP. The
 287           symptoms may appear to be corrupted or invalid DUN settings, or
 288           passwords.
 289         </p>
 290         <p>
 291           When setting up an NT based Windows system with <span class=
 292           "APPLICATION">Privoxy</span> you may find that things do not seem
 293           to be doing what you expect. When you set your system up you will
 294           probably have set up Internet Connection Sharing (ICS) with Dial up
 295           Networking (DUN) when logged in with administrator privileges. You
 296           will probably have made this DUN connection available to other
 297           accounts that you may have set-up on your system. E.g. Mum or Dad
 298           sets up the system and makes accounts suitably configured for the
 299           kids.
 300         </p>
 301         <p>
 302           When setting up <span class="APPLICATION">Privoxy</span> in this
 303           environment you will have to alter the proxy set-up of Internet
 304           Explorer (IE) for the specific DUN connection on which you wish to
 305           use <span class="APPLICATION">Privoxy</span>. When you do this the
 306           ICS DUN set-up becomes user specific. In this instance you will see
 307           no difference if you change the DUN connection under the account
 308           used to set-up the connection. However when you do this from
 309           another user you will notice that the DUN connection changes to
 310           make available to "Me only". You will also find that you have to
 311           store the password under each different user!
 312         </p>
 313         <p>
 314           The reason for this is that each user's set-up for IE is user
 315           specific. Each set-up DUN connection and each LAN connection in IE
 316           store the settings for each user individually. As such this
 317           enforces individual configurations rather than common ones. Hence
 318           the first time you use a DUN connection after re-booting your
 319           system it may not perform as you expect, and prompt you for the
 320           password. Just set and save the password again and all should be
 321           OK.
 322         </p>
 323         <p>
 324           [Thanks to Ray Griffith for this submission.]
 325         </p>
 326       </div>
 327       <div class="SECT2">
 328         <h3 class="SECT2">
 329           <a name="FTP">5.6. I cannot connect to any FTP sites. Privoxy is
 330           blocking me.</a>
 331         </h3>
 332         <p>
 333           <span class="APPLICATION">Privoxy</span> cannot act as a proxy for
 334           FTP traffic, so do not configure your browser to use <span class=
 335           "APPLICATION">Privoxy</span> as an FTP proxy. The same is true for
 336           <span class="emphasis"><i class="EMPHASIS">any protocol other than
 337           HTTP or HTTPS (SSL)</i></span>.
 338         </p>
 339         <p>
 340           Most browsers understand FTP as well as HTTP. If you connect to a
 341           site, with a URL like <tt class=
 342           "LITERAL">ftp://ftp.example.com</tt>, your browser is making an FTP
 343           connection, and not a HTTP connection. So while your browser may
 344           speak FTP, <span class="APPLICATION">Privoxy</span> does not, and
 345           cannot proxy such traffic.
 346         </p>
 347         <p>
 348           To complicate matters, some systems may have a generic <span class=
 349           "QUOTE">"proxy"</span> setting, which will enable various
 350           protocols, including <span class="emphasis"><i class=
 351           "EMPHASIS">both</i></span> HTTP and FTP proxying! So it is possible
 352           to accidentally enable FTP proxying in these cases. And of course,
 353           if this happens, <span class="APPLICATION">Privoxy</span> will
 354           indeed cause problems since it does not know FTP. Newer version
 355           will give a sane error message if a FTP connection is attempted.
 356           Just disable the FTP setting and all will be well again.
 357         </p>
 358         <p>
 359           Will <span class="APPLICATION">Privoxy</span> ever proxy FTP
 360           traffic? Unlikely. There just is not much reason, and the work to
 361           make this happen is more than it may seem.
 362         </p>
 363       </div>
 364       <div class="SECT2">
 365         <h3 class="SECT2">
 366           <a name="MACOSXIE">5.7. In Mac OS X, I can't configure Microsoft
 367           Internet Explorer to use Privoxy as the HTTP proxy.</a>
 368         </h3>
 369         <p>
 370           Microsoft Internet Explorer (in versions like 5.1) respects
 371           system-wide network settings. In order to change the HTTP proxy,
 372           open System Preferences, and click on the Network icon. In the
 373           settings pane that comes up, click on the Proxies tab. Ensure the
 374           "Web Proxy (HTTP)" checkbox is checked and enter <tt class=
 375           "LITERAL">127.0.0.1</tt> in the entry field. Enter <tt class=
 376           "LITERAL">8118</tt> in the Port field. The next time you start IE,
 377           it should reflect these values.
 378         </p>
 379       </div>
 380       <div class="SECT2">
 381         <h3 class="SECT2">
 382           <a name="MACOSXUNINSTALL">5.8. In Mac OS X, I dragged the Privoxy
 383           folder to the trash in order to uninstall it. Now the finder tells
 384           me I don't have sufficient privileges to empty the trash.</a>
 385         </h3>
 386         <p>
 387           Note: This ONLY applies to privoxy 3.0.6 and earlier.
 388         </p>
 389         <p>
 390           Just dragging the <span class="APPLICATION">Privoxy</span> folder
 391           to the trash is not enough to delete it. <span class=
 392           "APPLICATION">Privoxy</span> supplies an <span class=
 393           "APPLICATION">uninstall.command</span> file that takes care of
 394           these details. Open the trash, drag the <span class=
 395           "APPLICATION">uninstall.command</span> file out of the trash and
 396           double-click on it. You will be prompted for confirmation and the
 397           administration password.
 398         </p>
 399         <p>
 400           The trash may still appear full after this command; emptying the
 401           trash from the desktop should make it appear empty again.
 402         </p>
 403       </div>
 404       <div class="SECT2">
 405         <h3 class="SECT2">
 406           <a name="MACOSXIMAGES">5.9. In Mac OS X Panther (10.3), images
 407           often fail to load and/or I experience random delays in page
 408           loading. I'm using <tt class="LITERAL">localhost</tt> as my
 409           browser's proxy setting.</a>
 410         </h3>
 411         <p>
 412           We believe this is due to an IPv6-related bug in Mac OS X, but
 413           don't fully understand the issue yet. In any case, changing the
 414           proxy setting to <tt class="LITERAL">127.0.0.1</tt> instead of <tt
 415           class="LITERAL">localhost</tt> works around the problem.
 416         </p>
 417       </div>
 418       <div class="SECT2">
 419         <h3 class="SECT2">
 420           <a name="BLANKPAGE">5.10. I get a completely blank page at one
 421           site. <span class="QUOTE">"View Source"</span> shows only: <span
 422           class=
 423           "MARKUP">&lt;html&gt;&lt;body&gt;&lt;/body&gt;&lt;/html&gt;</span>.
 424           Without Privoxy the page loads fine.</a>
 425         </h3>
 426         <p>
 427           Chances are that the site suffers from a bug in <a href=
 428           "http://www.php.net/" target="_top"><span class=
 429           "APPLICATION">PHP</span></a>, which results in empty pages being
 430           sent if the client explicitly requests an uncompressed page, like
 431           <span class="APPLICATION">Privoxy</span> does. This bug has been
 432           fixed in PHP 4.2.3.
 433         </p>
 434         <p>
 435           To find out if this is in fact the source of the problem, try
 436           adding the site to a <tt class="LITERAL">-prevent-compression</tt>
 437           section in <tt class="FILENAME">user.action</tt>:
 438         </p>
 439         <table border="0" bgcolor="#E0E0E0" width="100%">
 440           <tr>
 441             <td>
 442 <pre class="SCREEN">
 443    # Make exceptions for ill-behaved sites:
 444    #
 445    {-prevent-compression}
 446     .example.com
 447 </pre>
 448             </td>
 449           </tr>
 450         </table>
 451         <p>
 452           If that works, you may also want to report the problem to the
 453           site's webmasters, telling them to use zlib.output_compression
 454           instead of ob_gzhandler in their PHP applications (workaround) or
 455           upgrade to PHP 4.2.3 or later (fix).
 456         </p>
 457       </div>
 458       <div class="SECT2">
 459         <h3 class="SECT2">
 460           <a name="NOHOSTNAME">5.11. My logs show many <span class=
 461           "QUOTE">"Unable to get my own hostname"</span> lines. Why?</a>
 462         </h3>
 463         <p>
 464           <span class="APPLICATION">Privoxy</span> tries to get the hostname
 465           of the system its running on from the IP address of the system
 466           interface it is bound to (from the <tt class="FILENAME">config</tt>
 467           file <span class="emphasis"><i class=
 468           "EMPHASIS">listen-address</i></span> setting). If the system cannot
 469           supply this information, <span class="APPLICATION">Privoxy</span>
 470           logs this condition.
 471         </p>
 472         <p>
 473           Typically, this would be considered a minor system configuration
 474           error. It is not a fatal error to <span class=
 475           "APPLICATION">Privoxy</span> however, but may result in a much
 476           slower response from <span class="APPLICATION">Privoxy</span> on
 477           some platforms due to DNS timeouts.
 478         </p>
 479         <p>
 480           This can be caused by a problem with the local <tt class=
 481           "FILENAME">hosts</tt> file. If this file has been changed from the
 482           original, try reverting it to see if that helps. Make sure whatever
 483           name(s) are used for the local system, that they resolve both ways.
 484         </p>
 485         <p>
 486           You should also be able to work around the problem with the <a
 487           href="../user-manual/config.html#HOSTNAME" target="_top">hostname
 488           option</a>.
 489         </p>
 490       </div>
 491       <div class="SECT2">
 492         <h3 class="SECT2">
 493           <a name="INUSE">5.12. When I try to launch Privoxy, I get an error
 494           message <span class="QUOTE">"port 8118 is already in use"</span>
 495           (or similar wording). Why?</a>
 496         </h3>
 497         <p>
 498           Port 8118 is <span class="APPLICATION">Privoxy's</span> default TCP
 499           <span class="QUOTE">"listening"</span> port. Typically this message
 500           would mean that there is already one instance of <span class=
 501           "APPLICATION">Privoxy</span> running, and your system is actually
 502           trying to start a second <span class="APPLICATION">Privoxy</span>
 503           on the same port, which will not work. (You can have multiple
 504           instances but they must be assigned different ports.) How and why
 505           this might happen varies from platform to platform, but you need to
 506           check your installation and start-up procedures.
 507         </p>
 508       </div>
 509       <div class="SECT2">
 510         <h3 class="SECT2">
 511           <a name="DEMORONIZER">5.13. Pages with UTF-8 fonts are garbled.</a>
 512         </h3>
 513         <p>
 514           This is caused by the <span class="QUOTE">"demoronizer"</span>
 515           filter. You should either upgrade <span class=
 516           "APPLICATION">Privoxy</span>, or at least upgrade to the most
 517           recent <tt class="FILENAME">default.action</tt> file available from
 518           <a href=
 519           "http://sourceforge.net/project/showfiles.php?group_id=11118"
 520           target="_top">SourceForge</a>. Or you can simply disable the
 521           demoronizer filter.
 522         </p>
 523       </div>
 524       <div class="SECT2">
 525         <h3 class="SECT2">
 526           <a name="DEMORONIZER2">5.14. Why are binary files (such as images)
 527           corrupted when Privoxy is used?</a>
 528         </h3>
 529         <p>
 530           This may also be caused by the <span class=
 531           "QUOTE">"demoronizer"</span> filter, in conjunction with a web
 532           server that is misreporting the content type. Binary files are
 533           exempted from <span class="APPLICATION">Privoxy's</span> filtering
 534           (unless the web server by mistake says the file is something else).
 535           Either upgrade <span class="APPLICATION">Privoxy</span>, or go to
 536           the most recent <tt class="FILENAME">default.action</tt> file
 537           available from <a href=
 538           "http://sourceforge.net/project/showfiles.php?group_id=11118"
 539           target="_top">SourceForge</a>.
 540         </p>
 541       </div>
 542       <div class="SECT2">
 543         <h3 class="SECT2">
 544           <a name="DEMORONIZER3">5.15. What is the <span class=
 545           "QUOTE">"demoronizer"</span> and why is it there?</a>
 546         </h3>
 547         <p>
 548           The original demoronizer was a Perl script that cleaned up HTML
 549           pages which were created with certain Microsoft products. MS has
 550           used proprietary extensions to standardized font encodings (ISO
 551           8859-1), which has caused problems for pages that are viewed with
 552           non-Microsoft products (and are expecting to see a standard set of
 553           fonts). The demoronizer corrected these errors so the pages
 554           displayed correctly. <span class="APPLICATION">Privoxy</span>
 555           borrowed from this script, introducing a filter based on the
 556           original demoronizer, which in turn could correct these errors on
 557           the fly.
 558         </p>
 559         <p>
 560           But this is only needed in some situations, and will cause serious
 561           problems in some other situations.
 562         </p>
 563         <p>
 564           If you are using Microsoft products, you do not need it. If you
 565           need to view pages with UTF-8 characters (such as Cyrillic or
 566           Chinese), then it will cause corruption of the fonts, and thus
 567           <span class="emphasis"><i class="EMPHASIS">should not be
 568           on</i></span>.
 569         </p>
 570         <p>
 571           On the other hand, if you use non-Microsoft products, and you
 572           occasionally notice weird characters on pages, you might want to
 573           try it.
 574         </p>
 575       </div>
 576       <div class="SECT2">
 577         <h3 class="SECT2">
 578           <a name="WINDOWOPEN">5.16. Why do I keep seeing <span class=
 579           "QUOTE">"PrivoxyWindowOpen()"</span> in raw source code?</a>
 580         </h3>
 581         <p>
 582           <span class="APPLICATION">Privoxy</span> is attempting to disable
 583           malicious <a href="http://en.wikipedia.org/wiki/Javascript" target=
 584           "_top">Javascript</a> in this case, with the <tt class=
 585           "LITERAL">unsolicited-popups</tt> filter. <span class=
 586           "APPLICATION">Privoxy</span> cannot tell very well <span class=
 587           "QUOTE">"good"</span> code snippets from <span class=
 588           "QUOTE">"bad"</span> code snippets.
 589         </p>
 590         <p>
 591           If you see this in HTML source, and the page displays without
 592           problems, then this is good, and likely some pop-up window was
 593           disabled. If you see this where it is causing a problem, such as a
 594           downloaded program source code file, then you should set an
 595           exception for this site or page such that the integrity of the page
 596           stays in tact by disabling all filtering.
 597         </p>
 598       </div>
 599       <div class="SECT2">
 600         <h3 class="SECT2">
 601           <a name="DNSERRORS">5.17. I am getting too many DNS errors like
 602           <span class="QUOTE">"404 No Such Domain"</span>. Why can't Privoxy
 603           do this better?</a>
 604         </h3>
 605         <p>
 606           There are potentially several factors here. First of all, the DNS
 607           resolution is done by the underlying operating system -- not <span
 608           class="APPLICATION">Privoxy</span> itself. <span class=
 609           "APPLICATION">Privoxy</span> merely initiates the process and hands
 610           it off, and then later reports whatever the outcome was and tries
 611           to give a coherent message if there seems to be a problem. In some
 612           cases, this might otherwise be mitigated by the browser itself
 613           which might try some work-arounds and alternate approaches (e.g
 614           adding <span class="QUOTE">"www."</span> to the URL).
 615         </p>
 616         <p>
 617           In other cases, if <span class="APPLICATION">Privoxy</span> is
 618           being chained with another proxy, this could complicate the issue,
 619           and cause undue delays and timeouts. In the case of a <span class=
 620           "QUOTE">"socks4a"</span> proxy, the socks server handles all the
 621           DNS. <span class="APPLICATION">Privoxy</span> would just be the
 622           <span class="QUOTE">"messenger"</span> which is reporting whatever
 623           problem occurred downstream, and not the root cause of the error.
 624         </p>
 625         <p>
 626           In any case, versions newer than 3.0.3 include various improvements
 627           to help <span class="APPLICATION">Privoxy</span> better handle
 628           these cases.
 629         </p>
 630       </div>
 631       <div class="SECT2">
 632         <h3 class="SECT2">
 633           <a name="ALLCPU">5.18. At one site Privoxy just hangs, and starts
 634           taking all CPU. Why is this?</a>
 635         </h3>
 636         <p>
 637           This is probably a manifestation of the <span class="QUOTE">"100%
 638           cpu"</span> problem that occurs on pages containing many (thousands
 639           upon thousands) of blank lines. The blank lines are in the raw HTML
 640           source of the page, and the browser just ignores them. But the
 641           pattern matching in <span class="APPLICATION">Privoxy's</span> page
 642           filtering mechanism is trying to match against absurdly long
 643           strings and this becomes very CPU-intensive, taking a long, long
 644           time to complete.
 645         </p>
 646         <p>
 647           Until a better solution comes along, disable filtering on these
 648           pages, particularly the <tt class="LITERAL">js-annoyances</tt> and
 649           <tt class="LITERAL">unsolicited-popups</tt> filters. If you run
 650           into this problem with a recent <span class=
 651           "APPLICATION">Privoxy</span> version, please send a problem report.
 652         </p>
 653       </div>
 654       <div class="SECT2">
 655         <h3 class="SECT2">
 656           <a name="SLOWCRAWL">5.19. I just installed Privoxy, and all my
 657           browsing has slowed to a crawl. What gives?</a>
 658         </h3>
 659         <p>
 660           This should not happen, and for the overwhelming number of users
 661           world-wide, it does not happen. I would suspect some inadvertent
 662           interaction of software components such as anti-virus software,
 663           spyware protectors, personal firewalls or similar components. Try
 664           disabling (or uninstalling) these one at a time and see if that
 665           helps. Either way, if you are using a recent <span class=
 666           "APPLICATION">Privoxy</span> version, please report the problem.
 667         </p>
 668       </div>
 669       <div class="SECT2">
 670         <h3 class="SECT2">
 671           <a name="PREVENTCOMP">5.20. Why do my filters work on some sites
 672           but not on others?</a>
 673         </h3>
 674         <p>
 675           It's probably due to compression. It is a common practice for web
 676           servers to send their content <span class=
 677           "QUOTE">"compressed"</span> in order to speed things up, and then
 678           let the browser <span class="QUOTE">"uncompress"</span> them. When
 679           compiled with zlib support <span class="APPLICATION">Privoxy</span>
 680           can decompress content before filtering, otherwise you may want to
 681           enable <a href=
 682           "../user-manual/actions-file.html#PREVENT-COMPRESSION" target=
 683           "_top">prevent-compression</a>.
 684         </p>
 685         <p>
 686           As of <span class="APPLICATION">Privoxy</span> 3.0.9, zlib support
 687           is enabled in the default builds.
 688         </p>
 689       </div>
 690       <div class="SECT2">
 691         <h3 class="SECT2">
 692           <a name="SSL-WARNINGS">5.21. On some HTTPS sites my browser warns
 693           me about unauthenticated content, the URL bar doesn't get
 694           highlighted and the lock symbol appears to be broken. What's going
 695           on?</a>
 696         </h3>
 697         <p>
 698           Probably the browser is requesting ads through HTTPS and <span
 699           class="APPLICATION">Privoxy</span> is blocking the requests.
 700           Privoxy's error messages are delivered unencrypted and while it's
 701           obvious for the browser that the HTTPS request is already blocked
 702           by the proxy, some warn about unauthenticated content anyway.
 703         </p>
 704         <p>
 705           To work around the problem you can redirect those requests to an
 706           invalid local address instead of blocking them. While the redirects
 707           aren't encrypted either, many browsers don't care. They simply
 708           follow the redirect, fail to reach a server and display an error
 709           message instead of the ad.
 710         </p>
 711         <p>
 712           To do that, enable logging to figure out which requests get blocked
 713           by <span class="APPLICATION">Privoxy</span> and add the hosts (no
 714           path patterns) to a section like this:
 715         </p>
 716         <table border="0" bgcolor="#E0E0E0" width="100%">
 717           <tr>
 718             <td>
 719 <pre class="SCREEN">
 720 {+redirect{http://127.0.0.1:0/} -block -limit-connect}
 721 .ivwbox.de:443/
 722 </pre>
 723             </td>
 724           </tr>
 725         </table>
 726
 727         <p>
 728           Additionally you have to configure your browser to contact <span
 729           class="QUOTE">"127.0.0.1:0"</span> directly (instead of through
 730           <span class="APPLICATION">Privoxy</span>).
 731         </p>
 732         <p>
 733           To add a proxy exception in <span class="APPLICATION">Mozilla
 734           Firefox</span> open the <span class="QUOTE">"Preferences"</span>,
 735           click the <span class="QUOTE">"Settings"</span> button located on
 736           the <span class="QUOTE">"Network"</span> tab in the <span class=
 737           "QUOTE">"Advanced"</span> section, and add <span class=
 738           "QUOTE">"127.0.0.1:0"</span> in the <span class="QUOTE">"No Proxy
 739           for:"</span> field.
 740         </p>
 741       </div>
 742       <div class="SECT2">
 743         <h3 class="SECT2">
 744           <a name="SE-LINUX">5.22. I get selinux error messages. How can I
 745           fix this?</a>
 746         </h3>
 747         <p>
 748           Please report the problem to the creator of your selinux policies.
 749         </p>
 750         <p>
 751           The problem is that some selinux policy writers aren't familiar
 752           with the application they are trying to <span class=
 753           "QUOTE">"secure"</span> and thus create policies that make no
 754           sense.
 755         </p>
 756         <p>
 757           In <span class="APPLICATION">Privoxy's</span> case the problem
 758           usually is that the policy only allows outgoing connections for
 759           certain destination ports (e.g. 80 and 443). While this may cover
 760           the standard ports, websites occasionally use other ports as well.
 761           This isn't a security problem and therefore <span class=
 762           "APPLICATION">Privoxy's</span> default configuration doesn't block
 763           these requests.
 764         </p>
 765         <p>
 766           If you really want to block these ports (and don't be able to load
 767           websites that don't use standard ports), you should configure
 768           Privoxy to block these ports as well, so it doesn't trigger the
 769           selinux warnings.
 770         </p>
 771       </div>
 772       <div class="SECT2">
 773         <h3 class="SECT2">
 774           <a name="GENTOO-RICERS">5.23. I compiled <span class=
 775           "APPLICATION">Privoxy</span> with Gentoo's portage and it appears
 776           to be very slow. Why?</a>
 777         </h3>
 778         <p>
 779           Probably you unintentionally compiled <span class=
 780           "APPLICATION">Privoxy</span> without threading support in which
 781           case requests have to be serialized and only one can be served at
 782           the same time.
 783         </p>
 784         <p>
 785           Check your <span class="QUOTE">"USE"</span> flags and make sure
 786           they include <span class="QUOTE">"threads"</span>. If they don't,
 787           add the flag and rebuild <span class="APPLICATION">Privoxy</span>.
 788         </p>
 789         <p>
 790           If you compiled <span class="APPLICATION">Privoxy</span> with
 791           threading support (on POSIX-based systems), the <span class=
 792           "QUOTE">"Conditional #defines"</span> section on <a href=
 793           "http://config.privoxy.org/show-status" target=
 794           "_top">http://config.privoxy.org/show-status</a> will list <span
 795           class="QUOTE">"FEATURE_PTHREAD"</span> as <span class=
 796           "QUOTE">"enabled"</span>.
 797         </p>
 798       </div>
 799     </div>
 800     <div class="NAVFOOTER">
 801       <hr width="100%" class="c1">
 802       <table summary="Footer navigation table" width="100%" border="0"
 803       cellpadding="0" cellspacing="0">
 804         <tr>
 805           <td width="33%" align="left" valign="top">
 806             <a href="misc.html" accesskey="P">Prev</a>
 807           </td>
 808           <td width="34%" align="center" valign="top">
 809             <a href="index.html" accesskey="H">Home</a>
 810           </td>
 811           <td width="33%" align="right" valign="top">
 812             <a href="contact.html" accesskey="N">Next</a>
 813           </td>
 814         </tr>
 815         <tr>
 816           <td width="33%" align="left" valign="top">
 817             Miscellaneous
 818           </td>
 819           <td width="34%" align="center" valign="top">
 820             &nbsp;
 821           </td>
 822           <td width="33%" align="right" valign="top">
 823             Contacting the developers, Bug Reporting and Feature Requests
 824           </td>
 825         </tr>
 826       </table>
 827     </div>
 828   </body>
 829 </html>
 830