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